Your Own URL Shortener - the 𝑑𝑒 𝑓𝑎𝑐𝑡𝑜 standard self hosted URL shortener in PHP 🔗
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
yourls-bot[bot] 5ee2c6372f
Update GeoIP DB (#3453)
1 week ago
.github Bump shivammathur/setup-php from 2.21.2 to 2.22.0 1 month ago
admin Update admin/index.php 2 months ago
css SVG icons (#2822) 2 years ago
images Fix SVG for IE 11 (#2864) 2 years ago
includes Update GeoIP DB (#3453) 1 week ago
js When adding URLs, new HTML rows should have unique HTML IDs. (#3431) 2 months ago
tests Typofixes 2 months ago
user No hyphen in random keywords (#3353) 6 months ago
.editorconfig Fix that fucking encoding problem (#2690) 2 years ago
.gitattributes Mark vendor files as generated 10 months ago
.gitignore Add nonce to the logout link (#3264) 8 months ago Release v1.9.1 (#3350) 6 months ago
LICENSE license meta tweaks 5 years ago Promote (#3291) 8 months ago
composer.json List required/suggested PHP extensions in composer.json (#3339) 7 months ago
composer.lock Bump dependencies and remove (#3309) 7 months ago
phpunit.xml.dist Revert 3090 & fix tests (#3188) 11 months ago
readme.html Promote (#3291) 8 months ago
sample-public-api.txt Fix end of line 10 years ago
sample-public-front-page.txt Typofixes 2 months ago
sample-remote-api-call.txt Smarter domain convention in examples and source 8 years ago
sample-robots.txt Move /pages into /user (#2648) 3 years ago
yourls-api.php Add jsonp parameter in API as a fallback to match documentation (#2567) 3 years ago
yourls-go.php Smarter keyword sanitization (#2682) 3 years ago
yourls-infos.php Explicitely exit after redirection where needed (#3257) 9 months ago
yourls-loader.php Fix that fucking encoding problem (#2690) 2 years ago


Your Own URL Shortener

CI Scrutinizer Code Quality PHP Version Support Packagist OpenCollective OpenCollective

YOURLS is a set of PHP scripts that will allow you to run Your Own URL Shortener, on your server. You'll have full control over your data, detailed stats, analytics, plugins, and more. It's free and open-source.

Quick Start


  • Download the latest release
  • Using Composer? You can simply composer create-project yourls/yourls . in an empty directory.

Install YOURLS:

  • Read for starters
  • The complete documentation is on and contains everything from beginners to experts.

Community news, tips and tricks


Feature suggestion? Bug to report?

Before opening any issue, please search for existing issues (open and closed) and read the Contributing Guidelines.


Do you use and enjoy YOURLS? Become a backer and show your support to our open source project.


Does your company use YOURLS? Ask your manager or marketing team if your company would be interested in supporting our project. Your company logo will show here. Help support our open-source development efforts by becoming a sponsor.


Free software. Do whatever the hell you want with it.
YOURLS is released under the MIT license.