Skip to content

lylebrown/YOURLS-Cherokee

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

What your Cherokee Web Server config for YOURLS, a self-hosted URL shortener, may look like - heavily based off of a guide by Jeff on UtuTech (Link through Wayback Machine)

Configure YOURLS

Edit the user/config.php file, as detailed on the YOURLS site.

One suggestion is to add 'admin' to the list of reserved URL keywords, to prevent potential issues with URL rewrite rules. Otherwise, the configuration is standard.

Cherokee Configuration through cherokee-admin

Note: These rules assume your YOURLS site is at the document root. If it is located in a subdirectory, you may need to make a few changes.

  1. Select or configure the Virtual Server you intend to use YOURLS on.
  2. Add your PHP handler to the Virtual Server if you have not already done so.
  3. Open the behavior rules management.
  4. Add a new behavior with a type of "Regular Expression". The RegEx we're going to match is ^\/admin(*SKIP)(*FAIL)|^\/([0-9a-z] )(\ )?(all)?\/?$. (Kudos to @eionrobb for assisting with this.)
  5. Select the Handler tab for the Regular Expression just created, and add the following RegEx/Substitution records:
Type Regular Expression Substitution
Internal ^/([0-9a-z] )/?$ /yourls-go.php?id=$1
Internal ^/([0-9a-z] )\ /?$ /yourls-infos.php?id=$1
Internal ^/([0-9a-z] )\ all/?$ /yourls-infos.php?id=$1&all=1
  1. Leave the default "List and Send" handler at the bottom.
  2. Save and restart Cherokee.

Cherokee Configuration through cherokee.conf

While Cherokee documentation does not recommend directly editing the configuration file, you can also do so by adding the following entries.

Note: You will most likely need to change the rule number to be 100 higher than your existing rules for the vServer. This only includes the rewrite rule.

vserver!6!rule!600!handler = redir
vserver!6!rule!600!handler!rewrite!10!regex = ^/([0-9a-z] )/?$
vserver!6!rule!600!handler!rewrite!10!show = 0
vserver!6!rule!600!handler!rewrite!10!substring = /yourls-go.php?id=$1
vserver!6!rule!600!handler!rewrite!20!regex = ^/([0-9a-z] )\ /?$
vserver!6!rule!600!handler!rewrite!20!show = 0
vserver!6!rule!600!handler!rewrite!20!substring = /yourls-infos.php?id=$1
vserver!6!rule!600!handler!rewrite!30!regex = ^/([0-9a-z] )\ all/?$
vserver!6!rule!600!handler!rewrite!30!show = 0
vserver!6!rule!600!handler!rewrite!30!substring = /yourls-infos.php?id=$1&all=1
vserver!6!rule!600!match = request
vserver!6!rule!600!match!request = ^\/admin(*SKIP)(*FAIL)|^\/([0-9a-z] )(\ )?(all)?\/?$

About

YOURLS configuration for the Cherokee Web Server

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published