Stacks

Instructions to set up your Stacks node.

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

Open manage.sh script

Terminal window
nano +6 manage.sh

Add the following function to support the newer docker compose syntax

Terminal window
docker-compose() {
    docker compose "$@"
}

Note: This ensures compatibility with newer Docker versions where docker compose replaces the legacy docker-compose.

Make the script executable

Terminal window
chmod +x manage.sh
Terminal window
./manage.sh -n mainnet -a start
Terminal window
./manage.sh -n testnet -a start
Terminal window
./manage.sh -n mainnet -a logs
Terminal window
./manage.sh -n testnet -a logs

After a few minutes, you should see lines that look like this. This means your node has started syncing with the network and is receiving blocks.

Terminal window
stacks-blockchain-api  | {"level":"info","time":"2025-07-13T12:39:13.914Z","pid":19,"hostname":"e15f871c6dad","name":"stacks-node-event","reqId":"req-7","req":{"method":"POST","url":"/new_burn_block","hostname":"stacks-blockchain-api:3700","remoteAddress":"172.21.0.4","remotePort":60142,"bodySize":184},"msg":"incoming request"}
stacks-blockchain      | INFO [1752410353.915124] [stackslib/src/net/relay.rs:2559] [relayer-http://0.0.0.0:20443] Got chunks for unconfigured StackerDB replica, stackerdb_contract_id: SP000000000000000000002Q6VF78.signers-1-2
stacks-blockchain      | INFO [1752410353.917114] [stackslib/src/net/relay.rs:2559] [relayer-http://0.0.0.0:20443] Got chunks for unconfigured StackerDB replica, stackerdb_contract_id: SP000000000000000000002Q6VF78.signers-1-2
stacks-blockchain      | INFO [1752410353.917128] [stackslib/src/net/relay.rs:2559] [relayer-http://0.0.0.0:20443] Got chunks for unconfigured StackerDB replica, stackerdb_contract_id: SP000000000000000000002Q6VF78.signers-1-1
stacks-blockchain      | INFO [1752410353.919038] [stackslib/src/net/relay.rs:2559] [relayer-http://0.0.0.0:20443] Got chunks for unconfigured StackerDB replica, stackerdb_contract_id: SP000000000000000000002Q6VF78.signers-1-2
stacks-blockchain-api  | {"level":"info","time":"2025-07-13T12:39:13.921Z","pid":19,"hostname":"e15f871c6dad","name":"stacks-node-event","reqId":"req-7","res":{"statusCode":200,"method":"POST","url":"/new_burn_block","requestBodySize":184,"responseBodySize":15},"responseTime":6.254112005233765,"msg":"request completed"}

Stacks Blockchain port:

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

Stacks Blockchain Api service port:

Terminal window
curl -sL localhost:3999 | jq -r

Once your node is up and running, you need to add the stacks chain to your ampd daemon’s config.tomlfile. This can be done by adding in the following configuration:

  TBA
  TBA

For your node to be recognized by the Axelar Network, you need to register your verifier’s support for the chain with the ampd daemon. This can be done by running:

Terminal window
ampd register-chain-support amplifier stacks

Edit on GitHub