While it's possible that you'll be successful running Golem and this tutorial on other platforms, we officially support the following:
OS X 10.14+
Ubuntu 18.04 or 20.04
To verify your currently installed version of node, please run:
If you have an older version of node and you'd like to keep that version in your system, consider using nvm. You can install it using the instructions from:
https://github.com/nvm-sh/nvm#install--update-script (Linux/macOS X)
Once you have
nvm installed on your machine, run:
nvm install v12
Verify that with:
If you don't have
yarn or need to update, it, please go to: https://classic.yarnpkg.com/en/docs/install/ and choose the version appropriate for your operating system.
You'll also need the
git versioning system client so you can clone our repositories. Ensure you have it available with:
In order to follow our requestor agent tutorial, you'll first need to run the
You can install it using our helper script like this:
curl -sSf https://join.golem.network/as-requestor | bash -
You might be asked to modify your PATH afterwards.
Alternatively, if you'd like to have more control over the installation process, or would like to choose where the binaries end up, you can do that manually.
First, download the requestor package - prefixed
golem-requestor - appropriate for your platform from: https://github.com/golemfactory/yagna/releases/tag/v0.7.1.
Unpack it and put the binaries contained within somewhere in your
PATH (e.g. copy them to
/usr/local/bin on Unix-like systems) or add the directory you placed the binaries in to your
Once binaries are installed, confirm that you're running the latest Golem release:
It should output:
yagna 0.7.1 (a6e1ceb8 2021-06-24 build #157)
Please also verify that you have the correct version of the
gftp binary used for file transfers in the Golem network.
It should output:
gftp 0.7.1 (a6e1ceb8 2021-06-24 build #157)
Now, you can run the daemon:
yagna service run
You can now proceed to Generate the app key.
With the daemon running, enter the daemon's directory using another shell and generate the
yagna app key that will be used by your requestor agent to access yagna's REST API.
yagna app-key create requestor
This should produce a 32-character-long hexadecimal app key that you need to note down as it will be needed to run the requestor agent.
In case you lose your app key, you can retrieve it with:
yagna app-key list
the value in the
key column is the key you need.
In order to be able to request tasks on Golem, you'll need some GLM tokens (called tGLM on the rinkeby testnet) to pay the providers with. Even on the testnet, those tokens are still required but of course you can easily get them issued to you using our tGLM faucet.
That's done using:
yagna payment fund
It tells yagna to check for funds on your node and if needed, contacts the faucet which, in turn, issues some tGLM tokens to the node using zkSync.
Once you issue the command, allow some time until it completes its job. You can verify whether you already have the funds with:
yagna payment status
If, after a few minutes, you still can't see the tokens, re-run the
yagna payment fund command above and check again after a few more minutes.
As the last resort, if you suspect that there is a more serious issue with the zkSync payment driver or our faucet, you may wish to completely do away with using it and fall back to the older, on-chain payment driver. In such case, please refer to instructions in our troubleshooting section.
As the last step before your requestor node is ready, you'll need to enable the daemon as a requestor.
yagna payment init --sender
With this completed, you're good to go!
Now you are ready to run computations on Golem:
And by all means, have fun with Golem!