BlockApps logo

STRATO Developer Edition - Getting Started guide

Sign-up for trial

To use this guide you will need to have signed up for our Developer Edition Trial, if you have not already done so sign up here:



  • Install Docker on your machine
  • Install Docker Compose on your machine

  • For Mac users: Install wget using Homebrew (use the steps below):

    • Homebrew:

      ruby -e "$(curl -fsSL"

    • wget:

      brew install wget --with-libressl


The list of the ports required to be available on the machine


Steps to setup and run STRATO Developer Edition using Docker on your machine:

  1. Clone STRATO Getting Started repo using git clone or download and extract .zip archive. And chdir or cd into that folder.
  2. Configure docker registry login using the credentials [USER, PASSWORD, REGISTRY] you received via email after your registration for trial: docker login -u <USER> -p <PASSWORD> <REGISTRY>
  3. Launch STRATO services:

    • Run: chmod +x
    • Then run the script (runs latest STRATO version by default): ./

      Windows users should always provide the DOMAIN_NAME variable with the docker machine IP address (in most cases it is when running the STRATO: DOMAIN_NAME= ./

      or to run stable version: ./ --stable

  4. Check if STRATO services are running (using docker ps) & view the Strato Management Dashboard at http://localhost/

    Windows users should always use the domain name (docker machine IP) from the previous step instead of localhost

  5. Explore the Bloc and STRATO API docs via the top right link on the Dashboard (http://localhost) STRATO Management Dashboard

    • Default credentials for UI web pages: username: admin password: admin
    • API Docs can also be accessed at these endpoints directly: strato-api: http://localhost/strato-api/eth/v1.2/docs bloc api: http://localhost/bloc/v2.1/docs
  6. Refer documentation here to get started with developing a sample app:

  7. Reach out to BlockApps team for more info on support and enterprise licensed subscription:

Stopping STRATO

To stop a running instance of STRATO Developer Edition on your machine, run this command (from within the git cloned getting-started folder)

./ --stop

To stop and wipe out a running instance of STRATO Developer Edition on your machine, run this command (from within the git cloned getting-started folder)(you will lose state of any transactions/data created in the blockchain)

./ --wipe

Public STRATO instance

If you can't run your own STRATO instance on your machine, try our public instance (accessible to anyone with the credentials, so don't host Production or Production-like apps/content):

User (for Web and API Docs): admin

Password: W3b@dm!n

Ports used

STRATO services need the following ports to be available on the machine (refer docker-compose.yml for details):

:80 (for Nginx)
:2181 (for Zookeeper)
:3001 (for Postgrest)
:5432, :5434 (for Postgresql)
:6379 (for Redis)
:8080 (for API docs)
:9092 (for Kafka)
:10001 (for Bloc API service)
:30303, :30303 UDP, :33000 (for Strato)

Debug view

First do:

sudo apt-get install -y tmux tmuxinator

then you can get an overview of all processes using:

tmuxinator start strato

For tmux usage refer to tmux guide.

Consider using the tmux mouse mode plugins for better experience.

License Agreement

See BlockApps’ Developer Edition Terms of Use

STRATO Architecture