Running an Ergo Node with Docker

Deploy and manage your Ergo Node easily using Docker or Docker Compose. This method is ideal for quick setup, reproducibility, and running nodes in isolated environments.

Back to Setup Ergo Docker Image

Why Docker?

Docker allows you to run the Ergo node in a containerized environment, making deployment, updates, and management much easier. You can use the official Docker image or Docker Compose for more advanced orchestration.

Run a single Ergo node container using the Docker CLI. Suitable for quick experiments and simple deployments.

Command

sudo docker run --rm -p 9030:9030 -p 127.0.0.1:9053:9053 \
  -v /path/on/host/to/ergo/data:/home/ergo/.ergo \
  ergoplatform/ergo:latest

Data will be stored in /path/on/host/to/ergo/data on your host.

How Docker Node Setup Works

The official Docker image for Ergo Node provides a pre-configured environment for running the node. You can use the CLI or Compose, mount your own config, and control resources via environment variables.

For Beginners

Use the single-line Docker CLI command for a quick start on mainnet.

For Advanced Users

Use Docker Compose or custom images/tags for advanced orchestration, custom configs, and resource control.

Tips and Troubleshooting

Data Permissions

Ensure your data directory is owned by UID/GID 9052 or has 777 permissions for the container to write data.

Resource Limits

Use the MAX_HEAP environment variable to control node memory usage.

Logs & Monitoring

Follow logs with docker logs -f mn-ergo-node -n 200 or use Compose logging options.

Custom Config

Mount your own ergo.conf for advanced configuration. See example configs.