akosma edited this page Aug 2, 2011 · 5 revisions
Clone this wiki locally


Cortito is the URL shortener used in http://akos.ma/ and http://myze.ro/. It is written in Ruby on Rails and it is available as an Open Source project. Check out the list of Shorteners using Cortito.


Follow these instructions to install it in your own server:

  1. git clone git://github.com/akosma/cortito.git
  2. cd cortito
  3. cp config/database.yml.sample config/database.yml
    • Edit the "production" section with the parameters of your own database
  4. cp config/config.yml.sample config/config.yml
    • Enter your company name and URL.
  5. rake db:migrate RAILS_ENV=”production”
  6. Optionally, you can modify the “public/termsofservice.html” and “public/privacy.html” files to follow your own company’s legal requirements.
  7. touch tmp/restart.txt (if you are using Phusion Passenger)


Cortito features a small, straightforward REST API: a POST request to the root of the application generates a new shortened URL from the one passed as parameter. The response is the shortened URL, including the base server URL (for example, “http://akos.ma/abc123”)


  • Supports custom and automatic hashes;
  • Simple REST API to be used from other programs;


This project is released with the BSD license. See the License page for details.


Cortito © 2009 - 2011 Adrian Kosmaczewski. All Rights Reserved.