Bee Using Docker
Docker containers for Bee are hosted at Docker Hub for your convenience.
If running a full Bee node, it is recommended that you make use of Ethereum's external signer, Clef. See below for instructions on how to use Docker Compose to easily set up Bee with persistent storage and integration with the Bee Clef container.
#
Quick StartTry Bee out by simply running the following command in your Terminal.
info
If starting your node for the first time, you will need to deploy a chequebook contract. See Manual Installation for more info.
To persist files, mount a local directory as follows and enter the password used to encrypt your keyfiles. Note, Docker insists on absolute paths when mounting volumes, so you must replace /path/to/.bee-docker
with a valid path from your local filesystem.
Once you have generated your keys, leave Bee to run in the background...
#
VersionsOther versions of the Bee container are also available.
#
Latest Beta Release#
Specific Versions#
EdgePlease see the Docker Hub repository for more information.
#
Docker ComposeConfiguration files for Bee and Bee Clef are provided to enable quick and easy installation of both projects with persistent storage and secure secret management. To install Bee without Clef, simply omit the relevant steps.
#
SetupFirst, retrieve the current docker-compose.yaml
file.
Next, create a .env
file using the example file provided. This file will be responsible for storing configuration and secrets for our Bee and Bee Clef applications.
There are some important configuration parameters which must be set in order for our projects to work. To affect configuration in the .env
file, we first remove the #
at the beginning of the line and then change the value after =
to our desired config.
For Bee, amend the following parameters:
To enable Clef support, we must also change the following params:
With the configuration settings complete, run docker-compose up
with the -d
flag to run Bee and Bee Clef as a daemon.
warning
Docker Compose will create a Docker Volume called bee
containing important key material. Make sure to use to backup the contents of your Docker volume!
Next we must fund our node using the Swarm Goerli Faucet.
To determine our address to fund, we can check the logs for our Bee container:
And look for the lines including your automatically generated Ethereum address (scroll right).
Now, naviate to the https://faucet.ethswarm.org, enter your Ethereum address and submit the form to receive a supply of test Goerli Eth and Goerli BZZ.
After your transaction has been completed, your node should recognise that your wallet has been funded, and begin to deploy and fund your Bee chequebook!
Once Bee has completed this procedure, you may query the Bee HTTP API at http://localhost:1633
.
Congratulations! Your Bee is up and running! ๐