Welcome to the official EpicChain PrivateNet Docker setup—your all-in-one solution for launching a private blockchain network, tailor-made for developers, smart contract architects, educators, and blockchain enthusiasts who want to test and iterate without limits.
Say goodbye to tedious setup processes, unpredictable public testnet downtime, or having to wait for gas. This Docker container provides you a fully pre-configured, blazing-fast EpicChain network instance that boots up from block height 0 in seconds. Get immediate access to native EpicChain tokens, development tools, and a working wallet—all out of the box.
Whether you're building decentralized applications (dApps), testing smart contract logic, experimenting with consensus behavior, or onboarding your dev team, this is your sandbox with superpowers.
The EpicChain PrivateNet Docker image has been carefully assembled to give you a development-first, plug-and-play experience:
- ✅ Fully pre-configured EpicChain PrivateNet (single-node and multi-node setup ready)
- ✅ Instant access to:
- 1 Billion EpicChain (XPR)
- 16,600 EpicPulse (XPP)
- ✅ Embedded wallets with auto-generated WIF keys for easy import
- ✅ Full smart contract deployment support
- ✅ Rapid start in under 60 seconds
DockerHub Repository
🔗 epicchain/epicchain-privatenet
Everything is built with developers in mind—test, debug, and deploy without waiting or dealing with unpredictable blockchain traffic.
For users running Ubuntu via Windows Subsystem for Linux (WSL), you’ll first need Docker installed on your Linux environment.
- Visit Docker CE for Ubuntu
- Follow the installation steps carefully
- 🔁 Retype all commands manually if copying from the web—watch for issues with quotation marks (
“”vs"")
To spin up the network instantly using Docker, just run:
docker pull epicchain/epicchain-privatenet
docker run --rm -d --name epicchain-privatenet \
-p 10111-20111:10111-20111/tcp \
-p 60111-70111:60111-70111/tcp \
epicchain/epicchain-privatenetThis will launch a multi-port, multi-node EpicChain private blockchain—ready to accept transactions, mine blocks, and deploy smart contracts.
🧠 Tip: Use docker logs -f epicchain-privatenet to view real-time logs.
Prefer to build everything from scratch? No problem. Clone and build locally:
git clone https://github.com/epicchainlabs/epicchain-privatenet.git
cd epicchain-privatenet
./docker_build.shThe docker_build.sh script supports:
--no-cache→ Disable Docker cache for a clean rebuild--epicchain-cli <zip>→ Use a custom CLI version-h→ Display all options
Once built, start the node:
./docker_run.shWant to create wallets and claim dev tokens automatically? Run:
./docker_run_and_create_wallet.shPrefer docker-compose?
docker-compose up -d
./create_wallet.sh📌 NOTE: Ignore internal "error" logs as long as you receive a final success message at startup.
After the setup, wallet files will be created and stored in the container.
You’ll get:
epicchain-privnet.wallet→ For CLI and scriptingepicchain-privnet.wif→ For importing into GUI wallets or browser extensions
You can copy these files from Docker into your local environment like this:
docker cp epicchain-privnet:/opt/node1/epicchain-cli/wallet1.json .
docker cp epicchain-privnet:/opt/node2/epicchain-cli/wallet2.json .
docker cp epicchain-privnet:/opt/node3/epicchain-cli/wallet3.json .
docker cp epicchain-privnet:/opt/node4/epicchain-cli/wallet4.json .Each wallet is pre-loaded with tokens for your experimentation.
Here are the default passwords for each node wallet:
| Node | Password |
|---|---|
| node1 | one |
| node2 | two |
| node3 | three |
| node4 | four |
To tweak or extend the network, edit protocol.json:
"SeedList": [
"127.0.0.1:10111",
"127.0.0.1:20334",
"127.0.0.1:20335",
"127.0.0.1:20111"
]Make sure to:
- Set
"Magic"to56753for PrivateNet consistency - Add your validator public keys to
"StandbyValidators"if you’re simulating consensus
If you’re using Docker Machine, get the machine IP like so:
docker-machine ls
docker-machine ip "default"Replace all instances of 127.0.0.1 in your config files with this IP.
Your wallets will be automatically funded with:
- 1 Billion XPR
- 16,600 XPP
These dev tokens are claimable through the default startup script or manually via CLI commands. Visit the full EpicChain Labs documentation to learn how to write and deploy contracts using these tokens.
- 🧰 Smart Contract Samples (Coming Soon)
- 📖 Token Deployment Guide
- 📓 Integration with EpicChain Python SDK
- 🧪 Testing Suite for EpicChain contracts
- 🎥 Video Tutorials (YouTube playlist upcoming)
- ✅ dApp development
- ✅ Smart contract testing and debugging
- ✅ Education and classroom environments
- ✅ Workshops and hackathons
- ✅ Security audit simulations
- ✅ Validator experimentation
EpicChain Labs is at the forefront of decentralized technologies—bringing the QuantumGuardNexus, QuantumVaultAsset, and universal smart contracts to developers worldwide. Our private network tools are created to remove friction so you can build the future, faster.
Join our dev community and connect with other builders:
- 🌐 Official Website
- 🧑💻 GitHub
- 💬 Discord
Spin it up, plug in your imagination, and launch your decentralized future from the comfort of your own terminal. EpicChain PrivateNet gives you the tools, the tokens, and the trustless technology—all in a single command.
Let your smart contracts fly 🚀
Powered by EpicChain Labs.