Armada currently runs only on Linux with Docker installed.
If you want to learn and play with Armada on your own machine (whether it's Windows, Mac or Linux)
you can do it using e.g. Vagrant box.
and vagrant-vbguest plugin. Then:
$ curl -sLO http://vagrant.armada.sh/Vagrantfile
$ vagrant up
$ vagrant ssh
If you don't have curl available, you can download it from
To run Armada natively on Linux, first
then run the installation script:
$ bash <(curl -sL http://armada.sh/install)
Armada runs within its own docker container, which you can see by running
docker ps | grep armada
To verify the installation try running armada --help
You should see Armada command line tool help page:
$ armada --help
usage: armada.py [-h] [--version]
name get/set name for this ship
join join another armada
promote promote ship to commander role
shutdown gently remove ship from armada and prepare for service
dockyard manage dockyard aliases
list show list of running microservices
info show list of ships within current armada
run run container with microservice
stop stop container with microservice
restart restart container with microservice
recover run containers from JSON file with saved containers'
ssh ssh into container with microservice
build build container with microservice
push push container with microservice to dockyard
create create skeleton for new microservice
version display armada version
diagnose run diagnostic check on a container
-h, --help show this help message and exit
--version show program's version number and exit
If everything looks good, we can get our feet wet
and go run some services!
If not, check /var/log/armada.log.
If the armada docker container did not run, the armada command will not work.