Awesome Open Source
Awesome Open Source


Build Status Go Report Card

What is tsuru?

tsuru is an extensible and open source Platform as a Service (PaaS) that makes application deployments faster and easier. With tsuru, you dont need to think about servers at all. As an application developer, you can:

  • Write apps in the programming language of your choice
  • Back apps with add-on resources such as SQL and NoSQL databases, including memcached, Redis, and many others
  • Manage apps using the tsuru command-line tool


Quick Start

With the purpose of testing tsuru and/or for development, you can use the installer to have tsuru up and running. The installer is an experimental feature.

From Binary

Getting tsuru-client

Download the latest release for your platform at:

Example for release 1.1.1 and OS X:

$ curl -sSL | tar xz

Call tsuru installer

$ tsuru install create

From Source

Getting tsuru-client

You need to have Go properly installed on your machine.

$ git clone $GOPATH/src/
$ cd $GOPATH/src/
$ make install

Create an installer config

Create the tsuru installer config files with:

$ tsuru install config init

Replace the tsuru API image tag with the latest tag in install-compose.yml:

$ sed -i'' -e 's/api:v1/api:latest/g' install-compose.yml

Call tsuru installer

$ $GOPATH/bin/tsuru install create -c install-config.yml -e install-compose.yml


If everything's gone well you have the tsuru running in a VirtualBox VM. Call app-list to see tsuru working, this command needs to return one app called tsuru-dashboard.

$ tsuru app-list

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Go (198,127
Hacktoberfest (37,972
Docker (34,465
Kubernetes (11,889
Devops (4,007
Containers (3,233
Paas (284
Related Projects