Docker
Alternatively to using our simple tool tmn
, people or companies with existing infrastructure might want to directly run our docker images for more flexibility.
To achieve that, you just need to run our tomochain/node
docker image.
This image runs the TomoChain go client with some automation added on top.
Tags¶
Environment | Tag |
---|---|
Testnet | :testnet |
Mainnet | :stable |
Environment variables¶
Variable | Required | Default | Example | Description |
---|---|---|---|---|
IDENTITY |
False | Random name | my-super-node |
The name of your masternode |
PASSWORD |
False | Random password | S5G@fS3A8+*g-)ftYc |
The password used by the the client to localy encrypt its account |
PRIVATE_KEY |
False | Random account | 0xa3f5195... |
The private key of the account who will identify the node and receive txs fees |
BOOTNODES |
True | None | enode://4d3...@1.2.3.4:30301,enode://... |
The comma separated list of bootnodes. Find them here |
VERBOSITY |
False | 3 | 4 |
The level of logging (default one should be enough) |
NETWORK_ID |
False | 89 | 88 |
The network id of the join your node is joining. Find them here |
WS_SECRET |
False | None | d$M4J4\5gLAz%Zjn>% |
The password to send data to the stats website |
NETSTATS_HOST |
False | netstats-server | https://stats.tomochain.com |
The stats website to report to, regarding to your environment |
NETSTATS_PORT |
False | 3000 | 443 |
The port used by the stats website (usually 443) |
ANNOUNCE_TXS |
False | None | True |
Enable reporting transactions via RPC/WS |
Ports¶
Exposed | Protocol | Description |
---|---|---|
30303 |
tcp | TomoChain client p2p port |
30303 |
udp | TomoChain client p2p port |
8545 |
tcp | Blockchain RPC |
8546 |
tcp | Blockchain WS |
Filesystem¶
Path | Content |
---|---|
/tomochain/data |
Chaindata |
/tomochain/keystore |
Accounts |
Examples¶
docker run
docker run -d --name masternode \ -e IDENTITY=$MASTERNODE_NAME \ -e PRIVATE_KEY=$MASTERNODE_PK \ -e BOOTNODES=$BOOTNODES \ -e NETSTATS_HOST=stats.tomochain.com \ -e NETSTATS_PORT=443 \ -e WS_SECRET=$STATS_WS_SECRET \ -p 30303:30303 \ -p 30303:30303/udp \ -v chaindata:/tomochain/data \ tomochain/node:stable
docker-compose.yml
version: "3.4" services: masternode: image: tomochain/node:stable environment: IDENTITY: $MASTERNODE_NAME PRIVATE_KEY: $MASTERNODE_PK BOOTNODES: $BOOTNODES NETSTATS_HOST: stats.tomochain.com NETSTATS_PORT: 443 WS_SECRET: $STATS_WS_SECRET ports: - 30303:30303 - 30303:30303/udp volumes: - chaindata:/tomochain/data