Installation: Debian and Ubuntu

This page describes how to install sup on recent versions of Ubuntu and Debian.

You might want to prepend commands with sudo where root access is needed.

Install required system packages

apt-get install build-essential libncursesw5-dev uuid-dev zlib1g-dev

Install Ruby, Rubygems, and Rake

• Install system Ruby: run apt-get install ruby-full rubygems rake.
• Or install Ruby via rvm or rbenv.

rake1.8 issue

If you're using system Ruby of 1.8, You have to do this before going for the next step:

ln -s /usr/bin/rake /usr/local/bin/rake1.8

Install sup via rubygems

gem install sup # sudo is not needed if not using system ruby
# On Debian 6.0 with ruby1.9.1-full
gem1.9.1 install sup

Rubygems PATH issue on old systems

On Debian 6.0 and lower (and other old Ubuntu systems), You'll have to manually add /var/lib/gems/1.9.1/bin to PATH environment variable. Or you'll get an command not found error when running sup.

Next step

See New User Guide.

On even older versions of Debian / Ubuntu

See this page if you're on a really old system and previous instructions still doesn't work.