Stacks Blockchain with Docker

Run your own Stacks Blockchain node easily with just few commands.

⚠️ docker compose version 2.2.2 or greater is required

---

Quickstart

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

Sync from genesis (no signer)

./manage.sh -n mainnet -a start

Sync from genesis (with signer)

./manage.sh -n mainnet -a start -f signer

Seed chainstate from Hiro Archiver

Using data from the Hiro Archiver service, this script will download the latest files, extract them and restore the postgres data.
Note: it can take a long time to process the data, and you'll need at a minimum roughly 350GB of free space

sudo ./scripts/seed-chainstate.sh
./manage.sh -n mainnet -a start

• Requirements
• Docker Setup
• Configuration
• Upgrading
• Usage
• Common Issues

---

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.
Use the command ./manage.sh -n <network> -a logs to check the sync progress.

stacks-blockchain:

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

stacks-blockchain-api:

curl -sL localhost:3999/v2/info | jq

proxy (optional argument):

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