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 ⚠️ On Ubuntu, you may need to run Docker commands with sudo unless your user is in the docker group

---

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 1.5TB of free space to download and process the chainstate archives
Note: for faster downloads, install aria2 on your system

Example aria2c install on a debian/ubuntu based system:

# 1. Install build dependencies
sudo apt-get update
sudo apt-get install -y build-essential autoconf automake autotools-dev autopoint \
  libtool pkg-config gettext libssl-dev libc-ares-dev libxml2-dev \
  zlib1g-dev libsqlite3-dev libssh2-1-dev

# 2. Clone the source
git clone https://github.com/aria2/aria2
cd aria2

autopoint --force
autoreconf -fi

# 3. Configure without translations (avoids the po/ gettext build entirely)
./configure --disable-nls --with-openssl

# 4. Build and install
make -j$(nproc)
sudo make install

# 5. Verify
aria2c --version

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