Quick Start
Bee is packaged for MacOS and Ubuntu, Raspbian, Debian and CentOS based Linux distributions.
If your system is not supported, please see the manual installation section for information on how to install Bee.
The overview of the installation process:
- (Recommended) set up an external signer for Bee (i.e. install bee-clef)
- install the Bee application package
- fund your node with gETH and gBZZ
#
Install Bee ClefBefore installing Bee, it is recommended that you first install the Bee clef package. This will set up a Bee specific instance of the Go-Ethereum Clef signer which will be integrated with your Bee node.
info
While it is not necessary that node operators make use of Go Ethereum's Clef external signer to manage your Ethereum key pair. The following instructions include and integrate Bee-clef alongside Bee to help keep your keys safe!
#
Install BeeTo install Bee itself, simply choose the appropriate command from the ones below. This will set up Bee and start running it in the background as a service on your computer.
info
Follow post install guide in terminal for initial configuration and how to start bee
.
#
Ubuntu / Raspbian / Debian#
AMD64#
ARM (Raspberry Pi)#
ARMv7#
ARM64#
CentOS#
AMD64#
ARM (Raspberry Pi)#
ARMv7#
ARM64#
MacOSTo run Bee as a service now and on startup, run:
#
SWAP Blockchain EndpointYour Bee node must have access to the Ethereum blockchain, so that it can interact and deploy your chequebook contract. You can run your own Goerli node, or use a provider such as rpc.slock.it/goerli or Infura.
By default, Bee expects a local Goerli node at http://localhost:8545
. To use a provider instead, simply change your --swap-endpoint
in your configuration file.
#
Interact With BeeOnce Bee has been installed, it will start up as a systemd
service,
and once it has been funded, its HTTP based
API will start listening at
localhost:1633
.
#
LinuxWe can now manage the Bee service using systemctl
.
Logs are available using the journalctl
command:
#
MacOSServices are managed using Homebrew services.
Logs are available at /usr/local/var/log/swarm-bee/bee.log
#
Fund Your NodeA SWAP enabled Bee node requires both gETH and gBZZ to begin operation. The current version of Swarm incentives is running on the Ethereum Goerli testnet. To acquire free gBZZ tokens visit the Bzzaar and follow the following steps!
#
1. Find your Bee node's address.To find a Bee node's Ethereum address you can:
- look into its logs (see above),
- use the handy
bee-get-addr
utility,
- send a request to our Bee node's debug API endpoint called addresses.
Bzzaar and buy some gBZZ!#
2. Come to theYou can get to the Bzzaar by navigating to the link shown in your logs. It should look something like this, note that the Ethereum address of your node is prefilled in the receiver
query parameter.
https://bzz.ethswarm.org/?transaction=buy&amount=10&slippage=30&receiver=0xbee467355...
Make sure that your Bee node's correct address is displayed above the transaction modal.
You are minting to receiver - 0xbee467355...
Metamask or Portis.#
3. Connect your wallet, we recommendGET G-ETH
button in the bottom left hand corner of your screen.#
3. Click the #
4. Wait for the Goerli ETH to arrive in your wallet.We will send a small amount of gETH to both your connected wallet, and your Bee's wallet!
This can take a couple of minutes, check the faucet address on Etherscan and look for the transactions to your addresses.
You may need to reconnect your wallet to see your balance increase once the transaction has completed.
gBZZ
field, you may even have enough gETH to buy a little more!#
5. Once you have balance, enter at least 10 in the This is another blockchain transaction, minutes check Metamask to see how your transaction is getting on.
#
6. When your transaction is complete, your Bee node should be the proud owner of some freshly minted gBZZ!#
7. Check your Bee node, it should now begin deploying your checkbook contract.If your node has stopped polling for updates, you may now need to restart it.
Once your Bee node is fully loaded with gBZZ, we can now watch our logs and watch as Bee automatically deploys a chequebook and makes an initial deposit.
Once this is complete, we should start to see our Bee node connect to other nodes in the network as it begins to take part in the swarm.
info
The Bzzaar is brand new. If you have any issues, please get in touch and let us know! You may also visit our legacy Goerli faucet at https://faucet.ethswarm.org and fill out the form with your Bee node's address to receive your nodes initial supply of gBZZ and GETH.
If these messages are missing, check out our comprehensive guide to Bee connectivity.
#
Updating BeeYour Bee and Bee-clef installations can be updated by repeating the install steps above. Bee sure to backup your clef key material and Bee data before applying updates.
#
Uninstalling BeeIf you need to remove Bee, you may simply run the below commands.
#
Ubuntu / Debian / Raspbiandanger
Uninstalling Bee will also delete Bee and Bee-clef data! Make sure you make backups so you don't lose your keys and data.
#
Centosdanger
Uninstalling Bee will also delete Bee and Bee-clef data! Make sure you make backups so you don't lose your keys and data.
#
Data Locations#
Bee-clefConfiguration files are stored in /etc/bee-clef/
Key material and other data is stored in /var/lib/bee-clef/
#
BeeConfiguration files are stored in /etc/bee/
State, chunks and other data is stored in /var/lib/bee/