There are several ways to install tsuru-admin:

Downloading binaries (Mac OS X and Linux)

We provide pre-built binaries for OS X and Linux, only for the amd64 architecture. You can download these binaries directly from the releases page:

Using homebrew (Mac OS X only)

If you use Mac OS X and homebrew, you may use a custom tap to install tsuru-admin. First you need to add the tap:

$ brew tap tsuru/homebrew-tsuru

Now you can install tsuru-admin:

$ brew install tsuru-admin

Whenever a new version of tsuru-admin is out, you can just run:

$ brew update
$ brew upgrade tsuru-admin

For more details on taps, check homebrew documentation.


tsuru-admin requires Go 1.4. Make sure you have the last version of Go installed in your system.

Using the PPA (Ubuntu only)

Ubuntu users can install tsuru clients using apt-get and the tsuru PPA. You’ll need to add the PPA repository locally and run an apt-get update:

$ sudo apt-add-repository ppa:tsuru/ppa
$ sudo apt-get update

Now you can install tsuru-admin clients:

$ sudo apt-get install tsuru-admin

Using AUR (ArchLinux only)

Archlinux users can build and install tsuru admin from AUR repository, Is needed to have installed yaourt program.

You can run:

$ yaourt -S tsuru

Build from source (Linux and Mac OS X)


If you’re feeling adventurous, you can try it on other systems, like FreeBSD, OpenBSD or even Windows. Please let us know about your progress!

tsuru admin source is written in Go, so before installing tsuru from source, please make sure you have installed and configured Go.

With Go installed and configured, you will need to install godep and then download and compile tsuru-admin source. You can do that with the following commands: