Upgrade Your Node Running via Docker¶
Introduction¶
Keeping your node up-to-date is an important part of being a Tanssi validator. Not only does it help ensure that your node stays healthy, but it also contributes to keeping the entire Tanssi Network running smoothly.
This tutorial covers upgrading your Tanssi validator node that was configured using Docker. It assumes you have already set up your account and launched a validator node using Systemd.
Subscribe to Release Notifications
Staying informed about new client releases is essential for maintaining an up-to-date node. Node maintainers can subscribe to GitHub notifications to be alerted for new client release versions.
To subscribe, visit the Tanssi GitHub repository and click Watch. Select Custom notifications and ensure the box for Releases is checked.
Upgrade Docker Nodes¶
Upgrading your node is as simple as stopping the running container and restarting it with the new version tag.
First, get the container ID of your Tanssi validator node with the following command:
docker ps -a
The container ID is the first column and if you're running multiple Docker containers, you can identify it by the image name of moondancelabs/starlight. You can run the stop command as follows:
docker stop INSERT_YOUR_CONTAINER_ID
Your terminal interaction will resemble the following:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
aa751703d6aa moondancelabs/dancelight-chain:2 "/chain-network/tans…" 56 seconds ago Up 56 seconds determined_darwin
docker stop aa751703d6aa
aa751703d6aa
To restart the node, you can use the same command you used when launching your node the first time. The command pulls the image and the node will resume syncing blocks from where it left off when the Docker process was stopped.
docker run --network="host" -v "/var/lib/tanssi-data:/data" \
-u $(id -u ${USER}):$(id -g ${USER}) \
moondancelabs/starlight \
--chain=dancelight \
--base-path=/data/ \
--node-key-file /data/node-key \
--database=paritydb \
--rpc-port=9944 \
--prometheus-port=9615 \
--prometheus-external \
--name=INSERT_YOUR_TANSSI_NODE_NAME \
--listen-addr=/ip4/0.0.0.0/tcp/30333 \
--public-addr=/ip4/YOUR_IP_ADDRESS/tcp/30333 \
--state-pruning=archive \
--blocks-pruning=archive \
--rpc-cors=all \
--rpc-methods=safe \
--unsafe-rpc-external \
--rpc-max-connections=100 \
--telemetry-url='wss://telemetry.polkadot.io/submit/ 0' \
--validator
docker run --network="host" -v "/var/lib/tanssi-data:/data" \
-u $(id -u ${USER}):$(id -g ${USER}) \
--entrypoint "/tanssi-relay/tanssi-relay-skylake" \
moondancelabs/starlight \
--chain=dancelight \
--base-path=/data/ \
--node-key-file /data/node-key \
--database=paritydb \
--rpc-port=9944 \
--prometheus-port=9615 \
--prometheus-external \
--name=INSERT_YOUR_TANSSI_NODE_NAME \
--listen-addr=/ip4/0.0.0.0/tcp/30333 \
--public-addr=/ip4/YOUR_IP_ADDRESS/tcp/30333 \
--state-pruning=archive \
--blocks-pruning=archive \
--rpc-cors=all \
--rpc-methods=safe \
--unsafe-rpc-external \
--rpc-max-connections=100 \
--telemetry-url='wss://telemetry.polkadot.io/submit/ 0' \
--validator
docker run --network="host" -v "/var/lib/tanssi-data:/data" \
-u $(id -u ${USER}):$(id -g ${USER}) \
--entrypoint "/tanssi-relay/tanssi-relay-znver3" \
moondancelabs/starlight \
--chain=dancelight \
--base-path=/data/ \
--node-key-file /data/node-key \
--database=paritydb \
--rpc-port=9944 \
--prometheus-port=9615 \
--prometheus-external \
--name=INSERT_YOUR_TANSSI_NODE_NAME \
--listen-addr=/ip4/0.0.0.0/tcp/30333 \
--public-addr=/ip4/YOUR_IP_ADDRESS/tcp/30333 \
--state-pruning=archive \
--blocks-pruning=archive \
--rpc-cors=all \
--rpc-methods=safe \
--unsafe-rpc-external \
--rpc-max-connections=100 \
--telemetry-url='wss://telemetry.polkadot.io/submit/ 0' \
--validator
Note
It is recommended that you run the optimized binary versions for either Intel's Skylake or AMD's Zen3 architectures for better performance.
Specify a Version Tag¶
To use a specific version tag, append it to the image name. For example, to fetch the version tagged latest (which is the default), append :latest to moondancelabs/starlight.
And that's it! You've successfully upgraded your Tanssi node.
| Created: April 2, 2025