G
G
Golem SDK
Search…
Becoming a provider
This tutorial shows how to run a Golem Provider node and play around with its functionalities.

Prerequisites

Platforms

For the provider end, we currently, officially support:
  • Ubuntu 18.04 LTS and 20.04 LTS
but you are welcome to try out and run it on other Linux distributions.
To run a Golem provider node we recommend a physical machine as you may encounter issues and limitations when running it on a virtual machine. Because we expect most apps to use vm-based payloads, we don't recommend running a provider on non-Linux platforms.
It is possible to use macOS and Windows as provider hosts, but only with WASI execution environment.
We have enabled the providers to expect payments on the Ethereum mainnet by default. It means that by running a provider node and executing tasks, you are earning real GLM tokens - either as pure ERC-20 tokens or on zkSync.

Installation

Run the installation command

Open your terminal and type:
1
curl -sSf https://join.golem.network/as-provider | bash -
Copied!
You might be asked to modify your PATH afterwards for future terminal sessions:echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
Update your active shell(s) with: export PATH="$HOME/.local/bin:$PATH"

Initial setup

After installing all required components you will be asked to set up your node. If you leave them empty the default values presented in brackets will be applied.
Node name (default=generated_name): - Type in the name of your new node and press Enter
Ethereum wallet address (default=internal wallet): - Paste your own Ethereum address to which you have private keys stored. If you leave this space empty, an address will be created for you on your local system.
Your own Ethereum address could be, for example, any MetaMask or Ledger address that only you control so you can access your tokens from that address. If you choose to have a local wallet it's recommended to store a backup somewhere safe so you can retrieve the tokens. You are responsible for your address. If you lose access to the wallet, there will be no way to retrieve them without a backup.
price GLM per hour (default=0.1): - Type in the value of renting your computer power as a provider. You can use default price (0.1 GLM per hour) by leaving this field empty. This command shows up only when running GolemSP for the first time
Congrats, your initial setup has been completed! You will see that default preset was created based on your initial node setup. If you wish, you can change this settings later on with CLI.

Running the provider

Mainnet

To run the Golem provider on the mainnet, type the following in the terminal:
1
golemsp run
Copied!

Testnet

To run the Golem provider on the testnet, type the following in the terminal:
1
golemsp run --payment-network rinkeby --subnet devnet-beta
Copied!
Your provider node is up and running!

Checking node status

To check your node's status and see if it is actually computing tasks from the network, open a new terminal window and type:
1
golemsp status
Copied!
As an output you will get the information about your node's current state as shown below:
1
$ golemsp status
2
┌──────────────────────────────────────────────┐
3
│ Status │
4
│ │
5
│ Service is running │
6
│ Version 0.8.0 │
7
│ Commit 69838646 │
8
│ Date 2021-10-11 │
9
│ Build 175 │
10
│ │
11
│ Node Name colorful-autumn │
12
│ Subnet public-beta │
13
│ VM valid │
14
├──────────────────────────────────────────────┤
15
│ Wallet │
16
│ 0xc8e9d25c61706b4bdbd6029de9b40bfa45f77fba │
17
│ │
18
│ network mainnet │
19
│ amount (total) 0 GLM │
20
│ (on-chain) 0 GLM │
21
│ (zk-sync) 0 GLM │
22
│ │
23
│ pending 0 GLM (0) │
24
│ issued 0 GLM (0) │
25
├──────────────────────────────────────────────┤
26
│ Tasks │
27
│ │
28
│ last 1h processed 0 │
29
│ last 1h in progress 0 │
30
│ total processed 1 │
31
└──────────────────────────────────────────────┘
Copied!
Under your address you can see both on-chain and zk-sync values listed.
Although zk-sync is from now on the main payment operator in Golem you may receive on-chain transactions as well. To confirm the correctness of the listed values head over to https://etherscan.io/ (on-chain) and https://zkscan.io/ (for zk-sync).
If in the Offers/Tasks column you see your active Offers count, and either tasks in progress or processed then you have successfully computed! If not, give it some time as there is still a limited number of tasks in the network - and then run the command again.

Provider CLI

To check out additional commands available in the CLI, have a look at the reference page:
Last modified 1mo ago