These examples shows valid setups using Chia for both docker run and docker-compose. Note that you should read some documentation at some point, but this is a good place to start.
Simple example:
docker run --name chia --expose=8444 -v /path/to/plots:/plots -d ghcr.io/chia-network/chia:latestSyntax
docker run [--name <container-name>] [--expose=<port>] [-v </path/to/plots:/plots>] -d ghcr.io/chia-network/chia:latestOptional Docker parameters:
- Give the container a name:
--name=chia - Accept incoming connections:
--expose=8444 - Volume mount plots:
-v /path/to/plots:/plots
version: "3.6"
services:
chia:
container_name: chia
restart: unless-stopped
image: ghcr.io/chia-network/chia:latest
ports:
- 8444:8444
volumes:
- /path/to/plots:/plotsYou can modify the behavior of your Chia container by setting specific environment variables.
Set the timezone for the container (optional, defaults to UTC).
Timezones can be configured using the TZ env variable. A list of supported time zones can be found here
-e TZ="America/Chicago"To use your own keys pass a file with your mnemonic as arguments on startup
-v /path/to/key/file:/path/in/container -e keys="/path/in/container"or pass keys into the running container with your mnemonic
docker exec -it <container-name> venv/bin/chia keys addalternatively you can pass in your local keychain, if you have previously deployed chia with these keys on the host machine
-v ~/.local/share/python_keyring/:/root/.local/share/python_keyring/or if you would like to persist the entire mainnet subdirectory and not touch the key directories at all
-v ~/.chia/mainnet:/root/.chia/mainnet -e keys="persistent"You can persist whole db and configuration, simply mount it to Host.
-v ~/.chia:/root/.chia \
-v ~/.chia_keys:/root/.chia_keysTo start a farmer only node pass
-e service="farmer-only"To start a harvester only node pass
-e service="harvester" -e farmer_address="addres.of.farmer" -e farmer_port="portnumber" -v /path/to/ssl/ca:/path/in/container -e ca="/path/in/container" -e keys="none"To set the full_node peer's hostname and port, set the "full_node_peer" environment variable with the format hostname:port
-e full_node_peer="node:8444"This will configure the full_node peer hostname and port for the wallet, farmer, and timelord sections of the config.yaml file.
The plots_dir environment variable can be used to specify the directory containing the plots, it supports PATH-style colon-separated directories.
Or, you can simply mount /plots path to your host machine.
Set the environment variable recursive_plot_scan to true to enable the recursive plot scan configuration option.
By default, Docker requires a container restart to discover newly mounted filesystems under a configured bind-mount. Setting the bind-propagation option to rslave enables dynamic addition of sub-mounts while the container is running (Linux systems only). See Docker Bind Mounts documentation for more information.
-v /plotdrives:/plotdrives:rslaveThere are a few environment variables that control compressed plot settings for Harvesters ran with chia-docker. The default settings leave compressed plot harvesting disabled, but it can be enabled.
See the official documentation for a description on what each of these settings do.
Compressed plot farming can be enabled by setting the following:
-e parallel_decompressor_count=1
-e decompressor_thread_count=1And to use an nvidia GPU for plot decompression, set:
-e use_gpu_harvesting="true"To set the log level to one of CRITICAL, ERROR, WARNING, INFO, DEBUG, NOTSET
-e log_level="DEBUG"To set the peer_count and outbound_peer_count
for example to set both to 20 use
-e peer_count="20"-e outbound_peer_count="20"To disable UPnP support (enabled by default)
-e upnp="false"Log file can be used by external tools like chiadog, etc. Enabled by default.
To disable log file generation, use
-e log_to_file="false"version: "3.6"
services:
chia:
container_name: chia
restart: unless-stopped
image: ghcr.io/chia-network/chia:latest
ports:
- 8444:8444
environment:
# Farmer Only
# service: farmer-only
# Harvester Only
# service: harvester
# farmer_address: 192.168.0.10
# farmer_port: 8447
# ca: /path/in/container
# keys: generate
# Harvester Only END
# If you would like to add keys manually via mnemonic file
# keys: /path/in/container
# OR
# Disable key generation on start
# keys:
TZ: ${TZ}
# Enable UPnP
# upnp: "true"
# Enable log file generation
# log_to_file: "true"
volumes:
- /path/to/plots:/plots
- /home/user/.chia:/root/.chia
# - /home/user/mnemonic:/path/in/containerYou can run commands externally with venv (this works for most chia CLI commands)
docker exec -it chia venv/bin/chia plots add -d /plotsYou can see status from outside the container
$ docker exec -it chia venv/bin/chia farm summary
Farming status: Farming
Total chia farmed: xx
User transaction fees: xx
Block rewards: xx
Last height farmed: xxxxxxx
Local Harvester
xxx plots of size: xx.xxx TiB
Plot count for all harvesters: xxx
Total size of plots: xx.xxx TiB
Estimated network space: 30.638 EiB
Expected time to win: x months and x weeks
Note: log into your key using 'chia wallet show' to see rewards for each keyOr via chia peer. Note that you have to specify your component.
docker exec -it chia venv/bin/chia peer -c {farmer|wallet|full_node|harvester|data_layer}Or via chia show -s.
$ docker exec -it chia venv/bin/chia show -s
Network: mainnet Port: 8444 RPC Port: 8555
Node ID: xxxxx
Genesis Challenge: xxxxx
Current Blockchain Status: Full Node Synced
Peak: Hash: xxxxx
Time: Fri Jan 19 2024 17:52:44 CET Height: 4823454
Estimated network space: 30.639 EiB
Current difficulty: 11136
Current VDF sub_slot_iters: 574619648
Height: | Hash:
4823454 | 7e66bd11e46801b25ac9237e300deff27a4750fc3bf4eb7e3c594b17faaf0b37
4823453 | 9f5b68a52364c1afec48bc87d26bbba912c355e7f51c970f7bf89d068c762530
4823452 | db3b5bb0e3d09fd398e2d9bd159c387f9ad280ec8719916ebb6c25c948834f9c
4823451 | 5dd056960ec14da1c54fe295f33487e280f3e3c39eddced158ebb520b8215894
4823450 | a3f5a3f61728b1f52e1ab7971b29d0c55b6bc8e2797ad826b780ada7a0f76a49
4823449 | 052075e6b9881049c95c3ceeabed9160e5bfbf55a2b3b0768a743542ce88a3a3
4823448 | 3e2b954d4eb782d1ce67eb7f17e9bf72843d17948ba181168dbc239c5e70acd2
4823447 | 69539a9474c239280b6a6b4ab5be994e892c1b75c7bfb8967517e75ee5a65b12
4823446 | 47ce031f46b2b0c9f90e90de4f9cab58054f356a7a3019b30c8f6292b86a5aae
4823445 | 8c5d0254db6e304696d240dc70bad803ad227b861d68e65a3dc30c0aeef298f6
docker run -d --expose=58444 -e testnet=true --name chia ghcr.io/chia-network/chia:latestSometimes you may want to access Chia RPCs from outside of the container, or connect a GUI to a remote Chia farm. In those instances, you may need to configure the self_hostname key in the Chia config file.
By default this is set to 127.0.0.1 in chia-docker, but can be configured using the self_hostname environment variable, like so:
docker run -d -e self_hostname="0.0.0.0" --name chia ghcr.io/chia-network/chia:latestThis sets self_hostname in the config to 0.0.0.0, which will allow you to access the Chia RPC from outside of the container (you will still need a copy of the private cert/key for the component you're attempting to access.)
To get new wallet, execute command and follow the prompts:
docker exec -it chia-farmer1 venv/bin/chia wallet showdocker build -t chia --build-arg BRANCH=latest .The Dockerfile includes a HEALTHCHECK instruction that runs one or more curl commands against the Chia RPC API. In Docker, this can be disabled using an environment variable -e healthcheck=false as part of the docker run command. Or in docker-compose you can add it to your Chia service, like so:
version: "3.6"
services:
chia:
...
environment:
healthcheck: "false"In Kubernetes, Docker healthchecks are disabled by default. Instead, readiness and liveness probes should be used, which can be configured in a Pod or Deployment manifest file like the following:
livenessProbe:
exec:
command:
- /bin/sh
- -c
- '/usr/local/bin/docker-healthcheck.sh || exit 1'
initialDelaySeconds: 60
readinessProbe:
exec:
command:
- /bin/sh
- -c
- '/usr/local/bin/docker-healthcheck.sh || exit 1'
initialDelaySeconds: 60See Configure Probes for more information about configuring readiness and liveness probes for Kubernetes clusters. The initialDelaySeconds parameter may need to be adjusted higher or lower depending on the speed to start up on the host the container is running on.
docker run -e service=simulator -v /local/path/to/simulator:/root/.chia/simulator ghcr.io/chia-network/chia:latest
Mounts the simulator root to the provided local path to make the test plots and the mnemonic persistent. Mnemonic will be available at /local/path/to/simulator/mnemonic
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent