wiki:sysadmin:yourls_url_shortener_tutorial

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
wiki:sysadmin:yourls_url_shortener_tutorial [2023/04/28 13:45] – ↷ Page moved from wiki:yourls_url_shortener_tutorial to wiki:sysadmin:yourls_url_shortener_tutorial Gregwiki:sysadmin:yourls_url_shortener_tutorial [2025/01/07 12:38] (current) – ↷ Links adapted because of a move operation Greg
Line 61: Line 61:
 If all went well, then Apache is installed and running with a default configuration. Simply open up a web browser, and enter %%"http://"%% plus your server's IP address, like ''%%http://192.168.1.50%%'', and you should be met with a page that looks something like this: If all went well, then Apache is installed and running with a default configuration. Simply open up a web browser, and enter %%"http://"%% plus your server's IP address, like ''%%http://192.168.1.50%%'', and you should be met with a page that looks something like this:
  
-{{ :wiki:debian-apache-test-page.png?direct&400 |}}+{{ wiki:debian-apache-test-page.png?direct&400 |}}
  
 But of course, this isn't YOURLS, and the page we did get is kinda useless! Now we need to configure Apache to use/display your YOURLS site. Open up the Apache default site config: But of course, this isn't YOURLS, and the page we did get is kinda useless! Now we need to configure Apache to use/display your YOURLS site. Open up the Apache default site config:
Line 81: Line 81:
 And if you refresh your web browser, it should now be showing something else... And if you refresh your web browser, it should now be showing something else...
  
-{{ :wiki:yourls-php-error.png?direct&600 |}}+{{ wiki:yourls-php-error.png?direct&600 |}}
  
 It's just a bunch of code! That's not right... Well, by default Apache has no idea what to do with PHP code, so it's just serving the PHP files as a static plain text file. It's just a bunch of code! That's not right... Well, by default Apache has no idea what to do with PHP code, so it's just serving the PHP files as a static plain text file.
Line 107: Line 107:
 Now open up your web browser again and go to the same address as before and prepend "/admin", e.g. ''%%http://192.168.1.50/admin/%%'' and you should be greeted with a YOURLS error page. Now open up your web browser again and go to the same address as before and prepend "/admin", e.g. ''%%http://192.168.1.50/admin/%%'' and you should be greeted with a YOURLS error page.
  
-{{ :wiki:yourls-db-error.png?direct&600 |}}+{{ wiki:yourls-db-error.png?direct&600 |}}
  
 This is normal. YOURLS requires a database to run, and we haven't configured the database yet (remember I said that we'd get to this later?), so let's get to it! This is normal. YOURLS requires a database to run, and we haven't configured the database yet (remember I said that we'd get to this later?), so let's get to it!
Line 160: Line 160:
 Now save and close the file, then refresh your browser. If all goes well, you should be at the YOURLS login page! Now save and close the file, then refresh your browser. If all goes well, you should be at the YOURLS login page!
  
-{{ :wiki:yourls-login.png?direct&600 |}}+{{ wiki:yourls-login.png?direct&600 |}}
  
 Enter your credentials, then you should be met with the YOURLS admin interface. Enter your credentials, then you should be met with the YOURLS admin interface.
  
-{{ :wiki:yourls-admin.png?direct&600 |}}+{{ wiki:yourls-admin.png?direct&600 |}}
  
 At this point, your YOURLS installation is complete, and you can start shortening URLS! At this point, your YOURLS installation is complete, and you can start shortening URLS!
Line 172: Line 172:
 Now that YOURLS is running, there is one last set of tweaks I'd recommend to make your YOURLS experience better. Head on over to the Plugins page via the "Manage Plugins" link at the top of the page. Then activate the ''%%Random ShortURLS%%'' and ''%%Allow Hyphens in Short URLS%%'' plugins - these two plugins do exactly what their names say: generate random URL slugs by default for the shortened URLS (these can be edited), and allow the hyphen character to be used in the URL slugs. Simple enough, and makes the experience slightly more streamlined and allows for more short URL possiblities. Now that YOURLS is running, there is one last set of tweaks I'd recommend to make your YOURLS experience better. Head on over to the Plugins page via the "Manage Plugins" link at the top of the page. Then activate the ''%%Random ShortURLS%%'' and ''%%Allow Hyphens in Short URLS%%'' plugins - these two plugins do exactly what their names say: generate random URL slugs by default for the shortened URLS (these can be edited), and allow the hyphen character to be used in the URL slugs. Simple enough, and makes the experience slightly more streamlined and allows for more short URL possiblities.
  
-{{ :wiki:yourls-plugins.png?direct&600 |}}+{{ wiki:yourls-plugins.png?direct&600 |}}
  
 You can also enable the ''%%Random Backgrounds%%'' plugin for a prettier interface. It's nothing huge, but I kinda like the admin interface a little bit more with the random backgrounds. This one is up to you if you want it. You can also enable the ''%%Random Backgrounds%%'' plugin for a prettier interface. It's nothing huge, but I kinda like the admin interface a little bit more with the random backgrounds. This one is up to you if you want it.
  • wiki/sysadmin/yourls_url_shortener_tutorial.1682703903.txt.gz
  • Last modified: 2023/04/28 13:45
  • by Greg