Version 3.3 Documentation

Zato installation on Windows

  • A WSL2 installation is recommended because that will give you better integration with Visual Studio code, and it will also let you use the same provisioning scripts as in your Linux-based environments
  • Start an admin PowerShell session:
powershell -Command "Start-Process powershell -Verb runAs"
  • Update WSL2:
PS c:\Users\myuser>wsl --update
Checking for updates.
Updating Windows Subsystem for Linux to version: 2.x.yy.
...
  • Download Ubuntu 24.04 if you don't have it already
PS C:\Windows\system32> wsl --install --web-download -d Ubuntu-24.04
Downloading: Ubuntu 24.04 LTS
...
  • Tell WSL2 what the default Linux distribution should be:
PS C:\Windows\system32> wsl --set-default Ubuntu-24.04
  • Enter Ubuntu 24.04:
PS C:\Windows\system32> wsl
Provisioning the new WSL instance Ubuntu-24.04
...
  • Install Docker (inside WSL2):
sudo apt-get update && \
sudo apt-get upgrade -y && \
sudo apt-get install ca-certificates curl -y && \
sudo install -m 0755 -d /etc/apt/keyrings && \
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc && \
sudo chmod a+r /etc/apt/keyrings/docker.asc && \
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null && \
sudo apt-get update &&
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y &&
sudo usermod -aG docker $USER

cd ~ && git clone https://github.com/zatosource/zato-project-blueprint
  • Start a new container with your Zato server (change "MyPassword" to your own):
Zato_Password=MyPassword ~/zato-project-blueprint/myproject/impl/scripts/run-container.sh

  • That concludes the process - the best way to continue is to visit the tutorials now.

  • Download and install Docker Desktop for Windows

  • Start Docker Desktop, look up an image called zatosource/zato-3.3-quickstart and pull it to your system

  • Once the image is pulled, click "play" to start a new container and fill out the settings:
    • The container's name can be "zato"
    • Map port 17010 to 17010
    • Map port 8183 to 8183
    • Add a new environment variable called "Zato_Password". Provide any value and it will become the password to your environment.

  • That concludes the process - the best way to continue is to visit the tutorials now.

Schedule a meaningful demo

Book a demo with an expert who will help you build meaningful systems that match your ambitions

"For me, Zato Source is the only technology partner to help with operational improvements."

— John Adams
Program Manager of Channel Enablement at Keysight