Installation 🛠

Pre-requisites

You can start using the Fetch Ledger by first installing the following:

Go 1.18+: installation instructions are available here .
Packages: make, gcc (on Ubuntu, install them with sudo 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