tsuru-admin usage

tsuru-admin command supports administrative operations on a tsuru server. It can be compiled with:

$ go get github.com/tsuru/tsuru-client/tsuru-admin

To use tsuru-admin commands you should be an admin user. To be an admin user you should be in an admin team.

Setting a target

The target for the tsuru-admin command should point to the listen address configured in your tsuru.conf file.

listen: ":8080"
$ tsuru-admin target-add default tsuru.myhost.com:8080
$ tsuru-admin target-set default


All the “container*”” commands below only exist when using the docker provisioner.


$ tsuru-admin container-move <container id> <to host>

This command allow you to specify a container id and a destination host, this will create a new container on the destination host and remove the container from its previous host.


$ tsuru-admin containers-move <from host> <to host>

It allows you to move all containers from one host to another. This is useful when doing maintenance on hosts. <from host> and <to host> must be host names of existing docker nodes.

This command will go through the following steps:

  • Enumerate all units at the origin host;
  • For each unit, create a new unit at the destination host;
  • Erase each unit from the origin host.


$ tsuru-admin containers-rebalance [--dry]

Instead of specifying hosts as in the containers-move command, this command will automatically choose to which host each unit should be moved, trying to distribute the units as evenly as possible.

The –dry flag runs the balancing algorithm without doing any real modification. It will only print which units would be moved and where they would be created.

All the “platform*”” commands below only exist when using the docker provisioner.


$ tsuru-admin docker-node-add [param_name=param_value]... [--register]

This command add a node to your docker cluster. By default, this command will call the configured IaaS to create a new machine. Every param will be sent to the IaaS implementation.

You should configure in tsuru.conf the protocol and port for IaaS be able to access your node (you can see it here).

If you want to just register an docker node, you should use the –register flag with an address=http://your-docker-node:docker-port

The command always check if your node address is accessible.


$ tsuru-admin docker-node-list

This command list all nodes present in the cluster. It will also show you metadata associated to each node and the IaaS ID if the node was added using tsuru builtin IaaS providers.


$ tsuru-admin docker-node-remove <address> [--destroy]

This command removes a node from the cluster. Optionally it also destroys the created IaaS machine if the --destroy flag is passed.


$ tsuru-admin platform-add <name> [--dockerfile]

This command allow you to add a new platform to your tsuru installation. It will automatically create and build a whole new platform on tsuru server and will allow your users to create apps based on that platform.

The –dockerfile flag is an URL to a dockerfile which will create your platform.


$ tsuru-admin platform-update <name> [-d/--dockerfile]

This command allow you to update a platform in your tsuru installation. It will automatically rebuild your platform and will flag apps to update platform on next deploy.

The –dockerfile flag is an URL to a dockerfile which will update your platform.


$ tsuru-admin machines-list

This command will list all machines created using docker-node-add and a IaaS provider.


$ tsuru-admin machines-list <machine id>

This command will destroy a IaaS machine based on its ID.


$ tsuru-admin ssh <container-id>

This command opens a SSH connection to the container, using the API server as a proxy. The user may specify part of the ID of the container. For example:

$ tsuru app-info -a myapp
Application: tsuru-dashboard
Repository: git@
Platform: python
Teams: admin
Address: tsuru-dashboard.
Owner: admin@example.com
Deploys: 1
| Unit                                                             | State   |
| 39f82550514af3bbbec1fd204eba000546217a2fe6049e80eb28899db0419b2f | started |
$ tsuru-admin ssh 39f8
Welcome to Ubuntu 14.04 LTS (GNU/Linux 3.13.0-24-generic x86_64)