Run a Node with Docker

Stacks Blockchain with Docker

Run your own Stacks Blockchain node using with just few commands using

Quickstart

Requirements:

The minimum viable requirements are listed below.

While you can run a node using these specs, it's recommended to assign more than the minimum for better performance.

⚠️ version 2.2.2 or greater is required
4GB memory if running only a Stacks node
10 GB memory if running Stacks + Bitcoin node
1 Vcpu ( minimum of 2 Vcpu is recommended )
350GB disk for Stacks node
1TB disk space for Bitcoin node

MacOS with an ARM (M-series chip) processor is NOT recommended

The way Docker for Mac on an Arm CPU is designed makes the I/O incredibly slow, and blockchains are very heavy on I/O. This only seems to affect MacOS with the M-series chip, other Arm based systems like Raspberry Pi work as expected.

Quickstart

The <network> placeholder used below can be replaced with one of:

mainnet
testnet
mocknet

Clone the stacks-blockchain-docker repository locally

git clone https://github.com/stacks-network/stacks-blockchain-docker && cd stacks-blockchain-docker

Start the Services

./manage.sh -n <network> -a start

With an optional HTTP proxy on port 80:

./manage.sh -n <network> -a start -f proxy

Accessing the services

For networks other than mocknet, downloading the initial headers can take several minutes. Until the headers are downloaded, the /v2/info endpoints won't return any data.

Follow the logs to track the sync progress:

./manage.sh -n <network> -a logs

stacks-blockchain:

Ports 20443-20444 are exposed on localhost

curl -sL localhost:20443/v2/info | jq -r

stacks-blockchain-api:

Port 3999 is exposed on localhost

curl -sL localhost:3999 | jq -r

proxy:

Port 80 is exposed on localhost

curl -sL localhost/v2/info | jq -r
curl -sL localhost | jq -r

Upgrades

PreviousRun a Node NextRun a Node with Digital Ocean

Last updated 3 months ago

Was this helpful?