Skip to content

Latest commit

 

History

History
72 lines (52 loc) · 1.6 KB

run-ckb-with-docker.md

File metadata and controls

72 lines (52 loc) · 1.6 KB
Raw

Run CKB with Docker

Start latest CKB release with default configuration:

docker run --rm -it nervos/ckb:latest run

See other tags listed in DockerHub.

  • Tag latest is always the latest release, which is built from the latest master branch.
  • Tags vx.y.z are history releases.
  • Tags vx.y.z-rc are the preview of the release candidates.

It is recommended to mount a volume at /var/lib/ckb in the container. Following is an example to mount a volume, generate config files in the volume and start CKB from it.

First, create a volume.

docker volume create ckb-testnet

Then init the directory with testnet chain spec.

docker run --rm -it \
  -v ckb-testnet:/var/lib/ckb \
  nervos/ckb:latest init --chain testnet --force

Create a container ckb-testnet-node to run a node:

docker create -it \
  -v ckb-testnet:/var/lib/ckb \
  --name ckb-testnet-node \
  nervos/ckb:latest run

Copy the generated config files from the container:

docker cp ckb-testnet-node:/var/lib/ckb/ckb.toml .
docker cp ckb-testnet-node:/var/lib/ckb/ckb-miner.toml .

Edit the config files as you like. If you want to run a miner, remember to replace [block_assembler] section in ckb.toml.

Copy back the edited config files back to container:

tar --owner=1000 --group=1000 -cf - ckb.toml ckb-miner.toml | \
  docker cp - ckb-testnet-node:/var/lib/ckb/

Now start the node:

docker start -i ckb-testnet-node

And start the miner in the same container

docker exec ckb-testnet-node ckb miner