Run a Node with Docker
Last updated
Was this helpful?
Last updated
Was this helpful?
Run your own Stacks Blockchain node using with just few commands using
Quickstart
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
8GB memory if running only a Stacks node
16 GB memory if running Stacks + Bitcoin node
1 Vcpu ( minimum of 2 Vcpu is recommended )
500GB 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.
The <network>
placeholder used below can be replaced with one of:
mainnet
testnet
mocknet
Clone the stacks-blockchain-docker repository locally
Start the Services
stacks-blockchain:
Ports 20443-20444
are exposed on localhost
stacks-blockchain-api:
Port 3999
is exposed on localhost
proxy:
Port 80
is exposed on localhost
For schema-breaking upgrades to running instances of this repo, you'll need to .