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.
The only thing you need is installing docker in your machine. 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/testnet:/pactus pactus/pactus init -w /pactus --testnet
This command creates your wallet and setup the working working directory at ~/pactus/testnet.
docker run -it --rm -v ~/pactus/testnet:/pactus pactus/pactus init -w /pactus --testnet
This command creates your wallet and setup the working working directory at ~/pactus/testnet.
docker run -it --rm -v c:\pactus\testnet:/pactus pactus/pactus init -w /pactus --testnet
This command creates your wallet and setup the working working directory at c:\pactus\testnet.
Make sure you write down your 12-word mnemonic on a piece of paper to recover your wallet in the future in case your computer is lost, damaged, or stolen.
The working directory contains:
Feel free to take a look at these files.
Now you can start the node and sync with the network. Run the following command in the Terminal:
docker run -it -v ~/pactus/testnet:/pactus -p 8080:8080 -p 21777:21777 --name pactus-testnet pactus/pactus start -w /pactus
docker run -it -v ~/pactus/testnet:/pactus -p 8080:8080 -p 21777:21777 --name pactus-testnet pactus/pactus start -w /pactus
docker run -it -v c:\pactus\testnet:/pactus -p 8080:8080 -p 21777:21777 --name pactus-testnet pactus/pactus start -w /pactus
To run pactus-testnet in background just add a -d flag in the command.
Hint: Remember to pass in your wallet passphrase as well with -p flag after /pactus.
docker run -it -v ~/pactus/testnet:/pactus -p 8080:8080 -p 21777:21777 -d --name pactus-testnet pactus/pactus start -w /pactus -p {YOUR_PASSPHRASE}
docker run -it -v c:\pactus\testnet:/pactus -p 8080:8080 -p 21777:21777 -d --name pactus-testnet pactus/pactus start -w /pactus -p {YOUR_PASSPHRASE}
You can stop/start docker:
docker stop pactus-testnet
docker start pactus-testnet
Or check the logs:
docker logs pactus-testnet --tail 1000 -f
By running a Pactus node, you contribute to the decentralization and security of the Pactus blockchain network. Thank you for your participation!