Installing tsuru client

tsuru is the command line utility used by application developers, that will allow users to create, list, bind and manage apps. For more details, check tsuru usage.

This document describes how you can install tsuru CLI, using pre-compiled binaries, packages or building them from source.

Downloading binaries (Mac OS X, Linux and Windows)

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 of the project:

Using homebrew (Mac OS X only)

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

$ brew tap tsuru/homebrew-tsuru

Now you can install tsuru:

$ brew install tsuru

Whenever a new version of any of tsuru clients is out, you can just run:

$ brew update
$ brew upgrade tsuru

For more details on taps, check homebrew documentation.

NOTE: tsuru client require Go 1.4 or higher. Make sure you have the last version of Go installed in your system.

Using the (Linux)

Quick install


$ curl -s | sudo bash
$ sudo apt-get install tsuru-client


$ curl -s | sudo bash
$ sudo yum install tsuru-client

For more details, check documentation.

Build from source (Linux, Mac OS X and Windows)


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

tsuru’s 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 can use go get to install tsuru client:

$ go get