Skip to content

Supporting Clean URLs

Daniel Pimley edited this page Apr 23, 2020 · 22 revisions

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 fully and 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 using the include directive:

include filesystem/path/to/chyrp/include.conf;

Caddy 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 web server. You must edit your Caddy configuration to import this file using the import directive:

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.

Clone this wiki locally