Farmerbot Quick Guide

Table of Contents


We present a quick way to deploy the Farmerbot by deploying a Full VM on the TFGrid and using the file creator to quickly generate the .env and files.

Note that you need at least two 3Nodes on the same farm to make use of the Farmerbot.

Enable Wake-On-Lan

For a 3Node to work properly with the Farmerbot, the parameter wake-on-lan must be enabled. Enabling wake-on-lan on your 3Node may differ depending on your computer model. Please refer to the documentation of your computer if needed.

Usually the feature will be called Wake-on-Lan and you need to set it as "enabled" in the BIOS/UEFI settings.

Here are some examples to guide you:

  • Racker Server, Dell R720
    • Go into System Setup -> Device Settings -> NIC Port -> NIC Configuration
      • Set Wake-on-Lan to Enable
  • Desktop Computer, HP EliteDesk G1
    • Go to Power -> Hardware Power Management
      • Disable S5 Maximum Power Saving
    • Go to Advanced -> Power-On Options
      • Set Remote Wake up Boot source to Remote Server

Hint: Check the Z-OS monitor screen and make sure that all the 3Nodes are within the same lan (e.g. all 3Nodes addresses are between and

Deploy a Full VM

For this guide, we run the Farmerbot on a Full VM running on the TFGrid. Note that you do not need to run the Farmerbot on the TFGrid, but the whole process is very simple as presented here.

  • Deploy a full VM on the TFGrid with minimum specs (512 MB of memory, 1 vcore, 15 GB of storage)
    • Read this guide for more information on deploying a Full VM with the TF Playground

Farmerbot Costs on the TFGrid

If you run the Farmerbot on a 3Node on the TFGrid, you will have to pay TFT to deploy on that 3Node. You can run a full VM at minimum specs for the Farmerbot, that is 1vcore, 15GB of SSD storage and 512MB of RAM. Note that you can use the Planetary Network. You do not need to deploy a 3Node with IPv4. The cost on main net for this kind of workload is around 0.175TFT/hour (as of the date 11-07-23).

Next to that, you will have to pay the transaction fees every time the Farmerbot has to wake up or shut down a node. This means that you need some TFT on the account tied to the twin of your farm.

For the periodic wakeups, each node in the farm is shut down and powered on once a day, i.e. 30 times per month. Also, there is 10 random wakeups per month for each node. This means that each node is turned off and on 40 times per month in average. In that case, the average cost per month to power on nodes and shut them back down equals:

average transaction fees cost per month = 0.001 TFT (extrinsic fee) * amount of nodes * 40 * 2 (1 for powering down, one for powering up)

Install Docker

For this guide, we need to install Docker Engine. The quickest way is to use the Docker convenience script. This method installs the latest stable release of Docker on Linux:

curl -fsSL | sh

If you want, you can also set up and install Docker Engine from Docker’s apt repository. For this method, simply follow the steps given in the sections Set up the repository and Install Docker Engine.

Create the Configuration Files

  • Create the parent folder
    • mkdir -p farmerbot_docker && cd $_
      • Note: you can choose a different name for your parent folder
  • Pull the file creator image from the GitHub Container Registry
    • docker pull
  • Run the file creator image and answer the questions to generate the files
    • docker run --name fbot_config_container -v ./:/farmerbot -ti
      • The config/ and .env files are saved in the parent folder

Note: It is can be a good idea to set only one node with yes for never_shutdown. A node with low power consumption is obviously a wise choice.

Run the Farmerbot

  • Download the Farmerbot .yaml file with this command:
    • wget
  • Run the Farmerbot with this command
    • docker compose up -d

Questions and Feedback

If you have any questions, you can ask the ThreeFold community for help on the ThreeFold Forum or on the ThreeFold Farmers Channel on Telegram.