Installation under Docker

Requirements

  • Vagrant >= 2.2

Installation steps

Quickstart

  • Get Zato Vagrantfile.
user@host$ mkdir -p ~/zato-vagrant && cd ~/zato-vagrant
user@host$ curl \
    https://raw.githubusercontent.com/zatosource/zato-build/master/vagrant/zato-3.0/download.sh | \
    bash
  • Deploy Zato in Vagrant.
user@host$ vagrant up
  • Access the Virtual Machine using ssh.
user@host$ vagrant ssh
vagrant@zato:$ sudo su - zato
zato@zato:~$
  • Specify password for Zato web-admin.
user@host$ ZATO_WEB_ADMIN_PASSWORD="webadminpassword" vagrant up
user@host$ ZATO_IDE_PUBLISHER_PASSWORD="publisherpassword" vagrant up
  • Retrieve your dynamically generated password for Zato web-admin.
user@host$ vagrant ssh -c 'cat /opt/zato/web_admin_password'

That concludes the process - a web-admin instance is running on http://localhost:8183 and you can log into it with the username ‘admin’ using the password printed on the terminal above.

Environment Variables Available

The Zato’s Vagrant support uses several environment variables which can be used to fine-tune the resulting installation.

They are not required to use, and default values will be substituted if any is missing, but they may be employed to configure particular details of each of the components.

Variable Notes
ZATO_WEB_ADMIN_PASSWORD Password for the web admin’s technical account user to connect with. If not defined, the value is generated automatically at runtime.
ZATO_IDE_PUBLISHER_PASSWORD Password for the account user used for IDE integration. If not defined, it has to be set using the Zato’s web interface.