STRATO Platform

Build and Run STRATO

1. Install Dependencies

git clone https://github.com/strato-net/strato-platform
cd strato-platform

Choose one of the following options to install dependencies:

• OPTION A (recommended): (Supported OS: Ubuntu 24.04, Amazon Linux 2023, macOS, Linux Mint) Run the install script which installs all dependencies automatically (Stack, Docker, libraries):

  ./install_deps.sh
  

• OPTION B: Install dependencies manually:
  • Stack (build time)
  • Docker with Compose plugin (build+runtime)
    • Docker should run as a non-root user. Add your user to the docker group:

      sudo groupadd docker ; sudo usermod -aG docker $USER && newgrp docker ; docker ps
      

      For more information, refer to the Docker post-installation steps.
  • Libraries:
    • Ubuntu 24.04:

      sudo apt install -y \
        libleveldb-dev \
        liblzma-dev \
        libpq-dev \
        libsecp256k1-dev \
        libsodium-dev \
        pkg-config \
        postgresql-client \
        zlib1g-dev
      

    • macOS — choose one:
      • Install libraries system-wide using Homebrew:

        brew install --quiet \
          leveldb \
          postgresql \
          libsodium \
          pkg-config \
          secp256k1 \
          xz
        

      • Use Nix: Install Nix and use the predefined packages in an isolated path (no need to install libraries system-wide)

2. Build

Important: Do not run the build or deploy commands under the root user or with the sudo prefix — this prevents permission issues.

make

For Nix-based builds, use NIX=true make instead.

3. Run

Login before the very first run:

strato-login

To get the credentials for your node server, submit a request for client credentials at https://support.blockapps.net

Start the node:

<OPTIONAL_ENV_VARS> strato-up mynode --network=helium --nodeHost=example.com --sslDir='/path/to/ssl'

• /path/to/ssl should contain server.pem and server.key directly (no subdirectories), with read permissions for all users (chmod 444 server.*).
• Do not include OAUTH variables in env vars. You can include app-related variables if needed (e.g., RPC URLs, etc.).
• Use --network=helium for testnet or --network=upquark for mainnet (default).

4. Stop and Wipe

Stop the node:

strato-down

Stop and wipe all data:

strato-down
rm -rf mynode/

5. Patch App on a Running Node (for development and testing)

Steps to rebuild and patch the app on a running STRATO node.

Rebuild the App Images

make app

This builds both app images and prints the command to deploy them (similar to make but only builds the app)

Patch the App on a Node

Stop and restart the node with the new images:

strato-down
strato-up mynode --patch-app mercata-backend:<tag> mercata-ui:<tag>

Use the exact image tags printed by make app.