Docker is a tool that simplifies the process of creating, deploying, and running applications using containers. With containers, developers can bundle all the necessary parts of an application, including libraries and dependencies, and deploy them as a single package.
In this document, we will guide you on how to run Pactus using Docker, step by step.
Before running Pactus with Docker, ensure that you have a clear understanding of
how pactus-daemon and pactus-wallet works.
Then you need to install docker in your system.
If you are using Windows please make sure you have installed WSL.
The Pactus docker images are available at Docker Hub. You can pull the latest image with this command:
docker pull pactus/pactus
Now you need to create a wallet and setup a working directory for your node. A working directory is a place where you save blockchain data and wallets. Open the Terminal and run the following command:
docker run -it --rm -v ~/pactus:/root/pactus pactus/pactus pactus-daemon init
This command creates your wallet and setup the working working directory at ~/pactus.
docker run -it --rm -v %USERPROFILE%\pactus:/root/pactus pactus/pactus pactus-daemon init
This command creates your wallet and setup the working working directory at C:\Users\<USER_NAME>\pactus.
Here’s an explanation of the Docker flags:
-it: Makes the Docker container interactive for command-line interaction.--rm: Cleans up the temporary environment automatically when you’re done.-v <local_dir>:<container_dir>: Allows to choose where to store the Pactus data.Now you can start the node and sync with the network. Run the following command in the Terminal:
docker run -it -d -v ~/pactus:/root/pactus -p 21888:21888 -p 21888:21888/udp -p 50051:50051 -p 8080:8080 --name pactus pactus/pactus pactus-daemon start --password <WALLET_PASSWORD>
docker run -it -d -v %USERPROFILE%\pactus:/root/pactus -p 21888:21888 -p 21888:21888/udp -p 50051:50051 -p 8080:8080 --name pactus pactus/pactus pactus-daemon start --password {WALLET_PASSWORD}
This command creates and runs a Docker container named “pactus”. Here’s an explanation of the Docker flags:
-p <host_port>:<container_port>: Maps a port from your host machine to a port in the Docker container.-d: Starts the container in detached mode. The container runs in the background.--name <NAME>: Allows you to assign a custom name to a container.The default network ports in Pactus are defined as follows. It is recommended not to change these default ports:
You can manage the Pactus Docker container with these essential commands:
Stop the container:
docker stop pactus
This command gracefully stops the “pactus” container.
Start the container:
docker start pactus
This command starts the Pactus Docker container.
View Container Logs:
To check the logs:
docker logs pactus --tail 1000 -f
Here’s an explanation of the Docker flags:
--tail 1000: Displays the last 1000 lines of logs.-f: Shows the log output in real-time.Remove Docker container:
If you want to upgrade the node, you should first remove the current container:
docker rm pactus
After removing the Pactus Docker container, you can create and run a new version, as explained above.
By default, Docker only supports IPv4. IPv6 is only supported on Linux systems. Enabling IPv6 can help you improve connectivity and security. To enable IPv6 for Docker, follow the official documentation here.
You can use Pactus Docker to manage the wallet. For example, you can check the balance of your wallet as shown below:
docker run -it --rm -v ~/pactus:/root/pactus pactus/pactus pactus-wallet address all --balance --stake
docker run -it --rm -v %USERPROFILE%\pactus:/root/pactus pactus-wallet address all --balance --stake
You can check How to use wallet in Command Line Mode? for additional commands to manage your wallet.
By running a Pactus node, you contribute to the decentralization and security of the Pactus blockchain network. Thank you for your participation!