Installation 🛠
Pre-requisites
You can start using the Fetch Ledger by first installing the following:
- Go 1.18+: installation instructions are available here (opens in a new tab).
- Packages:
make
,gcc
(on Ubuntu, install them withsudo apt-get update && sudo apt-get install -y make gcc
).
Building the code
You can download the latest released version from GitHub and build the project using the running the following command:
git clone https://github.com/fetchai/fetchd.git && cd fetchd
Then, you can build the code by running the following command:
make build
This will generate the ./build/fetchd
binary.
For non-developer users, we recommend to install the binaries into their system. This can be done with the following command:
make install
This will install the binaries in the directory specified by your $GOBIN
environment variable (default to ~/go/bin
). To verify the correct installation, run the following command:
which fetchd
This should return a path such as ~/go/bin/fetchd
(might be different depending on your actual Go installation).
If you get no output, or an error such as which: no fetchd in ...
, possible cause can either be that make install
failed with some errors or that your go binary folder (default: ~/go/bin) is not in your PATH
. You can add the ~/go/bin folder to your PATH, by adding this line at the end of your ~/.bashrc
:
export PATH=$PATH:~/go/bin
and then reload it with:
source ~/.bashrc
You can also verify that you are running the correct version by running the following command:
fetchd version
This would print a version number that must be compatible with the network you are connecting to. See the network page for the list of supported versions per available networks.
FAQ
Error: failed to parse log level (main:info,state:info,:error): Unknown Level String: 'main:info,state:info,:error', defaulting to NoLevel.
This means that you had a pre-stargate version of fetchd
(≤ v0.7.x), and that you have just installed another stargate version (≥ v0.8.x).
You can solve the issue by removing the previous configuration files with the following:
rm ~/.fetchd/config/app.toml ~/.fetchd/config/config.toml