Welcome to tsuru!

tsuru is an open source PaaS, that aims to make it easier for developers to run their code in production.

Installing

Our documentation contains a guide for installing tsuru clients using package managers on Mac OS X, Ubuntu and ArchLinux, or build from source on any platform supported by Go: docs.tsuru.io/en/stable/using/install-client.html.

Please ensure that you install the tsuru client, and then continue this guide with the configuration, user and team creation and the optional SSH key handling.

Configuring

In order to use this tsuru server, you need to add it to your set of targets:

$ tsuru target-add default http://tsuru-api.tsuru-system.svc.cluster.local -s

tsuru supports multiple targets, the -s flag tells the client to add and set the given endpoint as the current target.

Create a user

After configuring the tsuru target that you wanna use, it's now needed to create a user:

$ tsuru user-create <your-email>

The command will ask for your password twice, and then register your user in the tsuru server.

After creating your user, you need to authenticate with tsuru, using the tsuru login command.

$ tsuru login

It will ask for your email and password, you can optionally provide your email as a parameter to the command.

Ensure you're member of at least one team

In order to create an application, a user must be member of at least one team. You can see the teams that you are a member of by running the team-list command:

$ tsuru team-list

If this command doesn't return any team for you, it means that you have to create a new team before creating your first application:

$ tsuru team-create <team-name>

Build and deploy your application

Now you're ready to deploy an application to this tsuru server, please refer to the tsuru documentation for more details: docs.tsuru.io/en/stable/using/python.html.