Supporting Clean URLs

If you want to give your blog prettier URLs, you can enable "Clean URLs" on the Route Settings page of the administration console. Chyrp Lite transparently supports clean URLs on the Apache web server, and it also includes experimental support for clean URLs on the Nginx and Caddy web servers.

Enabling Clean URLs

Depending on your choice of web server software, you may need to take further action after you enable clean URLs in the administration console:

Apache Web Server

If you are using Apache with mod_rewrite and .htaccess support enabled, no further action is required. A configuration file named .htaccess will be created in your installation directory. This file contains the directives necessary to support clean URLs when Chyrp Lite is running on the Apache web server.

Nginx Web Server

A configuration snippet named include.conf will be created in your installation directory. This file contains the directives necessary to support clean URLs when Chyrp Lite is running on the Nginx web server. You must edit your Nginx configuration to include this file inside your server directive using the include directive:

server {
    #...
    include filesystem/path/to/chyrp/include.conf;
    #...
}

Caddy 2 Web Server

A configuration snippet named caddyfile will be created in your installation directory. This file contains the directives necessary to support clean URLs when Chyrp Lite is running on the Caddy 2 web server. You must edit your Caddy configuration to import this file using the import directive:

example.com {
    #...
    import filesystem/path/to/chyrp/caddyfile
    #...
}

Disabling Clean URLs

It is not necessary to delete the configuration snippets if you decide to disable clean URLs.