Welcome to the ThreeFold FAQ!

This project is a collective effort aiming at a conscious internet, for the people, by the people.

ThreeFold grows as the TF community creates and shares knowledge.

A big thank you to all the farmers, developers and users who contributed, directly or indirectly, to this FAQ.

Hint: Use the search function (Ctrl+F) to locate specific keywords

If you can't find the answer to your question, ask a question to the ThreeFold Community!

Main Sections

Table of Contents



Basic Facts

What is the the ThreeFold blockchain?

ThreeFold blockchain is the layer 0 infrastructure for an open source peer-to-peer (P2P) Internet owned by humanity.

What is the architecture of the ThreeFold Grid in simple terms?

Essentially, the ThreeFold Grid is composed of the people using it, the 3node servers offering compute, storage and network resources, and the TF Chain, which is the blockchain of ThreeFold.

Middleware is also used, such as GraphQL and GrixProxy, to get and organize data from the ThreeFold Chain. Middleware helps to make data available and to manage load.

3nodes store workloads data and can report on their state to the TF Grid and to middleware.

What is the ThreeFold Token? What are the uses of the ThreeFold token (TFT)?

ThreeFold Token (TFT) is a decentralized digital currency used to buy autonomous and decentralized Internet services (compute, storage, applications) on the ThreeFold Network – generated only when active capacity is added to the ThreeFold Grid. It has a specific commercial utility, since ThreeFold Tokens were conceived as the designated currency for buying and selling capacity on the ThreeFold Grid.

How are ThreeFold Token (TFT) produced?

ThreeFold Tokens are exclusively produced through a process called farming, which means that TFT are generated only when new Internet capacity is added to the ThreeFold Grid. There is no wasteful mining.

How are the TFT managed?

TFT are managed by the ThreeFold Blockchain (“TF Chain”).

What is the difference between Internet capacity and connectivity? Does ThreeFold replace my Internet service provider (ISP)?

In simple terms, the Internet is composed of both capacity and connectivity. Capacity is where the data and resources are being handled, for example in servers. Connectivity is the infrastructure that transfer data and resources between servers. The latter is linked to the typical Internet service provider (ISP).

ThreeFold’s technology enables distributed capacity generation, but ThreeFold doesn’t deal in connectivity. 3nodes offer Internet capacity, but farmers still rely on connectivity provider like the usual Internet service provider (ISP).

I've read that ThreeFold is Carbon Negative, what does this imply?

In short, to accomplish a Carbon Negative footprint, ThreeFold has a general strategy and many tactics that are all aimed at building and contributing to a regenerative and resilient environment. In long, read this post.

Who are the people working for ThreeFold?

People from all over the world contribute to the growth of ThreeFold. Meet them here.

Who are the co-founders of ThreeFold?

The co-founders of ThreeFold are:

In a nutshell, what can be said of the ThreeFold team?

The ThreeFold team is spread across the world and its members built some of the world’s best Internet storage and cloud automation technologies since the ‘90s.

What is the mission of ThreeFold?

The mission of ThreeFold is to create a peer-to-peer Internet that can host all of humanity’s digital workloads via smart contract, removing all forms of centralization from global IT systems.

Who are the partners of ThreeFold?

ThreeFold has great partners and we are proud of the amazing projects we have done throughout the years. Building the New Internet is a collective project and the ThreeFold team is always ready to create and collaborate with new partners aligned with our Planet first ethos.

To learn more about our certified farming partners, click here.

What are the priorities of ThreeFold (the Three P of ThreeFold)? ThreeFold is a Planet first project, what does it mean?

ThreeFold is working for the Planet, the People and Profit, in this very order of importance. Planet comes first as it is our home to us all. A humane enterprise always has people before profit, and serious entrepreneurs know profit cannot be left out of the equation of a thriving project.

I want to farm TFT with a 3node. What are my choices?

There are two possibilities. Either buy a certified 3node (plug n play) or build yourself a DIY 3node.

I want to buy a certified 3node server from a reliable source. Who are ThreeFold's partners offering certified 3nodes?

You can find the continually growing list of ThreeFold's partners provoding high-quality 3nodes here.

I want to help build the new Internet. How can I become a ThreeFold certified 3node partner?

Apply here to become a ThreeFold certified 3node partner.

How is ThreeFold registered as an entity?

ThreeFold has different registrations and each serves a different purpose.

There is ThreeFold VZW, in Belgium. Note that VZW is Belgium's denotation for non-profit association. Read more here.

There is also ThreeFold DMCC, in Dubai. Read more here.

There is also ThreeFold Tech NV, a software company which owns the IP of the code delivered. Read more here.

Where is ThreeFold Tech's headquarters?

ThreeFold Tech is located in Lochristi, Oost-Vlaanderen, Belgium.

Can I have more information on ThreeFold Tech NV and ThreeFold S.A.?

Of course. Here are the basic information:

  • TF Tech NV (ThreeFold Tech)

    • Registered at the Belgian Chamber of Commerce under number 0712845674.
    • TF Tech NV is a limited liability organisation under the laws of Belgium. TF TECH NV. Antwerpse Steenweg 19 9000 - Lochristi, Belgium info@threefold.tech BE 0712.845.674 (RPR Gent) Tel: 0032-93242057
  • ThreeFold S.A. (TF LUX)

    • A public limited liability company under the Company Number B265333, governed by the laws of the Grand Duchy of Luxembourg.
    • ThreeFold S.A., 6, Rue Dicks, 1417, Luxembourg.

Is ThreeFold using Wireguard?

Wireguard is built directly into the ThreeFold Grid. It's called "Znet" or "private overlay network". Actually all deployments belong to a private overlay network, but the only way to get your wireguard config file to access the network is to use Terraform.

Is the 3bot the same as the Digital Twin?

The Digital Twin will be a more advanced version of the 3bot.

How can I create a twin on the TF Grid?

There are 2 ways to create a twin:

You can create a twin via the ThreeFold Dashboard portal. See those related documentations for more information: Polkadot Extension account and Create a Farm.

You can also create a twin via the ThreeFold Connect app. Indeed, a twin is automatically generated while creating a farm. Note that, in this case, the twin will be created on mainnet.

ThreeFold Communication

Is there a ThreeFold app for mobile?

Yes! ThreeFold Connect App (TF Connect App) is available for Android and iOS.

You can use this app to create a ThreeFold ID, a ThreeFold Wallet and also a ThreeFold Farm to link all your 3nodes. The ThreeFold Connect Wallet, with its Stellar payout address, can be used for transactions as well as to receive farming rewards. The News section gives you the latest information on the fast ThreeFold development and growth.

You can find links to the ThreeFold community here. Here's a quick list:

Is there a Discord group for ThreeFold?

Yes! It’s right here. ThreeFold is decentralized. This is a community initiative. Come and talk. Let's New Internet!

How can I reach ThreeFold Support?

The easiest way to contact the ThreeFold support is to use this link and click on the chat icon.

You can also go on the ThreeFold Connect App and select Support or go on the ThreeFold website, accept the cookies and click on the bottom right icon for chat.

Could we reach out someone for publishing research work on ThreeFold?

You can send an email to info@threefold.io for publishing research on ThreeFold.

Is there a ThreeFold podcast?

Yes, there is a ThreeFold podcast! Hosted by Kyle Ellicot, it is available to listen on Spotify and on anchor.fm.

Who can I write to for a proposal? Where can I send a proposal email for a new partnership opportunity with ThreeFold?

You can mail your proposal to info@threefold.io or write about your proposal on the ThreeFold Forum.

How can I track and follow the progress and development of ThreeFold?

There are two main places where you can track the progress of ThreeFold. ThreeFold is open source and its developments can be easily tracked on Github.

  • You can read about the ongoing ThreeFold Tech projects here.
  • You can read about the ongoing ThreeFold Foundation projects here.

Why do some forum posts need to be approved?

The configurations of the ThreeFold forum make so that some posts need approval, depending on where they are posted. Like posting from meta-sections, and some specific sections.

Also, note that certain posts can automatically get flagged for moderation based on their content.

The Technology of ThreeFold

What is a 3node?

It is essentially a single server that makes up a larger network of servers which together form the ThreeFold Grid. Essentially any modern computer can be turned into a 3node (DIY Farming) and you can buy plug and play 3nodes as state of the art modern computer.

What is the difference between a 3node and a ThreeFold farm?

A 3node is a single server connected to the Grid. Each 3node is linked to a farm. A farm can be composed of multiple 3nodes.

I've read that ThreeFold built an Operating System (OS) from scratch, is it true?

Indeed, to have a quantum safe technology and nodes capabling on running the widest range of softwares, the team built an operating system from the ground up, the almighty Zero-OS. Read the next question for more info on Zero-OS.

What is Zero-OS from ThreeFold?

Zero-OS is a stateless and lightweight operating system designed to host anything that runs on Linux, in a decentralized way. Once installed, Zero-OS locks the hardware and dedicates its capacity to the People’s Internet via the ThreeFold Blockchain.

ThreeFold uses Quantum Safe Storage technology, what does it mean?

Quantum computers are theoretically capable of doing huge calculations in a short period of time. By this fact alone, it is a great potential threat to future online safety. ThreeFold solves this future problem before it even becomes a reality. Indeed, Zero-os can compress, encrypt, and disperse data across the Grid.

Quantum Safe File System (QSFS) allows for part of the storage to go down and it can self repair, however it’s still attached to a single VM and a single point of failure. Can a QSFS instance be reattached to another VM to recover it?

QSFS is built from storage devices which are distributed and decentralized.

The storage engine is a software running on a VM that can run everywhere. If the storage engine needs to run on a different VM the config needs to pushed to the new VM. In short, yes Quantum safe file system (QSFS) can be recovered on a different VM. It is not automated yet on Zero-OS. A video tutorial will be shared soon.

Where does the ThreeFold Explorer take its data from?

The ThreeFold Explorer takes its data from this website: https://gridproxy.grid.tf/.

To explore Grid Proxy, you can use Swagger: https://gridproxy.grid.tf/swagger/index.html. You will then be able to query the TF Grid and extract data.

See the next Q&A for more information on Swagger.

How can I use the Gridproxy to query information on the TF Grid?

You can go to the Gridproxy Swagger index: https://gridproxy.grid.tf/swagger/index.html.

There you can query information such as information on a 3node.

For example, asking the Gridproxy for the nodeID 466, you get the following URL: https://gridproxy.grid.tf/nodes/466.

To get specific information, you can add parameters, for example: https://gridproxy.grid.tf/nodes/466/status.

When you know the URL representation of the query, you can simply use the URL directly on a web browser.

Is there a way to see the ThreeFold Grid's metrics?

You can see the ThreeFold Grid Devnet's metrics on the page metrics.grid.tf. The metric tool is using Grafana, an open source visualization web application.

To see the statistics of the ThreeFold Grid in general, visit the ThreeFold Dashboard and select Statistics in the left menu Explorer.

How can I see the stats of the ThreeFold Grid?

You can go to think link: https://stats.grid.tf/ to see the stats of the ThreeFold Grid.

You can also check this thread on the ThreeFold forum.

How can I connect to the ThreeFold Planetary Network?

You can connect with your phone by using the ThreeFold Connect App. Simply select the Planetary Network option in the menu.

To connect on a computer, you can download the pre-release vesion of the ThreeFold Planetary Network connector.

Where can I download the ThreeFold Planetary Network connector?

It is available in the ThreeFold Planetary Network repository on Github. You can download pre-release versions here for MAC, Linux and Windows.

What is Proof-of-Capacity used by ThreeFold?

Proof-of-Capacity is an algorithm that verifies the Internet capacity provided by the 3nodes. More information can be found here.

What is Proof-of-Utilization?

Proof-of-Utilization is the underlying mechanisms that verifies the utilization of Internet capacity on the ThreeFold Grid.

Every hour, the utilization is recorded in TFChain and the user is charged for the Internet capacity used on the ThreeFold Grid. Discount calculated in line with the amount of TFT users have in their accounts on TFChain. Learn more about the discount here.

How does Proof-of-Utilization work? How is the ThreeFold Token (TFT) distributed when there is utilization on the ThreeFold Grid?

Here are the general steps of the Proof-of-Utilization process:

  1. A user reserves Internet capacity on a given set of 3Nodes.
  2. Zero-OS records the reserved and used CU, SU, NU and IPAddresses in correlation with TFChain records.
  3. The TFChain DAO will charge the costs to the user in line with discount mechanism.
  4. TFT from the user account are burned/distributed in line to table below.

When people spend ThreeFold Tokens on the ThreeFold Grid for any kind of deployment, the TFT is distributed as per the Proof-of-Utilization distribution flow.

The Proof-of-Utilization distribution flow is the following:

  • 50% goes to solution providers and sales channels*
  • 35% goes to TFT burning
  • 10% goes to the ThreeFold Foundation
  • 5% goes to the Validator Staking Pool

To see the Proof-of-Utilization distribution flow chart, check this link.

*Note: For billing purposes, ThreeFold DAO will check if the workload comes from a known sales channel and/or solution provider. If yes, then the billing smart contract code will know how to distribute the TFTs. If the sales channel and/or solution provider is not known, then the 50% will go to a DAO owned Community Grant Wallet. If less than 50% is allocated to the solution provider/sales channel, the remaining of the 50% will go to the DAO owned Community Grant Wallet.

What is the difference between a seed phrase (mnemonics) and an HEX secret?

A seed phrase (also called mnemonics) is a set of words from a carefully selected pool that can be used to derive cryptographic secrets. A HEX secret is a more direct representation of such secret that the computer uses. In the case of an HEX secret, there is no extra information present to form complete words of the seed phrase.

In typical usage, multiple secrets can be derived from a seed phrase via a one-way operation. The secret and its derived public key are sufficient to do any cryptographic operation like signing transactions or encrypting data, but it can't be used to get back the words of the seed phrase.

Buying and Transacting TFT

How can I buy TFT?

There are many ways to do this. You can buy on PancakeSwap, on BTC-Alpha or on the GetTFT website. For more information, check this link.

What is the maximum supply of ThreeFold tokens? What is the current supply of ThreeFold tokens?

The maximum token supply of the ThreeFold Token (TFT) is 4 billion. You can read more about this here.

As of now, more than 880 000 000 ThreeFold tokens (TFT) have been farmed.

How is the ThreeFold Token(TFT) created (minted)? ThreeFold Token is a pure utility token. What does this mean?

ThreeFold Tokens (TFT) are created (minted) by the ThreeFold Blockchain (TFChain) only when new Internet capacity is added to the ThreeFold Grid by farmers. For this reason, TFT is a pure utility token as minting is solely the result of farming on the ThreeFold Grid.

Where can I find TFT, concretely? On which blockchains is TFT available?

  • Stellar Chain
    • Most TFT exist on Stellar at the moment and this is the chain where all farming rewards are currently distributed.
  • ThreeFold Chain
    • the new ThreeFold blockchain that’s used for billing on Grid v3 and will be used to pay Grid v3 farmers at some point in the future.
  • Binance Smart Chain
    • Binance Smart Chain (BSC) - this TFT exists mostly for buying, selling, and providing liquidity on Pancake Swap 2.

What are the uses for each different blockchains offering TFT?

  • ThreeFold Chain (TF Chain)
    • TF Chain is used to store the full infrastructures of
      • farms
      • nodes
      • contracts
      • billing reports
      • etc.
    • TFT can be used as Internet Capacity on the ThreeFold Grid
  • Stellar Chain
    • Stellar is used as a payment network
    • TFT is minted on Stellar Chain
  • Binance Smart Chain (BSC)
    • TFT can be traded and moved on Binance Smart Chain

Note that TFT is fundamentally a utility token. It is Internet capacity farmed by TF Farmers and used by TF Users.

What is the interplay between Stellar Chain and TF Chain?

Stellar is basically a payment network. But we also need a decentralized way to store the full infrastructure of farms, nodes, contracts, billing reports etc. This is available now on TFChain, as you can see here.

Stellar remains very good when it's purely about fast payment, while TF Chain is used as the decentralized blockchain of the New Internet.

It's why both remain active, with a bridge in-between to enable transfer of the same tokens on two blockchain infrastructures.

Note that TFT is also available on BSC.

Is there a bridge between Binance Smart Chain (BSC) and Stellar to transfer TFT?

Yes! It's over here.

What are the different ThreeFold bridges, TFChain-Stellar Bridge and BSC-Stellar Bridge? How can I go from TF Chain to Stellar chain to Binance Smart Chain?

In short, there is the BSC-Stellar Bridge and the TF Chain-Stellar Bridge.

The BSC-Stellar Bridge is used to go between the Stellar Chain and Binance Smart Chain (BSC). The TFChain-Stellar Bridge is used to go between Stellar Chain and TF Chain.

To go from BSC to TF Chain, or from TF Chain to BSC, you need to use the two bridges.

BSC can be used to sell/buy TFT while TF Chain can be used to deploy Dapps on https://play.grid.tf

How can I bridge TFT from Stellar chain to TF Chain and vice versa?

Go on the ThreeFold Dashboard, sign-in with your Polkadot extension account and then go in the section Twin if you aren't there already. Click on Bridge TFT from Stellar to transfer TFT from Stellar to TF Chain. Click on Bridge TFT to Stellar to transfer TFT from TF Chain to Stellar.

Note: If you are on ThreeFold Connect App, you can export your account to the Polkadot extension. Look at the section Move Farm from the TF app to the TF Dashboard (polkadot.js) in the ThreeFold Farming Guide Part 2.

How can I bridge TFT from Binance Smart Chain (BSC) to Stellar (and vice versa)?

To use the BSC-Stellar Bridge, read the following steps. If this is your first time with MetaMask and BSC, read the section How to Set Up TFT on Metamask below.

Note: Always start with a small amount the first time you try the Bridge.

How to use the BSC-Stellar Bridge

To use the BSC-Stellar Bridge, follow the following steps. If this is your first time with MetaMask and BSC, read the section Setting up TFT on Metamask.

Note: Always start with a small amount the first time you try the Bridge.

How to Bridge TFT from Stellar to BSC


  • Metamask account
  • TF Connect App+Wallet
  • TFT on Stellar Blockchain


  1. Go to the BSC-Stellar Bridge website.
  2. Connect your MetaMask Wallet.
  3. Sign in with MetaMask.
  4. Choose the option Deposit from Stellar.
  5. Agree to the Threefold Terms.
  6. Read and tick the box of the Warning Message.
  7. On your phone, open up your ThreeFold Connect App and go to the wallet section.
  8. Select the option Send.
  9. Select the Stellar chain.
  10. Click on the button Scan QR Code . The QR Code option automatically fill up your MESSAGE.
  11. Scan the QR code that appears on the Bridge window (or write the information manually).
  12. Make sure the MESSAGE is correctly entered.
  13. Press Send Tokens.
  14. Press Confirm.

In this method, you use the Bridge directly. Thus, it is normal if you do not see your standard MetaMask address. MetaMask is on ERC20 and TFT is on Stellar. You are sending TFT to the Bridge's address, and the Bridge sends money to your wallet afterward.

How to Bridge TFT from BSC to Stellar


  • Metamask account
  • TF Connect App+Wallet
  • BNB for gas fees
  • TFT


  1. Go to the BSC-Stellar Bridge website.
  2. Connect your MetaMask Wallet.
  3. Sign in with MetaMask.
  4. Choose the option Deposit from BSC.
  5. Agree to the Threefold Terms.
  6. Read and tick the box of the Warning Message.
  7. On your phone, open up your ThreeFold Connect App and go to the wallet section.
  8. Copy your Stellar address.
  9. Paste your Stellar address in the proper field on The BSC-Stellar Bridge.
  10. Enter the amount of TFT you want to bridge.
  11. Click on Withdraw.
  12. Follow the instructions on your Metamask Wallet.

General Tips

  • It's a good idea to start with a small amount the first time.
  • The process is usually quick, but it can take up to 48h. In doubt, contact TF Support.
  • Going from Stellar to BSC costs 100 TFT.
  • Going from BSC to Stellar costs 1 TFT.
  • There is also fixed fee of 0.01 TFT when using the Stellar Blockchain.
  • Gas fees on BSC is usually around 5-20 gwei.
  • You can try the bridge later if gas fees are high at the moment of your transaction.

How to Set Up TFT on Metamask

To set up ThreeFold token (TFT) on Metamask, you can follow those simple steps:

  • Download Metamask here. Then, install the Metamask extension in your local browser.
  • Create a Metamask account
  • Switch the network to Binance chain . You will have to create a new network with following information):
    • Mainnet
    • Network Name: Smart Chain
    • New RPC URL: https://bsc-dataseed.binance.org/
    • ChainID: 56
    • Symbol: BNB
    • Block Explorer URL: https://bscscan.com
  • Add TFT token in Metamask
    • go to custom token
    • write the following contract address: 0x8f0FB159380176D324542b3a7933F0C2Fd0c2bbf.

How to set up a Stellar address for TFT transactions?

In general, to set up a Stellar address to transact TFT on Stellar chain, you can use any Stellar wallet that has a TFT trustline enabled. Note that on Stellar chain, fees are paid in XLM.

The easiest way is to simply create an account on the ThreeFold Connect App (for Android and iOS) and to then use the TFT wallet of the app, which has by default a TFT trustline on Stellar chain and also comes with 1 XLM sponsored by ThreeFold for transaction fees.

How long does it take when you use the BSC-Stellar Bridge?

The bridge will process deposits/withdrawals within 48 hours.

What are the cost when bridging from Stellar to MetaMask (BSC) and from MetaMask to Stellar?

It will cost 100 TFT for the former, and 1 TFT for the latter. There is a fixed fee of 0.01 TFT when using the Stellar blockchain. Those fees are taken from the total of what you are bridging. For example, if you Bridge 200 TFT, from Stellar to MetaMask (BSC), you will receive 100 TFT.

What is the network information to access BSC for the ThreeFold token? What is the token address for adding the token in the MetaMask app?

Here it is:

  • Mainnet
  • Network Name: Smart Chain
  • New RPC URL: https://bsc-dataseed.binance.org/
  • ChainID: 56
  • Symbol: BNB
  • Block Explorer URL: https://bscscan.com

BSC TFT Token Address: 0x8f0FB159380176D324542b3a7933F0C2Fd0c2bbf

For more information, read this.

How can I trade TFT on Pancake Swap? How can I add TFT on Pancake Swap?

When searching for a Token on Pancake Swap (Select a Token), paste the TFT Token Address : 0x8f0FB159380176D324542b3a7933F0C2Fd0c2bbf, then select TFT. You can now trade TFT on Binance Smart Chain.

How can I swap ThreeFold tokens (TFT) on Stellar Blockchain?

It is possible to swap TFT on Stellar Chain. Here's how to do it with StellarX.

First, make sure your wallet has a TFT trustline. Second, go on StellarX Swap section. Third, choose TFT and the other token of the swapping pair then swap. If you do not see TFT, make sure you have a TFT trustline linked to your wallet.

On my website, users can donate TFT on the Stellar Chain. Is there a way for users on my website to easily track the total sum of TFT donated?

There is a simple way to do this. The Stellar Explorer has an embeddable widget that you can insert on any website, including WordPress.

Simply go to the account you’re interested in showing the balance of, look for “Balance History”, select TFT, and finally click the small icon next to the heading to reveal the embed code. In your WordPress page editor, in HTML mode, paste the embed code.

How can I use the TFT Stellar-Ethereum bridge?

When you go to the TFT Stellar-Ethereum bridge website, connect your Ethereum wallet. Then the bridge will present a QR code which you scan with your Stellar wallet. This will populate a transaction with the bridge wallet as the destination and an encoded form of your Ethereum address as the memo. The bridge will scan the transaction, decode the Ethereum wallet address, and deliver newly minted TFT on Ethereum, minus the bridge fees.

For the reverse operation, going from Ethereum to Stellar, there is a smart contract interaction that burns TFT on Ethereum while embedding your Stellar wallet address. The bridge will scan that transaction and release TFT from its vault wallet to the specified Stellar address, again minus the bridge fees.

What is the contract address for TFT on Ethereum?

The contract address for TFT on Ethereum is the following: 0x395E925834996e558bdeC77CD648435d620AfB5b.

You can see it on Etherscan here.

TF Connect App, TF Dashboard, GraphQL, Grix Proxy and Polkadot Substrate

ThreeFold Connect App (TF Connect App) is available for download on Android and on iOS.

To go on the ThreeFold Dashboard, use this link https://dashboard.grid.tf/.

The link to the Polkadot Extension is the following: https://polkadot.js.org/extension/.

Polkadot.js is available for the following browsers: Chrome, Brave and Firefox. To install it on Brave, use the Chrome link.

Is there a way to create or import another wallet in TF Connect App?

The TF Connect App supports Stellar and TF Chain wallets. The app by default can create one wallet. To add any number of additional wallets, you must create a wallet on Stellar or TF Chain and then import it with the import function.

I created a farm on the TF Chain. On the TF Connect App Farmer Migration section, my farm is under Other v3 farms, is this normal?

Yes this is normal. Farms created on TF Chain instead of the TF Connect App will appear in Other v3 farms.

I am trying to access my wallet in the ThreeFold Connect App. It worked fine before, but now I just get a white screen. What does it mean and what can I do?

On the TF Connect App, when you get a white screen, it means that there is a connection issue. It can help to try other networks; maybe try switching between ethernet cable or wifi. Or you can also try it later when the connection might be more stable.

When I open the ThreeFold Connect App, I get the error: Error in initialization in Flagsmith. How can I fix this issue?

To fix this Flagsmith error message on the ThreeFold Connect app, you can try the following methods:

  • Check your internet connection
  • Update your phone current operating system (OS) version
  • Update the date and time on your phone

I have some problems connecting to the Polkadot extension. What can I do?

You could try to delete the cache in your browser or try to open it with another browser (Firefox/Brave/Chrome). Sometimes, removing the account and re-entering the seed phrase can also help to fix some issues. Use your seed phrase carefully.

If you have issues on Firefox, refreshing the browser can help.

Apart form the ThreeFold Connect App Wallet, how can I check my TFT balance?

You can go on Stellar.Expert. With your wallet address, you will be able to see your transactions and wallet details.

Is it possible to export the transaction history of a wallet to a CSV file?

Yes, every blockchain has an explorer function and these explorer functions allow you to see transactions and export them. TFT is on 2 chains at the moment: Stellar and Polkadot.

For Stellar based TFT’s there is an explorer here: https://stellar.expert/explorer/public. Enter you wallet address in the top left search box, and after pressing enter you should see every transaction related to your account.

If you are not deploying/doing things on the TF Grid (dev, test or mainnet) you will not have transferred any tokens to the TF Chain, therefore all your tokens/wallets will be on the Stellar Chain.

What is the role of the middleware?

The middleware takes data from the TF blockchain and present it in a searchable manner.

What is Polkadot UI? What can I do with Polkadot UI?

It is based on substrate, a framework for building blockchains in the polkadot ecosystem

You can use polkadot UI to querry information about farms on TF Chain.

For example, on Polkadot UI, you can see blocks minted on TF Chain. Have a look here.

The links are the following for the different ThreeFold networks:

  • Main net
    • Endpoint: wss://tfchain.grid.tf
  • Test net
    • Endpoint: wss://tfchain.test.grid.tf
  • Dev net
    • Endpoint: wss://tfchain.dev.grid.tf
  • QA net
    • Endpoint: wss://tfchain.qa.grid.tf

How can I use GraphQl to find information on the ThreeFold Grid?

To find information on the ThreeFold Grid with GraphQL, go to this link. On the left menu, choose the parameters you want to search and write the necessary information, if needed, then click on the Play button in the middle section, at the top.

Here's an example of a query, where we want to find all the farms containing "duck" in their name.

query MyQuery { farms(where: {name_contains: "duck"}) { name farmID } }

This code can be written automatically if you simply select the proper parameters in the left menu. For the previous example, we had to click on "farms", then "where", and then "name_contains". After clicking on "name_contains", you need to add the words you are looking for, in this example we had "duck". Further down the menu, we simply had to click on "farmID" and "name", and then click the Play button. The results of the query appear on the right screen.

The links for the Development, Test and Main Networks are the following:

How can I find 3Nodes with IPv6 addresses?

You can use GraphQL for such queries.

Use the following code to search for 3Nodes with IPv6 addresses. Enter the following code on the middle window and click on the "Play" button.

query MyQuery {
  publicConfigs {
    node {

The 3nodes with IPv6 addresses will appear on the right window.

For more information on how to use Graph QL, read this Q&A.

How can I use GraphQL to see contracts on my 3Nodes?

Go to ThreeFold's GraphQL and write the following query:

query MyQuery {
  nodeContracts(where: {state_eq: Created, nodeID_eq: 42}) {
    resourcesUsed {

This will show you contracts on the 3Node as well as resources used. You can play with the different parameters.

How can I see the farm associated with a node?

query MyQuery {
  nodes(where: {nodeID_eq: 57}) {

How can I use Grid Proxy to find information on the ThreeFold Grid and 3Nodes?

To find information on the ThreeFold Grid with GraphQL, you need to write this URL: https://gridproxy.grid.tf/, followed by your specific query. Here's an example if we wanted to see all the available farm on the TF Grid that has "duck" in its name:


The Grid Proxy is appropriate for high volume application. You can find the parameters to be written in the URL when visiting the GraphQL explorer.

Who is hosting GraphQL and Grid Proxy on the ThreeFold Grid?

GraphQL and Grid Proxy are hosted by ThreeFold for everyone to use.

Note that it is also possible to run your own instance of those tools.

What is the difference between uptime, status and power state?

There are three distinctly named endpoints or fields that exist in the back end systems:

  • Uptime
    • number of seconds the node was up, as of it's last uptime report. This is the same on GraphQL and Grid Proxy.
  • Status
    • this is a field that only exists on the Grid Proxy, which corresponds to whether the node sent an uptime report within the last 40 minutes.
  • Power state
    • this is a field that only exists on GraphQL, and it's the self reported power state of the node. This only goes to "down" if the node shut itself down at request of the Farmerbot.

I do not remember the name (ThreeFold 3bot ID) associated with my seed phrase on the ThreeFold Connect app. Can I recover my TF Connect app account with only the seed phrase and not the name (3bot ID) associated with it?

If you forgot the name associated with your seed phrase on the TF Connect app, you can always create a new identity (ThreeFold 3bot ID) and import your wallet using the old seed phrase.

Since the Connect App is also used for identity and authentication, you need both the name (3bot ID) and seed phrase to fully recover your account. The wallet is only linked to the seed phrase and not the name (3bot ID).

My twin is associated with a polkadot.js extension account and I do not have the mnemonics, can I set the Farmerbot anyway?

This is possible if your exported JSON lists ed25519 under encoding. If it lists sr25519, it is not possible.

For ed25519, you will need to extract the hex secret.

That being said, if you do not have your mnemonics for your polkadot.js extension account, the simplest way forward is to create a new polkadot.js account and generate a new twin. Then you will need to create a new farm and migrate the existing nodes to the new twin and farm. This is actually very simple: when you boot your new bootstrap image of the new farm, your node will move to the new farm, with its current node ID.

If you are using the Farmerbot, at this point, you will be able to set it with the mnemonics associated with the new farm.

How can I vote for a ThreeFold DAO proposal?

Go to the ThreeFold Dashboard. In the menu on the left, select Portal and then select DAO. Then vote for the DAO proposal you are interested in.

Note that you need a farm with at least one active 3Node to vote.



TF Grid Functionalities

How can I filter 3Nodes by country and by network (IPv4, IPv6 and Planetary Network)?

You can use the official Dashboard Explorer. There are also wonderful tools built by people from the ThreeFold community.

Yes. It’s https://play.grid.tf.

What can I do on ThreeFold Grid?

Since ThreeFold 3Nodes have their OS based on the Linux kernel, you can run just about anything that runs on Linux. The possibilities are almost endless. Here's a quick list of what you can do within a few clicks:

When you take into consideration that with CapRover only, you get dozens and dozens of free and open source one-click applications, from Wordpress to Ruby, you realize the fun ahead.

Is there delegated staking for TFT?

Delegated staking is a feature that will soon be implement. Stay tuned.

What are the type of storage available on TF Grid?

There’s two type of storage that van de used on the TF Grid.

  1. VM which has a virtual disk. The virtual disk is a straightforward volume on a local hard disk. Everything stored on this virtual disk is stored only on this virtual (and thus physical) disk. Delete the VM and the virtual disk and the content is gone.
  2. Quantum safe storage. Quantum safe storage uses a “Storage Engine” that parts, compresses, encrypts and then mathematically describes the data.

What is ThreeFold's cloud pricing? Are there any discounts available for ThreeFold's cloud pricing?

You can read more about ThreeFold cloud pricing and discounts here.

By simply hodling TFT in your TF Chain wallet, you can benefit from TFT discounts up to 60%. This is an automatic form of staking, the user does not have to do anything to have this benefit.

How can I see the available capacity of a 3Node server on the ThreeFold Grid?

You can use the ThreeFold Grid Proxy to see available capacity of a 3Node server.

What is the difference between the Playground and Dashboard on mainnet and testnet?

In general, mainnet is more stable and it is better to use it for official workload deployments. Mainnet and testnet offer the same features, but testnet costs 50% less TFT to run workload.

Deployments on the ThreeFold Grid

Can I use the TFChain secret on the ThreeFold Connect App for the Profile settings on the ThreeFold Playground?

No, this is not possible. The twin created in the farming section of the TF Connect app is not directly associated with the mnemonics from the ThreeFold Playground.

To generate the seed phrase, you can go to the ThreeFold Dashboard. You will be able to install the Polkadot extension, create an account within it (keep the seed phrase safe), then activate a twin for that account on the ThreeFold Dashboard.

You will then be able to use the seed phrase to create a profile manager.

Does the ThreeFold Grid charge the total resources rented or it only charges the resources used during deployment?

Billing is based on how many resources you reserve, not how much you use them. For this reason, it can be a good idea to deploy the minimim resources needed per project.

Do I pay for Internet traffic while deploying workloads on IPv4, IPv6 or Planetary Network?

You do pay for internet traffic while deploying on the ThreeFold Grid. It is calculated during deployment and paid with ThreeFold tokens (TFT).

Note that the private overlay network traffic is not billed.

What is the monthly cost for an IPv4 or an IPv6 public address on the ThreeFold Grid?

The cost for an IPv4 public address is around 3$/month (USD).

For an IPv6 address, there is no cost.

What are the differences between a container, a micro virtual machine and a full virtual machine (VM)?

The following is a list of certain features related to containers as well as full and micro virtual machines.

  • Container
    • generally designed to run a single application
    • doesn't need to include a full operating system
    • relies on the kernel of the host system, no hypervisor needed
    • isolated from the rest of the host system for security and can be limited in resources used
    • examples: on the Playground, we have Kubernetes and Caprover, which are both environments that host containers
  • Micro VM
    • a container image promoted to run as a VM by pairing with a generic kernel
    • more isolated than a container, thus more secure
    • generally lighter than a full VM
    • can be created from any Docker container image by uploading it to the TF Hub
    • examples: on the Playground, we have Ubuntu 20.04, Alpine-3, CentOS-8 and more.
  • Full VM
    • contains a complete operating system including kernel
    • capable of anything that can be done with a Linux server
    • compatible with any guides and tutorials written for the same version of the distribution they are running
    • normally contains systemd, unlike containers which normally do not
    • can load kernel modules or replace the kernel entirely, so has best compatibility
    • generally heavier than micro VM
    • examples: on the Playground, we have Ubuntu 18.04, 20.04, 22.04 and more

Note that you can run Kubernetes on a micro VM and you can run a very minimal operating system in a full VM. There are many possibilities when using those technologies.

What is a 3Node gateway? How can I configure a 3Node as a gateway node?

A 3Node becomes a gateway when a ThreeFold farmer adds a public IP address to the node itself on the ThreeFold Dashboard. In doing so, the IP address is then handed over to the base operating system of the node itself. The IP address can then be used in the overall functions of the TF Grid.

Note that this process differs from when an IP address that has been added to a farm is deployed with a workload in order for that workload to be accessible on the Internet.

To configure a 3Node as a gateway node, you need a public IP block from your internet service provider (ISP).

You can configure a 3Node as a gateway node on the TF mainnet, TF testnet and TF devnet. You thus need to choose the correct TF Dashboard link (main, test, dev).

To configure a 3Node as a gateway node, follow these steps:

  • Configure your DNS records
    • Type: A
      • Name: <YOUR_SUBDOMAIN>
      • Value: <YOUR_IPv4_ADDRESS>
    • Type: NS
      • Name: _acme-challenge.<YOUR_SUBDOMAIN>
    • Type: CNAME
      • Value: <YOUR_SUBDOMAIN>
    • Type: AAAA
      • Name: <YOUR_SUBDOMAIN>
      • Value: <YOUR_IPv6_ADDRESS>
  • Configure your 3Node parameters on the TF Dashboard
    • Go to the ThreeFold Dashboard
    • Go to the section Portal
    • Go to the subsection Farms
    • Choose the 3Node you want to turn into a gateway node and click on Actions (Add a public config) on the right
    • Enter the necessary information and click Save
      • IPV4: Enter the IPv4 address of your public IP block
      • Gateway: Enter the gateway of your public IP block
      • IPV6: Enter the IPv6 address of your public IP block
      • Gateway IPV6: Enter the gateway of your public IP block

Once this is done, you should see the IPv4 and IPv6 addresses in the section PUB of your 3Node screen.

To learn more about this process, watch this great video.

The gateways are advertised as many-to-many. How can I have more than one gateway assigned to a deployment? Can more gateways be added after deployment?

As of now, gateways are a simple one-to-one HTTPS proxy, one subdomain that comes from a gateway node. A domain points to one IP address.

It is currently in development, but gateways will be a simple reservation (name + hashed secret).

Connecting to gateways is done with a client tool (user needs to run this). More gateways can be added later (and client then connects to them). Webgw will be a layer 4 (TCP) proxy, so user process needs to do TLS termination. User will also need a domain name. Domain can be configured with multiple IP’s to support multiple gateways. Implementation itself will be functionally different from V2 gateways, but high lvl idea applies. This means name / domain reservation as they are now will become deprecated as we no longer support TLS termination on the gateway.

When connecting remotely with SSH, I get the following error: "WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!...". What can I do to fix this?

If you've already done an SSH connection on your computer, the issue is most probably that the "host key has just been changed". To fix this, try one of those two solutions:

  • Linux and MAC:
    • sudo rm ~/.ssh/known_hosts
  • Windows:
    • rm ~/.ssh/known_hosts

To be more specific, you can remove the probematic host:

  • Windows, Linux and MAC:
    • ssh-keygen -R <host>

Once this is done, you should be able to SSH into your 3Node deployment.

How can I remove one host from known_hosts?

You can write the following command

ssh-keygen -R hostname

Where hostname would be the IPv4 or IPv6 address for example. In the case of the ThreeFold Grid, it can also be the Planetary Network address.

How can I add ThreeFold peers in the Yggdrasil configuration file?

In the file /etc/yggdrasil.conf, write the following in the "Peers" section:

 Peers: [
    # Threefold Lochrist
    # GreenEdge

How can I see Yggdrasil/Planetary Network's peers?

On MAC and Linux, write the following line in the terminal:


On Windows, one of the two following lines should work:


These are the general location of Yggdrasil. It can change depending on how you installed Yggdrasil.

How can I ping an Yggdrasil IP or IPv6 address?

Usually, using the command ping works.

If the typical ping doesn't work, try this instead: ping6

For example, the following will send 2 pings:

ping6 -c 2 yggdrasil_address

Is there a way to test if I am properly connected to the Yggdrasil network (Planetary Network)?

To check if you are properly connected to the Yggdrasil network, try reaching this website:


If you can reach this website, it means that you are properly connected.

For more information on how to connect to Yggrasil (and the Planetary Network), read this guide.

How can I change the username of my SSH key?

In the terminal, write the following line:

ssh-keygen -C newname

Make sure to replace "newname" by the name you want.

How can I copy the clipboard content of a terminal output using the command cat? How can I copy the public key directly with the terminal?

We use here the example of copying the public key in the default folder of OpenSSL. You can use this command to copy any content of a given text file for Linux, Mac and Windows.

You can use the following terminal command line:

  • Linux
    • cat ~/.ssh/id_rsa.pub | xclip -sel clip
  • MAC
    • cat ~/.ssh/id_rsa.pub | pbcopy
  • Windows
    • cat ~/.ssh/id_rsa.pub | clip.exe 

After writing this command, your clipboard will contain your public key. You can paste it on the profile manager to connect with a 3Node when deploying on the ThreeFold Grid.

What is ThreeFold's stance on sharded workload? Will ThreeFold embrace and move towards distributed data chunks or stay with the one deployment, one node model?

The ThreeFold Grid is basically agnostic when it comes to how you structure your deployment.

If you want to put all your storage and compute on one node and lose everything if it goes down, you can do so.

If you want a highly distributed and fault tolerant system with high availability where data is never lost, you can also do so. You could build an architecture with single nodes running single workloads as the building blocks.

Containerized micro service architectures running on e.g. Kubernetes are basically the way that compute is being "sharded" already in the mainstream of IT, especially at large scales. Such applications fit well on the ThreeFold Grid today, since they account for the possibility that individual nodes may fail. However, many applications aren't built this way and it takes work to adapt them.

Self driving and self healing IT is one of the core concepts of ThreeFold. What we've built so far is an excellent foundation for making this reality. Some additional features might come into TF Chain and the network itself to enable such features. That being said, a lot is already possible using the existing system. It's just a matter of gluing things together in the right way.

Tutorials and Guides

What are the prerequisites before using the ThreeFold Play Grid (play.grid.tf)?

The prerequisites are simple:

  1. Go to the TF Dashboard Grid.
  2. Add the Polkadot Substrate Extension to your browser.
  3. Create an account (write down the mnemonics somewhere safe and offline).
  4. Buy TFT online. Go to GetTFT.com, where you can directly download the ThreeFold Connect App, and then fund your TF wallet with USD, EUR or BTC.
  5. Swap your TFT from Stellar Chain to TF Chain by using the swap function in the Portal menu of the Dashboard. (GetTFT sends TFT on Stellar Chain, while the Playground is on TF Chain.)
  6. Go to the ThreeFold Play Grid and start your deployment. (See next question to set a profile manager.)

How can I create a profile manager on the ThreeFold Playground?

You can create a profile manager on Testnet, Devnet and Mainnet. On the ThreeFold Play Grid, select the Profile Manager button on the top right of the screen and then select Create Profile Manager. For the detailed steps, read this documentation. To generate SSH keys, read the next question.

I want to deploy a virtual machine (VM) on ThreeFold. How can I do this?

Read this short documentation and you'll soon be exploring the virtual machine world!

How can I use Caprover on ThreeFold Grid?

Check this video and find out for yourself! If you want to, read the documentation with step-by-step guide for Caprover.

Is there a picture guide on how to deploy Wordpress on the ThreeFold Grid using Caprover?

We're glad you ask, Kristof wrote something you might really dig. Read it here!

I've heard rumours that you can install Wordpress and Discourse on the TF Grid in less than 15 minutes, is it true?

Oh yes it is. Legend has it, it can even be done under 10 minutes. Would you give it a try? Check this video.

Can I deploy a Presearch Node?

It is possible to deploy a Presearch node on the ThreeFold Grid. You can easily deploy a Presearch node on the ThreeFold Playground. Follow this link.

Note that each 3Node can deploy one Presearch node without the need of having a public IP. To deploy more than one Presearch node on a 3Node, you will need to select on the TF Grid a 3Node with a Public IP.

What is the minimum amount of TFT to deploy a Presearch node? How can I get a TFT discount when I deploy a Presearch node?

The minimum amount of TFT that needs to be in your ThreeFold Profile before you can deploy a Presearch node is 2 TFT. But this would not last very long.

To benefit from the biggest reduction in price (-60%), you need to have a sufficient amount of TFT in your wallet. The TFT is not locked and simply needs to be present in your wallet.

For the capacity of a Presearch node, the amount is around 5000 TFT, covering 3 years that the workload could run.

Note that a Presearch node requires about 3 days to stabilize.

How can I deploy Kubernetes on the ThreeFold Grid?

Read this documentation to find out.

How can I deploy Peertube on the ThreeFold Grid?

You can learn more about this here.

How can I deploy ownCloud on the ThreeFold Grid?

Read the documentation here to learn more.

How can I use and install Yggdrasil?

Learn all about this here.

You can also follow this link to download Yggdrasil for your specific operating systesm (.msi for Windows, .deb for Linux and .pkg for MAC).

How can I rent or reserve a 3Node dedicated node server on the ThreeFold Grid? What are the main steps when deploying workloads on a dedicated node?

In short, you first need to rent the dedicated node, then deploy on the TF Grid by selecting your dedicated node. It won’t cost anything more when you select your dedicated node.

  • Rent a dedicated node
    • go to the ThreeFold Dashboard
      • on the left menu: choose portal, then choose Dedicated Nodes
        • choose a node
          • rent it
            • take note of the node ID in the section "MINE"
  • Deploy workload(s) with a dedicated node
    • go to the ThreeFold Playground
      • choose a deployment
        • select your dedicated node ID in the filter (manual mode)
          • no additional TFT will be billed for the deployment
      • you can deploy other workloads, as long as you have enough resources on the dedicated node

For more information, read this TF Forum post.

How can I import my Polkadot account on the mainnet and the testnet?

To import your Polkadot account on mainnet, use those links:

  • https://dashboard.grid.tf/
  • https://play.grid.tf/

To import your Polkadot account on testnet, use those links:

  • https://dashboard.test.grid.tf/
  • https://play.test.grid.tf/

Exporting and importing your account through the Polkadot extension will allow you to transfer any TFT associated with the account, whether it is on testnet or mainnet.

Can I use the same seed phrase for my mainnet and testnest accounts? How can I transfer my TFT from mainnet to testnet or vice versa?

Yes, you can use the same seed phrase for you main and testnet accounts. They will have the same address on each chain but they are really separate accounts. It is much like using the same wallet on Ethereum and BSC for example.

To transfer your TFT from mainnet to testnet or vice versa, you need to send your TFT to the Stellar chain first. Let's say you want to transfer TFT from the mainnet to the testnet. Here are the steps:

  • Open your mainnet profile on the mainnet Dashboard, on the left menu, choose Portal and then Swap. Click the button Withdraw. Send your TFTs from the mainnet address to your Stellar address.

  • Open your testnet profile on the testnet Dashboard, on the left menu, choose Portal and then Swap. Click the button Deposit. Send your TFTs from your Stellar address to the testnet address. You can use the QR code option to make the transfer.

To go from testnet to mainnet, simply use the URLs in the opposite order.

Note that the fees are of 1 TFT per transfer.

Can I recover my seed phrase?

This answer covers the ThreeFold Playground, the Polkadot.js extension and the ThreeFold Connect App.

You can recover your seed phrase from the ThreeFold Playground if you have your profile manager password. On the ThreeFold Playground, click on the top right button to open up your profile manager settings. Write your password, then click "Load Profiles". On the following screen, your seed phrase is under Mnemonics. Locate on the right of this line an "eye" button and click on it to make your seed phrase visible.

You can't recover the seed phrase from the Polkadot.js extension. On the Polkadot.js extension, you can only export and import private keys. In short, this allows you to move tokens but not to manage deployments through the ThreeFold Playground.

To recover your seed phrase on the ThreeFold Connect App, go to the Wallet section of the app and click on the encircled "i" button at the bottom right of the screen. Go to the Secrets subsection and click to see your Steller or TFChain secret.

Do I need a full or micro virtual machine (VM) when I run QSFS, quantum safe file system, on the ThreeFold Grid?

QSFS can be run on both a full virtual machine or a micro virtual machine (VM). The QSFS is a "mountable" object, like a disk. It's defined in its own block, then specified as a mount within a VM.

To deploy a load on the ThreeFold Grid, I need to generate SSH keys. How can I generate SSH keys on MAC, Linux or Windows?

There are many methods to generate SSH keys.

You can read this ThreeFold SSH Guide to learn more about the whole process.

What is the method to SSH into a 3Node on IPv4, IPv6 and the Planetary Network?

To SSH into a 3Node, find the IP address of your ThreeFold deployment and do the following on your local computer terminal (Command Prompt for Windows):

ssh root@Address_Deployment

To connect to the Planetary Network, download and install the ThreeFold Planetary Network Connector. Once it is installed, open up the connector and click "Connect". Before connecting to the Planetary Network, make sure to disconnect your VPN if you have one.

For more information on SSH Remote Connection, read this ThreeFold SSH Guide.

Linux, Github, Containers and More

Where should I start to learn more about Linux?

While the ThreeFold Manual would be a good place to learn about ThreeFold and how to deploy on the TF Grid, to learn specifically about Linux, a good place to start is the Linux website. There you will find many tutorials.

A general advice to learn Linux, and computers in general, is to develop the skill of finding answers by following your natural curiosity: most of the questions have been asked before and answers can be found through search engines.

Before doing any web search, you can use the resources already on hand in the terminal. For any command, you can try adding -h or --help for a brief description of what it does and to see some commonly used arguments. Typing man and then the command name will bring up a more detailed manual, assuming it exists and is installed (e.g. man sudo).

Some ThreeFold users also point out that using different AI and LLM can be very helpful in the process of learning Linux and computers in general.

How can I see if a package is installed on Linux?

You can use the following line to see if a package is installed:

dpkg -s <package_name>

How can I copy a file or a folder on terminal from one location to another on Linux?

You can use the following command to copy a file:

cp source destination

You can use the following command to copy a folder:

cp -R source destination

How can I clone a single branch of a repository on Github?

You can clone a single branch of a repository with the following line:

git clone --single-branch --branch branch_name https://github.com/GITHUB_ACCOUNT/REPOSITORY_NAME

How can I exit a container without stopping it?

You can do Ctrl+P then Ctrl+Q to exit a container without stopping it.

You can then check which containers are running with the following command:

docker ps

If the keyboard sequence doesn't work, you can try the following on a second terminal:

ps -ef | grep attach

Then, note the PID number of your container and write the following:

kill -9 <PID>

To return to the container's interactive shell, do the following

docker attach <name_of_container>

How can I start and run a container in detached mode?

To start and run the container in detached mode, simply add the -d option in the docker run command:

docker run -d <name_of_container>

How can I transfer a file from my computer to the virtual machine (VM) deployed on the ThreeFold Grid? How can I do SSH file transfer from Remote to Local and vice versa?

You can use scp in the terminal to achieve this:

scp -r folder root@Address_Deployment:/PATH

On Linux, how can I see the resources being used on my server?

You can use the command top or htop in the terminal to see resources being used.

In Vlang, how can I format my code?

To format automatically the code with Vlang, write the following:

v fmt -w file_name.v

Grace Period (Status Paused)

The status of my deployment is paused, in grace period, how can I resume the deployment?

When your wallet is running out of TFT to pay for deployments, your deployments will be paused. To resume your deployments, simply fill up your wallet with more TFT.

Once I refund my TF wallet, how long does it take for the deployment to resume from grace period?

It can take around one hour to change the status from "paused" to "ok" and thus for the deployment to resume.

Can I SSH into my deployments when they are in grace period (i.e. when their status is paused)?

While in grace period, you might not be able to SSH into your deployment. Refund your wallet to resume deployments.

How long is the grace period (i.e. when the deployment status is paused)?

The grace period is 2 weeks. During this period, you can refill your wallet to resume your deployment.


Working with Terraform, I get the following error: failed to create contract: ContractIsNotUnique. Is there a fix to this issue?

This error happens when a contract with the same data is already active. For example, two conflicting contracts are not in the same deployment. You can try to change the data on the main.tf file to make sure it's not a self-conflicting terraform deployment.

I am working with Terraform. What do I have to write in the file env.tfvars?

This env.tfvars should look like the following, with the proper content within the quotes:

MNEMONICS = "write your seed phrase"

NETWORK = "write the main network"

SSH_KEY = "write your ssh-key"

Note that this could change based on your specific Terraform deployment.

I am working with Terraform and I am using the example in Terraform Provider Grid. How can I use the example main.tf file with environment variables? Why am I getting the message Error: account not found, when deploying with Terraform?

This Q&A is linked with the main.tf file in the QSFS section of the ThreeFold Tech repository.

This error happens when you did not properly set your environment variables. In the main.tf file, add those lines at the top:

variable "MNEMONICS" {

type = string

description = "The mnemonic phrase used to generate the seed for the node."


variable "NETWORK" {

type = string

default = "main"

description = "The network to connect the node to."


variable "SSH_KEY" {

type = string


Within the file main.tf, set those lines:

provider "grid" {

mnemonics = "${var.MNEMONICS}"

network = "${var.NETWORK}"


env_vars = {

SSH_KEY = "${var.SSH_KEY}"


Note: Make sure that you properly set your variables in the file env.tfvars.

Is there a command line tool for Terraform when deploying on the ThreeFold Grid?

There is a command line tool for Terraform built by a community member.

Have a look at this forum post to learn more.

The tool has the following options:

  1. Install Terraform
  2. Generate a main.tf
  3. Generate an env.tfvars
  4. Modify an existing example main.tf for deployment with env.tfvars file.

Users Troubleshooting and Error Messages

When deploying a virtual machine (VM) on the ThreeFold Grid, I get the following message after trying a full system update and upgrade: GRUB failed to install to the following devices... Is there a fix to this issue?

When deploying a virtual machine and doing a full system update and upgrade (apt update, apt upgrade), if you get the error: GRUB failed to install to the following devices /dev/vda15, try this to fix it:

apt-mark hold grub-efi-amd64-signed

This should fix the issue.

I tried exporting my account to another computer but my password doesn't activate my profile manager on the ThreeFold Playground. What should I do?

Your Playground profile is stored in the local browser storage, so it won't show up on a different computer with the same password. Instead, simply recreate the profile, using your seed phrase, and it will populate all information about your deployments on the different computer.

While deploying on the TF Playground, I get the following error :"global workload with the same name exists: conflict". What can I do to fix this issue?

This error happens if you deployed a workload on the TF Playground with the same deployment name of a previous deployment. In general, you can simply refresh the TF Playground browser page and/or change the deployment name for a new one. This should fix the issue.

How can I set the relay on the TF Dashboard?

To set the relay on the TF Dashboard, follow those steps:

  • Go to the TF Dashboard.
  • Select the account which needs to have the relay set.
  • In the menu, select Portal and then Twin.
  • Under Twin Details, if Relay is set to null, click on Edit.
  • Select the relay relay.grid.tf then click Submit.
  • Enter your password and sign the transaction.

Note that if you are using the TF Playground and the twin doesn't have the relay set, the TF Playground will set the relay automatically.

When I paste the SSH public key in the Profile Manager window, the SSH public key isn't accepted and it either doesn't stay in the window, or it gets removed and the older SSH public key reappear. What can I do to fix this?

This issue is usually happening when the SSH public key isn't in the proper format.

The less technical fix is to take your SSH public key and paste it in a browser's URL search bar, then recopy and paste it in the Profile Manager. This should give the proper format to the SSH public key.

Also, you can simply query the SSH public key in your terminal/command prompt with the proper format with a command like this:

cat ~/.ssh/id_rsa.pub

You can also refer to this question for a direct way to obtain your SSH public key in your clipboard.

When I try to add my mnemonics in the ThreeFold Playground's profile manager, I get the error: "Unable to connect due to Maximum number of attempts exceeded". How can I fix this?

A quick fix to this is to simply add a space at the end of the mnemonics and then to delete the mnemonics. Then you should be able to rewrite the mnemonics.

ThreeFold Connect App

TF Connect App is now asking for a 4-digit password (PIN). I don't remember it as I usually use touch or face ID to unlock the app. What can I do?

When you set up your the app, you are asked a 4-digit password (PIN). After some time, the app will be asking for this PIN when users may have been exclusively using touch/face ID. You can reset it by recovering the account with your seedphrase.

Is there a way to have more than one wallet in TF Connect App?

Yes, this is perfectly possible. You can have multiple wallets in the TF Connect app. You can have multiple wallets for the Stellar network and multiple wallets for Polkadot Substrate.

For example, you can create a wallet on the Stellar Blockchain and import it on TF Connect App with the function Import Wallet. Just copy the seedphrase and it will be imported in TF Connect App.

Note: There will not be an automatic function in the app to create a new wallet. You must do it manually.

What is the difference between 10.x.y.z and 192.168.x.y addresses?

The addresses 10.x.y.z and 192.168.x.y are on the private network.

A 10.x.y.z address is just as valid as a 192.168.x.y address for a private network. If all the devices get a 10.x.y.z network, your private network should work properly. But if some of your devices are getting 10.x.y.z addresses while others are getting 192.168.x.y addresses, then you have two conflicting DHCP servers in your network.



General Information for Developer

How can I use Docker on the ThreeFold Grid?

There are many ways to use Docker on the ThreeFold Grid.

You can simply run Docker in a virtual machine (Full VM and Micro VM) and then follow any instructions made for Docker.

Since the ThreeFold Hub has a Docker to flist converter, you can also convert the Docker image to an flist and run it directly as a micro VM.

Note that you can also run Docker in Kubernetes.

Can I convert an existing docker into an flist?

Yes you can. Go on this link and you will be able to convert a docker into an flist.

How does a FList work?

In a flist, we separate the metadata from the data. The metadata is a description of what files are in that particular image. It's the data providing information about the app/software. Thanks to flist, the 3Node doesn't need to install a complete software program in order to run properly. Only the necessary files are installed. Zero-OS can read the metadata of a container and only download and execute the necessary binaries and applications to run the workload, when it is necessary.

For more information, check this TF video.

What is stored in the metadata of a software?

The metadata stores information such as: location, properties, ownership, rights, etc.

What is the ratio between the metadata and the actual files on a container?

Metadata is usually less than 5% of the container. The rest (95%+) is the actual files (binaries, applications).

Does Zero-OS assign private IPv4 addresses to workloads?

No. Zero-OS will request two IP address from the DHCP. If you only have one physical NIC connected, Zero-OS will assign the second IP address as a virtual device.

Why does each 3Node server have two IP addresses associated with it?

Each node has two IP adresses.

One is for for Zero-OS and one is for for the DMZ (demilitarized zone, sometimes referred to as a perimeter network or screened subnet). This separates public/private traffic from each other.

Note: Zero-OS will request two IP address from the DHCP. If you only have one physical NIC connected, Zero-OS will assign the second IP address as a virtual device.

Can Zero-OS assign public IPv4 or IPv6 addresses to workloads?

Yes it can provide both standard and Yggdrasil connections.

What is Yggdrasil?

Yggdrasil is an "overlay network implementation of a new routing scheme for mesh networks".

What does MAC mean when it comes to networking?

MAC means media access control. It is a unique hardware ID. It helps the network to recognize your machine. It is then, for example, possible to assign a specific and fixed IP address to your hardware.

I am a developer looking for a way to automatically convert BSC tokens into TFT. Could you please share tips on how to swap regular tokens into TFT, on backend, without and browser extensions, via any platform API?

TFT is implemented as a cross-chain asset (BToken) on BSC.

Swapping via Pancakeswap directly without a browser and extension can be done by calling the Pancakeswap's BSC contract directly. Note that this requires some EVM knowledge on calling contracts.

TFT is a standard ERC-20 contract, called BEP20 on BSC. You will thus need to call the approved method in the TFT contract to allow Pancakeswap to transfer TFTs from your account.

The TFT contract allows you to approve a large amount and when Pancakeswap makes the transfer, the TFT will be deducted from the transaction. This will not reset so you will not have to make a call to approve every swap. This will thus save some gas.

Dev Net & Test Net

Is there a way to test the Grid with free TFT?

You can get free TFT on the Dev Net, but note that these are not real TFTs. They are simply there for people to try and explore the Grid.

Can I get some free TFT to test on Test Net

The TFT on Test Net is real TFT. There are ways to get free TFT to explore Test Net, such as joining the Beta Tester Group. More information here.

I want to test the Grid, is there a Grid Tester Community to reach out TF testers?

Of course! And they'll be happy to help you. Reach the TF community on Telegram and explore the New Internet.

Solution Providers and Sales Channels

What does it mean to be a solution provider on the ThreeFold Grid?

A solution provider offers a solution on the ThreeFold Grid and receives up to 50% of the TFT utilization revenues from the workload related to the solution.

A "solution" is something running on the grid, created by a community member. This can be brought forward to the council, who can vote on it to recognize it as a solution. On contract creation, a recognized solution can be referenced, in which case part of the payment goes toward the address coupled to the solution.

To become a solution provider, read the next question.

How can I become a solution provider on top of the ThreeFold Grid?

ThreeFold uses the Proof-of-Utilization distribution where up to 50% of the TFT utilization revenues goes to the solution provider offering a solution. If there is no solution provider associated with the deployment, the 50% revenues goes to a DAO owned Community Grant Wallet.

There are a few steps to follow to become a solution provider:

  1. Follow the steps detailed in this documentation

  2. Then write a ThreeFold Forum post explaining what the solution provider does

  3. Once the two first steps are done, a DAO proposal will be launched to decide if the solution is approved

What is the relation between a solution provider and a sales channel?

Those two concepts are closely linked.

On a technical level, the solution provider and the sales channel constitute a simple mechanism whereby up to 50% of the TFT spent on a deployment can be redirected to another wallet. The object in TF Chain that makes this possible, by linking the deployment contract and the wallet to be paid, is called a “solution provider”. This on-chain concept is thus called a solution provider, but it enables both solution providers and sales channels.

How can I receive a solution provider ID?

To receive a solution provider ID, you need to get approved as a solution provider.



General Information of Validator

What are Validators?

A blockchain validator participates in consensus and maintains the record of transactions. Once transactions are verified. Validators are computers that maintain the blockchain's integrity by keeping a record of the whole transaction history, from the first block to the last.

In Proof-of-Stake (PoS) systems like ThreeFold L0 and L2 validators are given rewards as long as they stake ThreeFold Tokens (TFT) and correctly participate in the network. This mechanism helps secure the network by imposing the need to lock up TFT in order to participate in the consensus decisions.

Why are Validators important for ThreeFold?

Validators are an essential part of the Proof-of-Stake consensus mechanism. They are essentially the moderators of the staking system and have the extremely important responsibility of authoring new blocks on the chain. To have the most decentralized system possible, ThreeFold needs a good number of validator nodes that can be elected. That’s the primary reason why we limited the amount of validators one person or entity can hold to 1.

This creates the greatest variety of staking options for the community and also protects the system by preventing the chain from being controlled by one very wealthy individual. When there are more people validating the blockchain, it significantly increases the barrier to being elected and allows for a fairer ecosystem to emerge.

Can anyone run a validator node?

Validator nodes can be run by anyone with hardware that meets the minimum requirements (4TB of storage, 32GB of RAM and 4 logical cores). Once the blockchain is set up on the hardware, all the verifications and voting is done on a web portal, a seamless process accessible to anyone. However, it is important to remember that if a validator fails to uphold their responsibilities, a portion of their stake will be slashed (fined), as such an event would impact the resilience and security of the network.

The responsibility of a validator (owner) can be summarized to:

  • Actively participating in the governance of the network the validator protects
  • Producing blocks (requires the node to be online 24/7 to sync with the latest blocks)
  • Validator owners are expected to be active members of the community and must always be up-to-date with the current state of the ecosystem, so that they can easily adapt to any changes.

What are the rewards?

To justify the running costs of the node as well as to gather a suitable income from supporting the blockchain, validator nodes earn rewards, see here for L2 validators, and here for L0 validators.

How many validator nodes will there be?

The amount of validators depends on type of validator. While there is a maximum of 100 validators for L2 (ThreeFold Hub), there will be max 100 L0 validators per sidechain of TFGrid. There will be many sidechains on the TF Grid.

What’s the difference between L2 and L0?

Our three layer blockchain approach provides for unlimited scale and security.

Layer 2 is the top layer of our ThreeFold ecosystem, also called ThreeFold HUB. It’s a Cosmos-based blockchain that is secured by L2 validators.

Layer 0 is the foundational layer of our ThreeFold ecosystem, also called ThreeFold Operators. It’s a network of validator node operators that secure the operating system layer of the ThreeFold Grid.

What are the rewards for L0 and L2 validators?

During the 2 first years, 5% yield will be rewarded to any staker. 10% of revenue of executors on the sidechain go to people staking L0. 5% of revenue of executors on the sidechain go to people staking L2.

10% will be deducted if you did delegated staking. In other words, if you do not own the validator node. This 10% is commission for the owner of the validator node.

For more information, read this.

What is the current status on the validator and staking solution? Is there anything coming soon?

We expect validators to arrive in the first half of the year 2023 (H1 of 2023).

Validator Requirements

What are the general requirements?

  • Reliable electricity. Either the electricity is always on or the validator owner takes precautions to put his/her node in a data center or invests in a UPS.
  • Bandwidth > 50Mbit/s continuous connection. The higher the bandwidth, the better the validator can participate in the network.
  • A 24/7 connection.

What are the hardware requirements to run a validator node?

The hardware requirements to run a validator node are the following:

  • 4TB of SSD Storage (good quality SSD)
  • 32 GB of RAM
  • 4 physical cores

Note that you can deploy a validator node on any 3Node on the ThreeFold Grid that satisfies those requirements. This means that you can also run a validator node on your own 3Node if the requirements are satisfied.

Can I run more than one validator node?

You can only have one validator node in each validator category.

Does this mean you only really need 50 000 TFT to run a validator node?

Yes, for 50k TFT you can reserve a validator node for L0 Chain securing the TF Executors. An additional 50k, which can come from anyone, will be enough to get rewards and voting power.

Thus, you need 50k TFT to reserver a validator, and 50k TFT to activate rewards and voting power.

If validator is running on Grid and the host shutdowns the machine, could stakers lose staking tokens?

No, you would not lose staked tokens, but there could be an impact on reward for the time you were off.

What happens if my validator is down for a while?

The technical implementation is not finished yet, we use Cosmos blockchain for this, we will check the more technical details, normally a node can be offline for quite a while before there are issues.

Could we run validator on our farming machine?

Yes you can, you can run validators wherever you want. You can deploy manually (using code) or through a weblet on a location of your choice.

Application to run a Validator Node

When will verification of the validators' applications start?

Starting February 21, 2022

The Foundation will begin with verifying the applications:

  • Submitted validator requests will be vetted and checked on an individual basis
  • Submitted wallets will be checked on for the respective minimum TFT balance (for amount of TFT required see: L2, L0.
  • Submitted individuals / companies will be asked if they have more than one validator request. This request will be recorded.

What are the next steps after the validator sign-up?

After successfully completing the validation process, validator owners will be asked for their preferred way to deploy the validator. There are two options:

  • On the ThreeFold Grid with a simple weblet.
  • On bare metal that is owned and managed by the validator owner.

If you haven’t topped up your account, please do so now to meet the minimum amount of TFT required.

Once verified, the new validated sign-ups will receive an instructional link to their verified emails to activate their validator.

If you have further questions, please let us know in the comments and we'll get back to you as soon as possible.

We're looking forward to driving the expansion and decentralization of the ThreeFold Grid with all of you!



TFT Farming Basics

How can I create a ThreeFold farm?

There are two ways to create a ThreeFold farm.

You can install the ThreeFold Connect App, set an account and then create a farm in the section Farming.

You can also create a ThreeFold farm on the ThreeFold Dashboard after having created an account on the Polkadot extension.

My Titan is v2.1 and the ThreeFold Grid is v3., what is the distinction?

Titan v2.1 is the hardware. Before v2.1, there was 2.0. The hardware currently being shipped is the Titan v2.1.

When you read v3, it refers to the ThreeFold Grid. Titans are now being sent ready for TF Grid v3 so they are being referred to as Titan v3. In short, the current Titans are v2.1 hardware ready for ThreeFold Grid v3.

Is there a way to know the current TFT price for the farming rewards?

Yes! Go here and scroll down, you'll be able to find the TFT price at the line: current TFT to USD price.

When will I receive the farming rewards for my 3Nodes?

Farming rewards are usually sent around the 8th of each month. This can vary slightly because the verification process is not yet fully automated.

For more information on the minting process, read the next QnA.

What is the TFT minting process? Is it fully automated?

Minting is based on blockchain data according to strict rules that are carried out by computers with humans involved only to check for errors and to sign the resulting transactions.

There is a human verification mechanism through multisignatures for calculations done on the data as stored in the blockchain. This explains the timing differences when it comes to the monthly farming rewards distribution, since enough people need to sign off.

The detailed minting process for V3 is as follow:

  • TFChain, ThreeFold's blockchain, has all the details about capacity provided by the nodes.
  • TFChain is used to track uptime.
  • Zero-OS reports to TFChain.
  • The code in this repo uses the information from the blockchain to calculate the TFT to be minted.
  • A proof of what needs to be minted and why is created. This proof is then sent to our guardians.
  • The guardians need to double check the execution and the minting report. This is like a human check on the automated process.
  • The guardians need to sign. Only when consensus is achieved the minting as suggested will happen. This allows human to check the code.

It is important to understant that TFChain tracks the capacity and uptime and is the source for the minting.

Note: Additional auditing code will be added in V4 (i.e. special code generated at runtime for verification) using security primitives on motherboards.

For more information on the minting periods, read this QnA.

What should I do if I did not receive my farming rewards this month?

If you did not receive your farming rewards, please contact us via our live chats. We will then investigate the situation.

You can find our live chat option on the TF Connect App (Android, iOS), the TF Forum, TF Dashboard and the TF website. For the TF Connect app, select the Support option. For the other websites, it is a blue icon on the right bottom part of the page.

The easiest way to contact the ThreeFold support is to use this link and click on the chat icon.

Is there a ThreeFold simulator to calculate farming rewards?

Of course! Go to the ThreeFold Simulator and select DIY or Titan.

What is the TFT entry price of my 3Node farming rewards?

Currently, the TFT entry price of the 3Nodes' farming rewards is 8 cents (0.08 USD).

What is the necessary uptime for a 3Node per period of one month?

Note that as of now, rewards are proportional to the uptime, so (e.g.) 40% uptime farms 40% of the total uptime period.

When implemented : For certified Titans 3Nodes, it is 97% uptime per month (21.6h). For DIY 3Nodes, it is 95% uptime per month (36h). For professional certified 3 nodes, it is 99.5% uptime per month (3.6h).

How can I check the uptime of my 3Nodes? Is there a tool to check the uptime of 3Node servers on the ThreeFold Grid?

You can go on the ThreeFold Dashboard, and select "Farms" in the Portal menu. When you select a specific 3Node in your farm, you can see a visual graph of the 3Node's uptime of the last month. By clicking on "Node Statistics", you can see past and present uptime periods.

I set up a 3Node in the middle of the month, does it affect uptime requirements and rewards?

You will still need to meet the required uptime (95% for DIY, etc.3), but the period starts when you connected the 3Node for the first time, instead of the usual start of the month. This only applies the first month. Afterwards, the uptime is calculated on the whole month. *Read last Q+A

What is the difference between a certified and a non-certified 3Node?

A certified 3Node will receive 25% more reward compared to a non-certified 3Node. You can visit the ThreeFold Marketplace for more information on certified 3Nodes. DIY certified 3Nodes are a future possibility.

What are the different certifications available for 3Node servers and farms? What are the Gold and Silver certifications?

3Nodes can be certified. You can buy certified 3Nodes here.

Farms can also be certified. The certifications are: gold certified farming and silver certified farming.

Note that gold and silver certifications are still being discussed. Join the discussion on the ThreeFold Forum.

What is the difference between V2 and V3 minting?

V2 is being sunset. New miners should directly onboard to V3. On the tokenomics side, V2 rewards decrease as the difficulty level increases. For the V3 rewards, the rewards are constant for 5 years. In short, V3 is more profitable in the long run. For more information, read this post.

How long is the minting period of the tokens on ThreeFold? How long is the farming period?

Each period has: 2630880 seconds = 43848 minutes = 730.8 hours. For more info, read this.

What is the start and end of the current minting period? What are the minting periods for ThreeFold Farming in 2023?

The minting periods for the 12 months of 2023 are the following:

MonthStart of the Minting PeriodEnd of the Minting Period
Jan 2023December 31, 2022 at 4:32:40 amJanuary 30, 2023 at 3:20:40 pm
Feb 2023January 30, 2023 at 3:20:40 pmMarch 2, 2023 at 2:08:40 am
Mar 2023March 2, 2023 at 2:08:40 amApril 1, 2023 at 12:56:40 pm
Apr 2023April 1, 2023 at 12:56:40 pmMay 1, 2023 at 11:44:40 pm
May 2023May 1, 2023 at 11:44:40 pmJune 1, 2023 at 10:32:40 am
Jun 2023June 1, 2023 at 10:32:40 amJuly 1, 2023 at 9:20:40 pm
Jul 2023July 1, 2023 at 9:20:40 pmAugust 1, 2023 at 8:08:40 am
Aug 2023August 1, 2023 at 8:08:40 amAugust 31, 2023 at 6:56:40 pm
Sep 2023August 31, 2023 at 6:56:40 pmOctober 1, 2023 at 5:44:40 am
Oct 2023October 1, 2023 at 5:44:40 amOctober 31, 2023 at 4:32:40 pm
Nov 2023October 31, 2023 at 4:32:40 pmDecember 1, 2023 at 3:20:40 am
Dec 2023December 1, 2023 at 3:20:40 amDecember 31, 2023 at 2:08:40 pm

Note: A minting period is 2630880 seconds

What is the TFT minting address on Stellar Chain?

The TFT minting address on Stellar Chain is the following: GBOVQKJYHXRR3DX6NOX2RRYFRCUMSADGDESTDNBDS6CDVLGVESRTAC47

You can see it on the Stellar Explorer here.

Can Titans and DIY 3Nodes share the same farm?

Yes. It's one big ThreeFold family! A farm can have several 3Nodes (Titans or DIY) and each 3Node can be linked to only one farm.

Do I need one farm for each 3Node?

No. You only need one farm. One farm can have multiple 3Nodes. When setting your farm, you will add an address for the farming rewards. All farming rewards from each 3Node of your farm will be sent to this address. Note that you can choose to have more than one farm. It is up to you.

Can a single farm be composed of many 3Nodes?

Yes. You can have many 3Nodes on the same farm.

Can a single 3Node be on more than one farm?

No, this is not possible.

Do I need one reward address per 3Node?

You do not need more than one address linked to one farm. All of your 3Nodes can be connected to the same farm. Rewards per each 3Nodes will all be sent to the address linked to your farm.

How can I access the expert bootstrap mode for Zero-OS?

You can access the expert bootstrap mode for Zero-OS at this link: https://bootstrap.grid.tf/expert.

When it comes to the Zero-OS bootstrap image, can I simply duplicate the first image I burnt when I build another 3Node?

Yes. What is needed on this bootstrap image is to have the proper farm ID. The bootstrap image will be the same for all your different 3Nodes. It's a good TF farming practice to leave the bootstrap image plugged in the 3Node at all time.

If a node is unused for certain time (e.g. many months offline), will it be erased by the Grid?

No, nodes only get deleted if the farm owner chooses to do so. Old "nodes" are really just entries in TF Chain and TF Chain does not modify or delete this data without external input.

Can a farm be erased from TF Grid?

No, this is not possible. In the future, we will implement some features in order to allow the cleaning of unused farms. As of now, this is not possible. Also, an old farm does not take resources on the TF Grid, or very little.

On the ThreeFold Connect App, it says I need to migrate my Titan farm from V2 to V3. What do I have to do? How long does this take?

You simply need to press on the button Migrate to V3 on the ThreeFold Connect App to migrate your Titan to V3. This process usually takes a couple of minutes but it can take a little bit longer.

How can I migrate my DIY farm from V2 to V3?

Create a new bootstrap image using your new V3 Farm ID. To create a new V3 Farm ID, you can use the ThreeFold Connect App or the ThreeFold Dashboard.

What does the pricing policy ID of a farm represent?

The pricing policy is the definition of how the network bills for workloads (pricing for each resource type, discounts, etc.).

What is the difference between TiB and TB? Why doesn't the TF Explorer shows the same storage space as my disk?

Terabyte (TB) and Tebibyte (TiB) are units of digital information used to measure storage capacity and data transfer rate. While terabyte is a decimal standard unit, Tebibyte is binary.

  • 1 TB = 1000^4 bytes
  • 1 TiB = 1024^4 bytes.

There are thus more bytes in 1 TiB than in 1 TB. 1 TiB is equal to 1.099511627776 TB.

You can play around these 2 notions by exploring this TiB-TB converter.

You can also check this table to compare different OS system's storage representation.

What are the rewards of farming? Can I get more rewards when my 3Node is being utilized?

By connecting a 3Node to the Grid, you get Farming Rewards. If you set a public IP address for the Grid to use, you will receive additional rewards when your 3Node is being utilized by users on the Grid. All rewards are paid in TFT. To know the potential rewards, use the simulator. More information on sales channel will be communicated in the future.

How can I know the potential farming rewards for Grid Utilization?

Go on the ThreeFold simulator, enter your 3Node resources, check the Public IP address. This will enable farming rewards from the parameter NU Required Per CU. Check the difference in the farming rewards per month. Note that you will need a Public IP address.

What is the easiest way to farm ThreeFold tokens (TFT)?

Buy a certified 3Node. This is more or less plug n play! You can also build a DIY 3Node. It's fun and there are many resources to help you along the way.

When do I receive my rewards?

They are distributed once a month, around the 8th*. Distributions are not daily, or after a certain threshold. Note that upcoming minting rules may have a 24 month lockup or until 30% utilization for 3 months on your 3Node.

*This can change slightly depending on the current situation.

On ThreeFold Grid v3, how can I verify my 3Nodes' payments on Stellar Blockchain?

Here's the summary on how to find the details of a 3Node's payment on the Stellar Blockchain using the ThreeFold Alpha Minting tool:

  1. Go to https://stellar.expert.

  2. Open the hamburger menu on the top right (mobile version).

  3. Paste your wallet address in the search bar.

  4. Go to the last payment you want details of.

  5. Make sure the Memo (HASH) is in the HEX format. If it isn't, click on base64 and change it to hex.

  6. Copy the Memo (HASH).

  7. Go to the ThreeFold Alpha minting tool at https://alpha.minting.tfchain.grid.tf/.

  8. Paste the Memo (HASH) you copied. You will find the details of the 3Node's payment.

NB: A full period is 2630880 seconds.

Do farming rewards take into account the type of RAM, SSD, HDD and CPU of the 3Node server?

No. The farming rewards do not take into account the specific type of RAM, SSD, HDD and CPU. The farming rewards take into account the quantity of storage and compute units (e.g. TB of SSD/HDD, GB of RAM, # of virtual cores).

What is the farming reward calculation?

The general calculation is the following:

TFT earned per month = 
CU farmed * CU farming rewards 
+ SU farmed * SU farming rewards
+ NU used * NU farming rewards
+ IPAddr used * IPAddr farming rewards

Lear more about this here.

Note: The farming rewards take into account the quantity of storage and compute units (e.g. TB of SSD/HDD, GB of RAM, # of virtual cores). The farming rewards do not take into account the specific type of RAM, SSD, HDD and CPU.

Can I send my farming rewards directly to a crypto exchange?

This is not possible. When you send tokens to a crypto exchange, you need to include a memo with your wallet address and the current farming rewards system of ThreeFold is already using that memo space to send the correct farming information.

I received my farming rewards, now I want to sell my ThreeFold tokens (TFT). How can I do this?

First, know that your TFT farming rewards are on the Stellar Blockchain. If you want to sell on Pancakeswap (on the Binance Chain), you will need to use the Stellar-BSC Bridge, where a 50 TFT fees is applicable. See the section on the BSC-Stellar Bridge for more information on this method.

If you stay on Stellar blockchain, you can either swap your TFT, for example on StellarX, where some XLM will be needed, or sell your TFT on an exchange using the Stellar blockchain. Currently, this can be done on BTC-Alpha. First, send your TFT to your exchange wallet and make sure you enter the memo correctly. Once your TFT are on the exchange, you can sell them on the market. Make sure to follow the exchange specific steps where applicable.

The most straightforward wallet possible when it comes to farming TFT is simply to use the wallet included with the ThreeFold Connect App. It is also possible to use other wallets that are connected to the Stellar Blockchain. In these cases, you will need to establish a trustline with TFT. You can also store your TFT on a Ledger or a Trezor via the Stellar Blockchain. See stellarterm.com, stellarx.com and solarwallet.io.

Can I have more details on storing ThreeFold tokens (TFT) on hardware wallets?

Yes of course! In short, you will need to use a hardware wallet (Ledger/Trezor/etc.) to sign in, add TFT as an asset (trustline), then send TFT to the Stellar address. For more information, read the section Store TFT in a Hardware Wallet.

Do I need collateral to farm ThreeFold tokens?

Many decentralized data projects require collateral, but not ThreeFold. There is an ongoing discussion on collateral. Join the discussion here.

Can I add external drives to the 3Nodes to increase rewards and resources available to the ThreeFold Grid?

As of now, you cannot add external drives to a 3Nodes. It is not yet supported. It might be in the future and we will update the FAQ if/when this happens.

Do I have access to the TFT rewards I receive each month when farming?

For now, V3 farming rewards are distributed as TFT on Stellar and they are immediately available. The lock system will be implemented on chain. Tokens will be staked to your address until unlock conditions are met. Conditions are: 2 years of farming or 30% of proof-of-utilization for 3 months per 3Node.

What is TFTA? Is it still used?

Note that on V3, TFTA will not be issued anymore.

Is there a way to certify a DIY 3Node? How can I become a 3Node certified vendor and builder?

As of now, only certified ThreeFold partners can certify a 3Node. You could become a ThreeFolder vendor and offer certified 3Node. Read more here.

Does it make sense to make my farm a company?

There is no general answer to this. Here's what a ThreeFold member thinks about this if you are living in the USA. Check for your current location if this makes sense for you. DYOR.

"Definitely do this project as a business entity. You can write off equipment, utilities and a portion of your home's square footage if your are hosting the equipment at home." TFarmer

What is the difference between uptime and downtime, and between online and offline, when it comes to 3Nodes?

Uptime and status are two different things. As long as the 3Node is powered on, its uptime does not reset. Its status changes to offline if it hasn't made an uptime report in the last two hours. Even if after more than two hours, the 3Node isn't yet online, the uptime does not reset. Uptime is a function of the system being powered on.

My 3Node server grid utilization is low, is it normal?

This is normal. Currently, not all 3Nodes are being utilized by users on the ThreeFold Grid. Each month, more and more utilization happens and the ThreeFold Grid continually expans. To read on the ThreeFold Grid utilization and expansion, check this TF Forum post.

3Node Farming Requirements

What are the general requirements for a DIY 3Node server?

Any 64-bit hardware with an Intel or AMD processor chip can run Zero-OS and become a 3Node. For a complete guide on building a 3Node, read the Farming Guide. The following configurations provide guidelines on compatible and recommended setups:

  • Servers, desktops and mini computers type hardware are compatible.
  • A minimum of 500 GB of SSD and a bare minimum of 2 GB of RAM is required.
  • A ratio of 1:4 between vCPU and RAM (e.g. 8vCPU and 32 GB of RAM) is recommended.
  • The recommended upper limit is 8 GB of RAM per vCPU as farming rewards do not increase beyond that ratio.
  • A wired ethernet connection is highly recommended to maximize reliability and the ability to farm TFT.

What kind of computer do I need to make a 3Node server?

Any modern computer should be sufficient, especially once you upgrade the amount of RAM and storage to increase your TFT rewards. While CPU specs are not currently measured, they may be in the future. To insure your 3Node provides meaningful capacity to the network, you should have at least 1000 CPU passmark per core as measured on https://www.cpubenchmark.net/cpu_list.php

I found a decent computer (or server) to buy online, but it doesn't come with a CPU. How can I know what CPU models would work with a specific computer or server?

You can usually find this information in the owner manual of the server in the section Technical Specifications. Here's a link for Dell servers.

Can I host more than one 3Node server at my house?

Yes, but do not host more than your bandwidth can support.

Is Wifi supported? Can I farm via Wifi instead of an Ethernet cable?

No. Wifi is not supported by Zero-OS due to a number of issues, like reliability, performance, configuration requirements and driver support. It's all about Ethernet cables here.

I have 2 routers with each a different Internet service provider. I disconnected the ethernet cable from one router and connected it to the other router. Do I need to reboot the 3Node?

You do not need to reboot. The 3Node will be able to reconnect to the ThreeFold Grid.

Do I need any specific port configuration when booting a 3Node?

No, as long as the 3Node is connected to the Internet via an ethernet cable (wifi is not supported), Zero-OS will be able to boot. Usually with the DHCP, it automatically assigns an IP address.

How much electricity does a 3Node use?

A small DIY 3Node based on a compact office computer will draw under 20W. A full size server will draw around 100W idling. Note that a 3Node actively used on the Grid (proof-of-utilization) will draw more power, but also generate passive income on top of farming if you have a public IP address.

For more information, read thes section Calculate the Total Electricity Cost of Your Farm of the Farming Guide.

Has anyone run stress tests to know the power consumption at heavy load of certain 3Nodes?

The community is starting to gather some data on this. As of now, we know that a R720 with 2x2690v2 cpu, 4TB NVME SSE P4510 and 320GB ram will draw 390W @100% load. With 2x2650L v2, it's around 300W with fans at full speed. More info will be added as we gather more data.

How much AC power do you need (in BTU) to compensate for the heat generated by the 3Node servers? How can I ensure proper relative humidity range for my 3Node server farm?

For a small farm set up, you could simply keep your normal air conditioner system and it should be fine. For large set up, you need to take into account the power consumption of your servers and turn it into BTU consumption. The quick equation to know the total BTU needed per ThreeFold Farm is:

Server Power in kW * 3413 * Number of Servers = Total BTU

The total BTU will indicate the minimum number to look for when buying your air conditioner. For more information, read the section Calculate the Minimum BTU Needed in the Farming Guide.

How can I ensure the relative humidity in my server room stays within a proper range?

Look in your server's user manual to know the proper range of relative humidity your server can handle. If necessary, use an hygrometer to measure relative humidity and make sure it stays within an acceptable range for your 3Nodes.

Depending on your geographical location and your current situation, it could be interesting to consider having a AC unit equipped with a dehumidifier. Read your servers' manual to check the proper relative humidity range and set the unit accordingly.

How can I ensure the air changes per hour is optimal in the 3Node servers' room?

If deemed necessary, it is recommended to ventilate the server room in other to disperse or evacuate heat from the place. In those cases, ventilation flow will be set depending on the air changes per hour (ACPH) needed. Note that the ASHRAE recommends from 10 to 15 ACPH for a computer room.

What are the maximum and minimum temperatures or humidity levels a 3Node server can handle?

This will depend on the specific server/computer you are using. You should check the server's technical guide/manual to get the proper information.

We will use here the Dell R720 as an example since it is a popular 3Node choice. In this case, the Technical Guide.

For the R720, between 35˚C and 40˚C (or 95˚F and 104˚F), with 5% to 85% relative humidity, you can have this <10% of annual operating hours (around 36 days per year), and between 40˚C and 45˚C (or 104˚F and 113˚F), with 5 to 90% relative humidity, it’s <1% of annual operating hours (around 3.6 day per year). All this considers that there is no direct sunlight.

From 10˚C to 35˚C (thus from 50˚F to 95˚F), it’s considered standard operating temperature. With relative humidity from 10% to 80%.

This can give you a good idea of the conditions a 3Node can handle, but make sure you verify with your specific server's manual.

Can the Titan 3Node be run on PoE? (Power Over Ethernet)

Titans don't come equipped for Power Over Ethernet (PoE). If you have a NUC based Titan there are some PoE lids that might be compatible.

What is the relationship between the 3Node's resources and bandwidth?

A 3Node connects to the ThreeFold Grid and transfers information, whether it is in the form of compute, storage or network units (CU, SU, NU respectively). The more resources your 3Nodes offer to the Grid, the more bandwidth will be needed to transfer the additional information.

What is the bandwidth needed when it comes to running 3Nodes on the Grid?

The strict minimum for one Titan is 1 mbps of bandwidth.

If you want to expand your ThreeFold farm, you should check the following to make sure your bandwidth will be sufficient when there will be Grid utilization.

min Bandwidth per 3Node (mbps) = 10 * max((Total SSD TB / 1 TB),(Total Threads / 8 Threads),(Total GB / 64 GB)) + 10 * (Total HDD TB / 2)

This equation means that for each TB of HDD you need 5 mbps of bandwidth, and for each TB of SSD, 8 Threads and 64GB of RAM (whichever is higher), you need 10 mbps of bandwidth.

This means a proper bandwidth for a Titan would be 10 mbps. As stated, 1 mbps is the strict minimum for one Titan.

The bandwidth needed for a given 3Node is not yet set in stone and you are welcome to participate in ongoing the discussion on this subject on the Forum.

Can I run Zero-OS on a virtual machine?

You can. But you won't farm TFT. To farm TFT, Zero-OS needs to be on bare metal.

Is it possible to build a DIY 3Node with VMWare VM ?

It wouldn't be possible to get farming rewards from such configuration. You need to run a 3Node Zero-OS on bare metal and no virtual machine is permitted. Indeed, to farm TFT you need bare metal. Virtual Machine will not work. Furthermore, all disks of a 3Node need to be wiped completely, thus no other OS can be on the 3Node.

It would be possible to simply set Zero-OS as a VM on VMWare VM, but it wouldn't farm as stated.

Can I run a 3Node on another operating system, like Windows, MAC or Linux?

No. ThreeFold runs its own operating system (OS), which is Zero-OS. You thus need to start with completely wiped disks.

What is the minimum SSD requirement for a 3Node server to farm ThreeFold tokens (TFT)?

You need a theoretical minimum of 500 GB SSD on a desktop or server. Less could work.

Is it possible to have a 3Node server running on only HDD disks?

This is not possible. A 3Node needs at least one SSD disk of 500 GB.

Building a 3Node - Steps and Details

What are the main steps to build a DIY 3Node, from start to finish?

The main steps to build a DIY 3Node are the following:

  1. Create a ThreeFold farm
  2. Create a Zero-OS bootstrap image
  3. Set the hardware
  4. Wipe all the disks
  5. Set the BIOS/UEFI
  6. Boot the 3Node

For a complete step-by-step guide on how to build a DIY 3Node, read the Farming documentation.

I wonder what type of desktop computer or server to use for my 3Node. Are there any recommendation when it comes to DIY 3Node hardware?

The Farming documentation contains a list of typical DIY 3Nodes in the section List of Common DIY 3Nodes.

Also, a good place to start is by checking what other farmers have built.

What can you do to zero out your disks? How can I wipe the disks of my 3Node server with Linux?

For zero out disks unix has a tool called “wipefs”. Every distribution should have it. So if you take an ISO image of any Linux distribution and boot in “Try” mode, you can then go in a terminal or shell and write the following command:

Wipe all the disks in the 3Node:

sudo for i in /dev/sd*; do wipefs -a $i; done

Wipe all the nvme disks in the 3Node:

sudo for i in /dev/nvme*; do wipefs -a $i; done

This will wipe all of the disk devices in the hardware. Make sure you have SU permissions (write "sudo" before the command line). If needed, do a backup of the disks information before.

For more information, read the section Wipe All the Disks of the Farming Guide.

How can I wipe a disk with Windows?

Follow these simple steps:

  1. Open up the command line.
  2. Write diskpart
  3. Write list disk
  4. Write select disk x (replace x with the disk you want to wipe)
  5. Write clean

You're done! Note: do not format the disk.

Do I need to wipe all the disks on my 3Node server? Can I have one disk with a different operating systesm (OS)?

Zero-OS will not boot properly if not all disks are wiped. All disks must be wiped. So for example, you can't have one SSD disk wiped and another one SSD with Windows OS on it. In this case, Zero-OS won't boot. You can only have one operating system (OS), Zero-OS, when running a 3Node server.

How can I be sure that I properly wiped my disks?

A wiped disk has:

  • no label
  • no partition
  • no filesystem
  • only zeroes

On Linux to see if the disk is only composed of zeroes, use the command line (example with disk sda):

cmp /dev/sda /dev/zero

If there is only zeroes, you should get the output:

cmp: EOF on /dev/sda

You can also use the command line:

sudo pv /dev/sda | od | head

Here are some useful command lines for Linux to make sure there are no partitions, no labels, no filesystems and that the disks are filled with zeroes only:

sudo fdisk -l

sudo fdisk -lf

sudo parted -l

sudo parted /dev/sda 'print’

lsblk --f

lsblk --raw

If I wipe my disk to create a new node ID, will I lose my farming rewards during the month?

No, you wouldn't lose any farming rewards. You will get both the rewards for your previous node ID's uptime and also the new node ID's uptime.

Note that this is the case with the current farming rewards based on total uptime, without any minimum threshold.

My disks have issues with Zero-OS and my 3Nodes. How can I do a factory reset of the disks?

Warning: this is destructive. It erases the disk sda in this example.

Boot a Linux in Try mode and run the following command:

sudo badblocks -svw -b 512 -t 0x00 /dev/sda

*In this example, the disk selected is sda. Choose the proper disk name in your current situation, e.g. sdb, sdc..).

This line will read and (over)write zeroes (0x00) everywhere on the disk.

To understand the line of code, note that 512 is the block size and that without -b BLOCKSIZE, the process would simply go slower. 0x00 represents the zero byte.

This will take some time, but it should reset the disk and hopefully fix any issues.

Note: it takes the 3Node server around 1 percentage per minute for a 2TB SSD disk to accomplish the badblock operation.

Before doing a bootstrap image, I need to format my USB key. How can I format my USB key?

*Note that BalenaEtcher will format and burn your bootstrap image in the same process. See next Q+A for more details.

Windows: This is done easily with diskpart. Here's all the coding needed (with disk X as an example, make sure you choose the correct disk): run Command Prompt as an administrator (right-click option), write diskpart, then in diskpart write list disk, choose your disk and write select disk X, write clean, write create partition primary, write format fs=fat32, then write assign. If for any reason, the process doesn't work, quit diskpart and redo the whole thing. This should fix any bug. Cautious with diskpart, it's destructive.

MAC: This is done easily with Disk Utility. Go in Disk Utility. Select your USB key, click on erase on the top, write a name for your USB key, then choose a format (MS-DOS (FAT) if USB key < 32GB, exFAT if USB key > 32GB), then click erase, then click done.

LINUX: In the Terminal, write df, find your disk (here we use sdX), write sudo umount /dev/sdX, write this line (with the proper FORMAT) sudo mkfs.FORMAT /dev/sdX [FORMAT= vfat for FAT32, ntfs for NTFS, exfat for exFAT], then finally verify the formatting by writing sudo fsck /dev/sdX.

What do you use to burn (or to load) the Zero-OS bootstrap image onto a USB stick?

For MAC, Linux and Windows, you can use BalenaEtcher to load/flash the image on a USB stick. This program also formats the USB in the process. Rufus can also be used for Windows.

Also, got Linux systems, you can transfer the dowloaded image with the dd command: dd if=created_boot_loader_file.img of=/dev/sd? where the input file is the downloaded file from http:/bootloader.grid.tf and the output file (device) is the USB stick device.

Should I do a UEFI image or a BIOS image to bootstrap Zero-OS?

It depends on your 3Node's system. Newer computers and servers will accept UEFI. If it does not work with UEFI, please try with the options ISO (BIOS CD/DVD) or USB (BIOS image) on the ThreeFold bootstrap website. Read the next Q+A for more information on BIOS/UEFI.

How do I set the BIOS or UEFI of my 3Node?

You can read this documentation to learn more about BIOS and UEFI settings for a DIY 3Node.

For my 3Node server, do I need to enable virtualization in BIOS or UEFI?

Yes, you should enable virtualization. On Intel, it is denoted as CPU virtualization and on ASUS, it is denoted as SVM. Make sure virtualization is enabled and look for the precise terms in your specific BIOS/UEFI.

How can I boot a 3Node server with a Zero-OS bootstrap image?

Plug the USB key containing the Zero-OS bootstrap image with your farm ID then power on your 3Node. If the BIOS/UEFI is set correctly and the disks are all wiped, it should boot correctly the first time. If you have any problem booting your 3Node, read the section Troubleshooting and Error Messages of the FAQ.

The first time I booted my 3Node server, it says that the node is not registered yet. What can I do?

The first time you boot a 3Node, it will be written: “This node is not registered (farmer *: NameOfFarm). This is normal. The Grid will create a node ID and you will be able to see it on screen. This can take a couple of minutes.

If after some time (couple hours), the 3Node doesn't get registered, there might be something off with the Grid connection. You can then try to reboot the 3Node, or wait and boot it later. If it persists, you can check the rest of the Troubleshooting section of the Farmer FAQ, or ask around the ThreeFold Telegram Farmer chat or the ThreeFold chat for help.

The first time I boot my 3Node, the node gets registered but it says cache disk : no ssd. What can I do?

This probably means that you either haven't connected a SSD or that you need to wipe your SSD disk(s). Zero-OS runs on bare metal and needs a minimum of one SSD disk (min 500GB & 50 GB per CU). You will see "cache disk : OK" when it works.

The first time I boot my 3 node, the node gets registered and it says cache disk : OK, but the table System Used Capacity is empty. What can I do?

Most of the time, just wait and data will appear. If you want to be sure your 3Node is online on the Grid, you can check the Explorer, which fetch information every 2 hours. If it persist, first try to simply reboot your 3Node.

I have a relatively old server (e.g. Dell R710 or R620, Z840). I have trouble booting Zero-OS. What could I do?

Sometimes, Zero-OS will not boot in UEFI mode on older servers. In that case, try to boot in BIOS mode. Use either a USB key or the CD/DVD optical drive (the 4th and 5th option on https://bootstrap.grid.tf/) and make sure to select BIOS and not UEFI mode in your server settings.

I connected a SATA SSD to a CD-DVD optical drive adaptor. My system does not recognize the disk. What can I do?

Try to set AHCI mode instead of Legacy mode in SATA settings in the BIOS.

Can someone explain what should I put in the Public IP part of my farm? Should I just insert my Public IP and Gateway (given by my ISP)?

Assuming you are a DIY farmer and operate from your home, this field can be left blank. You do not have to fill in any details.

The add IP option is for farmers that have a block of IP addresses routed to their router (in data centers mostly) and want to present “dedicated IP” addresses for deployments. For more information on how to set the public configuration, go to this link.

Farming Optimization

What is the difference between a ThreeFold 3Node and a ThreeFold farm? What is the difference between the farm ID and the node ID?

A farm is a composition of one or many 3Nodes. A 3Node is a computer connected to the ThreeFold Grid. Each farm has its farm ID and each 3Node has its node ID.

How can I know how many GB of SSD and RAM do I need?

You need 50 GB of SSD per compute units (CU) and a minimum of 500 GB SSD and 2 GB of RAM per 3Node.

A 3Node has, in general, 2 compute units (CU) per thread. Thus, for peak optimisation, you need 100 GB SSD and 8GB RAM per thread.

What is the optimal ratio of virtual cores (vcores or threads), SSD storage and RAM memory? What is the best optimization scenario for a 3Node, in terms of ThreeFold tokens (TFT) farming rewards?

In short, for peak optimization, aim for 100 GB SSD of storage and 8GB RAM of memory per virtual core (vcore or thread).

For example, a 32 threads (32 vcores) 3Nodes would need 3.2 TB SSD and 256GB RAM to be optimal, reward-wise. That is: 32 * 100 = 3200 GB SSD = 3.2TB SSD, and 32 * 8 = 256 GB RAM total.

Adding more GB of RAM would not increase your TFT rewards. You would need more vcores if you want to expand.

NB: This is purely based on reward considerations. Some users might need different ratios for different specific uses of the Grid.

What does TBW mean? What is a good TBW level for a SSD disk?

TBW means Terabytes Written. TBW directly measures how much you can write cumulatively into the drive over its lifetime. For your 3Node, it can be a good idea to prioritize a minimum ratio of 500 TBW per 1TB for SSD.

*Note that TBW is not a technical specification, but a general claim from the manufacturer. For this reason, it can also be good to check the warranty of the disk. For example, if a manufacturer offers a 5-year warranty to its product, it indicates that the company thinks its product will last a long time.

Do I need a surge protector?

A surge protector is highly recommended for your farm and your 3Nodes. This ensures your 3Nodes will not overcharge if a power surge happens. Whole-house surge protectors are also an option.

Do I need a power distribution unit (PDU)?

A PDU (power distribution unit) is useful in big server settings in order to manage your wattage and keep track of your power consumption.

Do I need an uninterrupted power supply (UPS)?

A UPS (uninterrupted power supply) is great for a 3Node if your power goes on and off frequently for short periods of time. This ensures your 3Node does not need to constantly reboot. If your electricity provider is very reliable, a UPS might not be needed, as the small downtime resulting from rare power outages with not exceed the DIY downtime limit*. (95% uptime, 5% downtime = 36 hours per month.)

*That being said, make sure to have settings such as AC Recovery Power set properly so your 3Node goes back online if the power shutdowns momentarily. UPS are generally used in data center to make sure people have enough time to do a "graceful" shutdown of the units when power goes off. (See next question)

Are SATA and SAS drives interchangeable?

This goes only one way. You can put a SATA drive in a SAS slot, but you can’t put a SAS drive in a SATA slot. See the next question for more information.

What is the speed difference between SAS and SATA disks?

One of the big differences between SATA and SAS is the transfer speed. Using SATA disks with SAS cables, you will be limited by the SATA transfer speed.

  • Sata I : 150 MB/s
  • Sata II : 300 MB/s
  • Sata III : 600 MB/s
  • SAS : 600-1500 MB/s

Note: You will most probably need to re-flash the raid card if you use the front panel disks (onboard storage) of your server.

Is it possible to do a graceful shutdown to a 3Node server? How can you shutdown or power off a 3Node server?

There are no "graceful" shutdowns of 3Nodes. You can shutdown a 3Node from the software side. You need to shut it down manually directly on the hardware. 3Nodes are self-healing and if they suddenly power down, no data or information will be lost.

Is it possible to have direct access to Zero-OS's core to force a reboot?

No, this is not possible. The general philosophy with Zero-OS is: no shell, no GUI, and no remote control. In other words, anything that could potentially provide attack surface is off the table. This ensures a high security level to Zero-OS and the ThreeFold Grid in general. To reboot a 3Node, you have to do it manually.

Do I need some port forwarding in my router for each 3Node server?

No, this is not needed.

Are 3Node servers noisy? Are there certain servers that are less noisy than others?

The noises from a server can be similar to the noise of a conventional pedestal fan. As a general rule, the bigger the server, the bigger the fans (which are mostly the source of sounds). Smaller fans need to spin faster to disperse as much heat as bigger fans. So, for example, 1U servers are noisier than 2U servers. Also, note that in general, tower servers are quieter than rack servers. Go for a tower server or desktop if you want a quieter 3Node.

It has been stated that Dell servers are quieter than HP. For Dell, R710-R720 are quieter than Compellent. You can check the server's manual and see directly the noise they produce in decibels.

Note that servers generate white noise. White noise is often used for sound masking. For some, it helps them to relax and to fall asleep. A server in your bedroom, why not?

Are there ways to reduce 3Node servers' noises?

To reduce the noise, you can remove all the unnecessary cards in the servers as well as the HDD disks if you don't use them. Unplugging the SAS cables can also help. You can also set the fans to adjust their speed instead of being constant.

At the end of the day, servers were manufactured for durability and efficiency, and not for being quiet. Most servers are placed in server rooms where noise doesn't matter much.

What is the difference between the two CPUs: i7-6700 and i7-6700T?

The T stands for thermal throttled. The i7-6700T is 46% more energy efficient. While the i7-6700 has a 42% faster CPU speed and has a higher passmark. Note that the TFT reward is going to be the same. The difference is with power consumption: 35 Watt for the i7-6700t and 65 Watt for the i7-6700.

For a more thorough comparison, read this.

I built a 3Node out of old hardware. Is it possible that my BIOS or UEFI has improper time and date set as factory default?

Yes. Make sure you have the correct time and date in BIOS to avoid errors when trying to boot Zero-OS. It might not cause any problems, but sometimes it does.

I have rack servers in my ThreeFold farm. Can I set rack servers vertically?

In general, it is not recommended to set rack servers vertically as they were designed to be laid flat in racks. That being said, if you want to set your rack vertically, here are some general rules to follow. Do so at your own risk.

First, make sure the parts in the servers are well installed and that they will not fall if laid vertically. Second, and foremost, you want to make sure that there will not be any overheating. This means to make sure you don't block the front and rear of the unit, so heat can dissipate thought the vents.

If you want to put the rack vertically with the longest side of the rack laying upward, having the power supply units (PSUs) on the very top will ensure that heat dissipate well.

Farming and Maintenance

How can I check if there is utilization on my 3Nodes?

To see if there is utilization on your 3Node, you can consult the TF Dashboard, go to the Farm section and consult the information under your 3Nodes. Note that the quickest way is to check if there are CPUs reserved.

Do I need the Zero-OS bootstrap image drive (USB or CD-DVD) when I reboot, or can I boot Zero-OS from the 3Node main hard drive?

It is advised to keep the bootstrap image plugged in your 3Node. Once your node has been booted with Zero-OS via the USB key, you can remove the USB key, but if something happens and the node needs to reconnect with the network, it won’t be able to do so. We advise people to let the USB key always in so the node can reconnect with the network if needed.

You need the bootstrap image device plugged in every time you reboot a 3Node and it's a good practice to keep it plugged in all the time. The technical explanation is: (1) at first boot, it creates a minimum requirement on SSD which is used as cache (2) each time the system restarts it reuses this SSD piece but Zero-OS bootstrap is also needed to download the last image. Indeed, image is not stored on the machine and also no boot loader is installed.

When I set my farm on the ThreeFold Dashboard with polkadot.js, it asks for a Stellar payout address. What should I write?

The easiest method would be to write the address on your ThreeFold Connect App. You can also write any address that is on the Stellar blockchain and has a trustline enabled with ThreeFold Token.

It's written that my node is using 100% of HRU. What does it mean?

HRU stands for your HDD space available. It means that you are using 100% of the HDD space available, or equivalently that you have no HDD on your system.

On the ThreeFold Explorer, I only see half of the virtual cores or threads my 3Node has, what can I do?

Check in the BIOS settings and make sure you have enabled Virtual Cores (or Hyper Threading/Logical Cores).

What is the current status on the Wake-on-LAN (WOL) feature?

The WOL feature has been revised. This project has transformed into the Farmerbot. The farmer bot is a piece of software that can run as a grid deployment and manages a farmers nodes.

To learn more about the Farmerbot, read the Farmerbot Guide.

Why are the 3Nodes' resources different on the ThreeFold Explorer and the ThreeFold Dashboard?

There is a difference because one shows the resources in GiB and the other in GB. It's just a way to display information, the resources are ultimately the same, but shown differently. 1 GiB = 1.073741824 GB.

How can I test the health of my disks?

There are many ways to test the health of your disks. For some information on this, you can have a look at this TF forum post.

How can I transfer my 3Node from one farm to another?

To transfer your 3Node from one farm to another, simply make a new bootstrap image of the new farm, connect the new bootstrap image to the 3Node and restart the node.

Note that you can use balenaEtcher to format and burn the bootstrap image at the same time.

What do CRU, MRU, HRU and SRU mean on the ThreeFold Explorer?

CRU means the number of virtual cores. MRU means the GB of ram (memory). HRU means the HDD capacity storage and SRU means the SSD capacity storage.

I have more than one ThreeFold 3Node farm, but I want all my 3Nodes on only one farm. How can I put all my 3Nodes on one farm? How can I change the farm ID of my 3Node?

If you have more than one 3Node associated with more than one farm, it is possible to put all the 3Nodes under only one farm. The following shows how to change the farm ID of your 3Node.

For each 3Node, you need to create a new USB key Zero-OS boostrap image associated with the chosen farm ID. This will ensure your 3Node links to the chosen farm. To create a new USB key Zero-OS bootstrap image, you can download the bootstrap image here or you can clone an existing USB key bootstrap image associated with the chosen farm ID. In both case, you can use a software like BalenaEtcher. Once you have the new USB key bootstrap image, plug it into the 3Node and reboot the server. After reboot, the 3Node will have the same node ID as before, but it will now be associated with the chosen farm ID.

Note: If you want a new node ID for your 3Node, you will need to wipe the main SSD of your 3Node.

How can I know if my 3Node is online on the Grid? Is there an Explorer for Grid V3?

There are multiple answers to this.

(1) You can plug a monitor to your 3Node and check directly its status.

(2) You can check your 3Node status by using the Explorer of the ThreeFold Dashboard.

(3) You can also use the unofficial, but highly useful ThreeFold Node Status Bot on Telegram.

I booted my 3Node and the monitor says it's online and connected to the Grid. But the ThreeFold Explorer says it is offline? What can I do?

The Explorer refetches information every 2 hours. You can wait 2 hours and see if the problem persists. Then/or, you could reboot the 3Node and see if the Explorer sees it as online.

My 3Node does show on the ThreeFold Explorer, but not on the ThreeFold Dashboard, what can I do?

If you're 3Node is correctly registered on the ThreeFold Grid but you cannot see it on the ThreeFold Dashboard, there can be many different ways to solve this issue.

One way to fix this is to go in the TF Dashboard, select change the address and then simply re-paste the same address, then the extension will ask you to resign. Usually this fixes the issue.

If the first method did not work, you can try to remove the account and add it back up on the Polkadot.js extension. Before doing so, make sure you have a back up of your seed phrase as you will need it to re-enter the account. Your 3Node should then appear.

I set up my farm on ThreeFold Connect App. Can I use the Polkadot extension Dashboard instead?

If you want to use the Dashboard, you can take the TFChain Secret from the app and import it into the Polkadot extension. For more information, read this section of the Farming Guide. For the other way around (TF Dashboad to TF Connect App), read this section of the guide.

Is it equivalent to create a farm on ThreeFold Connect App or via the Polkadot extension?

Yes it is. Farm setup through the app and using the Polkadot extension with the Dashboard are equivalent.

If I upgrade my 3Node, will it increase my rewards?

Yes. Use the simulator.grid.tf to verify the additional rewards. But note that, currently, upgrades are not recognized until the next minting cycle.

I booted my 3Node for the first time at the beginning of the month, then I did some upgrade or downgrade, will the ThreeFold Grid recognize the new hardware? Will it still be the same 3Node ID?

Downgrades are counted in the current minting cycle. So you mint for the entire cycle at the downgraded specs.

Minting only considers a single configuration per node per cycle, and that is the minimum configuration seen at any point during the cycle. With this logic in mind, upgrades will only be recognized at the next minting cycle. Note that your 3Node will have a new ID and new price entry if you changed the SSD containing the 3Node ID.

Is it possible to ask the 3Node to refetch the node information on the monitor?

To refetch information, press " q " on the keyboard.

When does Zero-OS detect the capacity of a 3Node?

Zero-OS only detects capacity right after it boots.

Where is the 3Node ID stored?

For the current Zero-OS version, the node ID is stored in the first SSD you install on your 3Node*. If you change or erase this disk, this disk will lose its current 3Node ID.

*Note that if, at the first boot, you put a SSD SATA and a SSD NVME at the same time, the node ID will be registered on the SSD SATA.

Is there a way to backup my node ID in order to restore a 3Node if the disk with the node ID gets corrupted or breaks down?

Yes, you can do a backup, but as of now this process must be done manually.

One way is to boot a Linux USB image in Try mode, open up the File folder of your disk that contains the node ID. Click on + Other Locations. Then, open the folder that contains the folder zos-cache and open the folder identityd. In this folder, select the file seed.txt and make a copy of it in a safe place (USB key, notebook, e-mail, etc.). If the disk which contains your node ID is damaged, simply reboot the 3Node with a new disk and the Zero-OS bootstrap image. Your 3Node will connect to the Grid and assign a new node ID. Once this is done, reboot the 3Node, but this time with the Linux USB image, go in the same folder as stated before and replace the new seed.txt file with the old file. Reboot your 3Node with the Zero-OS bootstrap and you're done.

If I upgrade my 3Node, does it change the node ID?

Upgrades won't change the node ID, unless you replace the SSD where the node ID is stored (see above for more info on this).

Does it make sense to recreate my node when the price drops?

Short answer: no. Long answer: click here.

My 3Node lost power momentarily and I had to power it back on manually. Is there a better way to proceed?

In your BIOS, go in Security Settings and choose Last for AC Power Recovery. If you want, set a delay between 60 and 240 seconds. This will ensure your 3Node does not power on and off frantically if your power flickers on and off, thus potentially damaging the unit. On other BIOS, it's After Power Loss, and you should choose Previous State.

*Depending on your 3Node, the parameter might have a different name.

Do I need to change the battery BIOS?

It can be a good thing to change it when you buy an old desktop or server to make sure it lasts long. When the battery goes out of power, the 3Node won't have access to the BIOS settings if it loses power momentarily.

Do I need to enable UEFI Network Stack?

You don't need to if you use a removable media (e.g. USB key) as a booting image. It is needed only if you boot from a PXE server on your network. You should keep this feature disabled. Enable it only if you know 100% what you are doing. Otherwise it might bring vulnerabilities in terms of network security.

I want redundancy of power for my 3 nodes. I have two PSU on my Dell server. What can I do?

Make sure you enable the Hot Spare feature. This feature is accessible in iDRAC Settings - Power Configuration. Other servers might have this function, with a different name and configuration. Check the server's manual for more details.

Why isn't there support for RAID? Does Zero-OS work with RAID?

RAID is a technology that has brought resilience and security to the IT industry. But it has some limitations that we at ThreeFold did not want to get stuck in. We developed a different (and more efficient way to store data reliably. Please have a look here.

This Quantum Safe Storage overcomes some of the shortfalls of RAID and is able to work over multiple nodes geographically spread on the TF Grid.

Is there a way to bypass RAID in order for Zero-OS to have bare metals on the system? (No RAID controller in between storage and the Grid.)

Yes it is possible. "You can use the on board storage on a server without RAID. You can re-flash the RAID card, turn on HBA/non-RAID mode, or install a different card. No need for RAID." @FLnelson It's usually easy to set servers such as a HP Proliant with the HBA mode. For Dell servers, you can either cross-flash the RAID controller with an “IT-mode-Firmware” (see this video) or get a DELL H310-controller (which has the non-RAID option). Otherwise, you can install a NVME SSD with a PCIe adaptor, and turn off the RAID controller.

I have a 3Node rack server. Is it possible to use a M.2 to SATA adapter in order to put the M.2 SATA disk in the HDD bay (onboard storage)?

Yes, it is possible. You will most probably need to bypass the RAID controller for Zero-OS to access properly the onboard storage. See previous question.

My 3Node uses only PCIe adapters and SSD NVME disks. Do I need the RAID controller on?

The onboard RAID controller is not linked to your PCIe SSDs. In this case, you can switch the RAID controller off.

Can I change the name of my farm on polkadot.js?

It’s possible to rename farms through the Polkadot UI. For mainnet, use this link.

  1. Under using the selected account, select the account that owns the farm
  2. Choose tfgridModule from the dropdown menu submit the following extrinsic,
  3. Select updateFarm(id, name, pricingPolicyId)
  4. Under name: Bytes, write the new farm name
  5. Finally, click on the bottom Submit Transaction at the bottom right of the screen

How can I delete a farm on polkadot.js?

The ability to delete a farm was removed from TF Chain due to concerns that nodes could be left without a farm and thus cause problems with billing.

I try to delete a node on the TF Dashboard, but it doesn’t work. Is there any other way to proceed that could work?

It’s possible to delete nodes through the Polkadot UI. For mainnet, use this link.

  1. Under using the selected account, select the account that owns the farm,
  2. Choose tfgridModule from the dropdown menu submit the following extrinsic
  3. Select deleteNodeFarm(nodeId)
  4. Under id: u32, write the ID of the 3Node you want to delete
  5. Finally, click on the bottom Submit Transaction at the bottom right of the screen

My 3Node has 2 ethernet ports in the back, with one written AMT above, what does it mean? Can I use this port to connect my 3Node to the ThreeFold Grid?

First, let's define the term AMT. It means: Active Management Technology. Without going into too much details, it is to remotely access servers via the network at the BIOS level. Thus, you should plug the ethernet cable in the port next to AMT, and not into the AMT port. You can explore AMT properties if you want remote access to your server.

My 3Node is based on a the hardware Z600, Z620 or Z820, can I run it headless or without a GPU?

For the Z600, there is a great video on youtube.

For the Z620 and the Z820, you need to do some variation on the video above. In the BIOS, go in File, then Replicated Setup, and select Save to Removable Storage Device. This will save a text file on your USB key. Then, in the text file, go to Headless Mode and remove the * in front of Disable and put it in front of Enable. Save the file and then go back into BIOS. Now go in File, then Replicated Setup, and select Restore from Removable Storage Device.

Running your 3Node without the GPU can save some power consumption as well as giving you one more extra slot for other hardware.

Is it possible to add high-level GPU on rack servers to farm more TFT?

Some farmers had success installing GPUs such as the RTX3080 in servers as small as 2U (such as R730). Connections such as 250W 8-pin plug are needed on each riser. Generally, tower servers have more space to add high-level GPU.

Note: GPU farming will be implemented in the future.

If I change farm, will my node IDs change on my 3Node servers?

You can move 3Nodes between farms without losing the node IDs. You simply need to change the boot media with the new farm ID and then reboot the 3Node. The 3Node will have the same node ID but it will now be associated with the new farm ID.

Troubleshooting and Error Messages

Is it possible to access the Error Screen or Log Screen?

Yes! On the Zero-OS console, hit alt-F2 to open up the Error/Log Screen, and hit alt-F3 to go back to the main screen.

I plugged an HDMI cable from my monitor into the node and the monitor is displaying nothing. What can I do?

You may have to reboot with HDMI cable already connected. Video does not seem to be turned on unless HDMI is present at boot. Once you boot with HDMI in, you can unplug and replug and it will work.

To simply see if your 3Node is online, you can go on the ThreeFold Explorer or check with the Telegram ThreeFold Farm Status Bot.

What does it mean when I see, during the 3Node boot, the message: error = context deadline exceeded?

In general, this message means that the ThreeFold Grid asked something to your 3Node, and your 3Node could not respond fast enough. It is usually necessary to read the following error message to understand the situation more specifically.

I try to boot a 3Node, but I get the error: "No Route to Host on Linux". What does it mean?

There are many potential answers to this. Perhaps the Host is offline, the service isn't running. This is usually the reason with TF Grid. It means the Grid is not responsive. In this case, try to boot the 3Node later. If it persists ask TF Support.

There can also be other reasons. You might have connected to the wrong port. Perhaps you have configured iptables to block connections on that port. Your DNS might be improperly configured. You might have an Incorrect Network or Host Configuration. Many troubleshoots are possible. Here's a good place to start.

How can I fix the error: "Network configuration succeed but Zero-OS kernel could not be downloaded" when booting a 3Node?

To fix the error "Network configuration succeed but Zero-OS kernel could not be downloaded", you can try to restart the router and reboot the 3Node. This usually fixes the issue. If this doesn't work, check if the router is still functional. The cause of this issue might be that your router is broken.

Using SAS disks, I get the error; "No ssd found, failed to register". What can I do to fix this?

First make sure to wipe the disks and then boot your 3Node. If you've wiped the disks and it doesn't work, it's been reported that using the command "diskpart clean command" on Windows can fix this issue.

When booting a 3Node, how to fix the error: "no disks: registration failed"?

There can be many different fixes for this error. Here are some troubleshooting tips to test separately:

  • In BIOS, enable AHCI
  • Make sure to wipe the disks of the 3Nodes
  • If the 3Node has a RAID Controller:
    • Disabled the RAID controller, OR;
    • Flash the RAID controller (i.e. crossflashing), OR;
    • Change the controller to a Dell H310 controller (for Dell servers)
  • Try the command badblocks (replace sda with your specific disk). Note that this command will delete all the data on the disk
    • sudo badblocks -svw -b 512 -t 0x00 /dev/sda

My SSD is sometimes detected as HDD by Zero-OS when there is a reboot. Is there a fix or a way to test the SSD disk?

If your SSD disk shows as HDD, usually you can reboot the 3Node and Z-OS adjusts correctly.

Anyone experiencing frequently this issue where Z-OS sometimes detects an SSD as HDD can try the following:

  • Boot up a live Ubuntu Desktop image
  • Run the benchmark utility within the Disks app
  • Check if the seektime of the disk is sufficient for Z-OS
    • If the seektime is above 0.5ms, Z-OS will consider your SSD as HDD

Detailed Steps:

  • Boot a Ubuntu Linux live USB
  • Install gnome-disks if it isn't already installed:
    • sudo apt install gnome-disks
  • Open the application launcher and search for Disks
  • Select your disk
  • Click on the tree dots menu
  • Select Benchmark Disk...
    • Use the default parameters
      • Transfer rate: This is not relevant for our current test
        • You can set to it to minimum (e.g. 2)
    • Sample size: 10 MB is sufficient
  • Check the average access time on the ThreeFold repository
    • Check seek time for HDD and SSD
      • A SSD needs to be <=0.5ms
  • If the result is above 0.5ms, this is why Z-OS doesn't recognize the disk properly
    • You can then run diagnostics (e.g. smartmontools)
      • If this is not fixable, you should change disk (e.g. take a more performing disk)

Note: The green dots on the output represent seektime and that's what Z-OS is looking at. Specifically, it checks that the average seektime is below 0.5ms. If the seektime is above this, Z-OS will consider your SSD as HDD.

When booting a 3Node, I get the message: failed to register node: failed to create node: failed to submit extrinsic: Invalid Transaction: registration failed. What could fix this?

The most probable fix to this error is simply to properly wipe your disk(s):

I try to boot a 3Node, but I get the message no route with default gateway found. What does it mean?

First, let's see the main terms. Default gateway act as an access point to other networks, in this case the TF Grid, when there is a back and forth exchange of data packets.

While the last question implied a communication problem from the Grid, this error message usually means that the 3Node has communication problem. In short, it has difficulty reaching the TF Grid. There are many ways to troubleshoot this error. First, let's give the most direct solution. Make sure you have a direct connection with your Internet Service Provider (ISP): your 3Node should be connected to a router or a switch via an ethernet cable. Wifi doesn't work. Make sure your DHCP is set correctly.

If the problem persists, check the default gateway of your 3Node and then make sure your router can reach it.

*See next Q+A for more a possible solution.

I have trouble connecting the 3Node to the Grid with a 10GB NIC card. What can I do?

As of now, Zero-OS sometimes has trouble with 10GB NIC card. The easiest solution to this is to connect your 3Node with the 1GB NIC card. This should solve the issue. More fine tuning might be needed to get your 3Node to work with a 10GB NIC card. Future Zero-OS version might solve this issue.

I switch the ethernet cable to a different port when my 3Node was running. Internet connection is lost. What can I do?

When your 3Node boots, Zero-OS marks the NIC port. This means you cannot change NIC port when your 3Node is running. You can either put back the ethernet cable in the initial NIC port, or reboot the 3Node. At boot, Zero-OS will marks the new NIC port as the main entry.

I get the error Certificate is not yet valid when booting my 3Node server, what can I do?

Make sure your firmware is up to date. If necessary, reinstall it. You might have to install then re-install the firmware if your system is very old.

When running wipefs to wipe my disks on Linux, I get either of the following errors: "syntax error near unexpected token" or "Probing Initialized Failed". Is there a fix?

Many different reasons can cause this issue. When you get that error, sometimes it is because your are trying to wipe your boot USB by accident. If this is not the case, and you really are trying to wipe the correct disk, here are some fixes to try out, with the disk sda as an example:

  • Fix 1:
    • Force the wiping of the disk:
      • sudo wipefs -af /dev/sda
  • Fix 2:
    • Unmount the disk then wipe it:
      • sudo umount /dev/sda
      • sudo wipefs -a /dev/sda

I did a format on my SSD disk, but Zero-OS still does not recognize them. What's wrong?

Formatting is one thing, but to boot properly, Zero-OS needs to work on a completely wipe disk. Thus, make sure you wipe your disks. Formatting is not enough.

I have a Dell Rx10 server (R610, 710, 910). When I boot Zero-OS I get the message Probing EDD and the 3Node doesn't boot from there. What can I do?

For the R610 and 710, you can simply re-flash the card. See this link for more information. For the 910, you can’t re-flash the card. In this case, get a LSI Dell card and it should work. (They are cheap when you buy them used online.)

My 3Node doesn't boot properly without a monitor plugged in. What can I do?

First, try to disable the "Halt On" mode in BIOS. If you do not have this option, try simply enabling the Legacy Support (Dell BIOS for example). If this doesn't work, try to plug in a Dummy Plug/Headless Ghost/Display Emulator in your 3Node. This will simulate a plugged monitor. This should fix the problem.

My 3Node is running on the Grid, but when I plugged in the monitor, it states: Disabling IR #16. Is there a problem?

In general, you can simply ignore this error statement. This error is linked to the Nvidia binary driver. It simply means that your 3Node lost connection with the graphic card (by unplugging and replugging the monitor for example).

My 3Node won't boot without disabling the Secure Boot option, is it safe?

In the case where you want to boot Zero-OS, disabling Secure Boot option is safe. With Secure Boot disabled, it can be easier or even necessary when it comes to booting Zero-OS. Secure Boot is used when you want to lock the BIOS/UEFI settings.

When I tried to boot my 3Node, at some point the screen went black, with or without a blinking hyphen or dash. What could cause this and what could I do to resolve the issue?

There is a possibility that this happens because you are booting your 3Node on a HDD. A 3Node needs a minimum of 500GB of SSD to work properly.

Also, make sure that you are using the correct boot option (Legacy BIOS or UEFI) in the Settings and that it corresponds to the correct booting image on the ThreeFold Bootstrap page.

This problem often arises when you plugged your disks in the wrong controller. For example, try unpluging the disks from the SAS controller, and plug them in the SATA controller. Also, disable the SAS controller if needed.

In a Legacy BIOS boot, make sure Legacy is enabled and disable Data Execution Prevention if possible.

Also, it might have to do with your RAID controller configuration. Make sure this is properly set. For example, configuring all the HDD disks into one logical disk can fix this problem, or re-flashing the RAID card can also help.

My 3Nodes go offline after a modem reboot. Is there a way to prevent this?

Yes, there are many ways to prevent this. An easy solution is to set the DHCP server to reserve local IPs for the 3Nodes MAC addresses.

This problem is also preventable if your router stays online during the modem reboot.

Indeed, rebooting the 3Nodes is necessary when there are local IP changes, as 3Nodes are addressed a local IP addresses when they are booted.

The DHCP will addresses any local IP address that is available when you are booting a 3Node. Reserving local IP addresses is a good TF farming practice.

When I boot my 3Node, it reaches the Welcome to Zero-OS window, but it doesn't boot properly and there's an error message: failed to load object : type substrate..., what can I do?

Usually simply rebooting the 3Node fixes this problem.

When I try to access iDRAC on a web browswer, even with protected mode off, I get the error The webpage cannot be found, what can I do?

Open iDRAC in the Internet Explorer emulator extension (IE Tab) in Chrome, then update iDRAC. It should work elsewhere then. Sometimes, it will be needed to add "ST1=code" at the end of the IE Tab url.

When booting the 3Node, I get the error Network interface detected but autoconfiguration failed. What can I do?

First make sure your network cable is plugged in and that your DHCP is working and responding. If you change the NIC port of the ethernet cable, make sure to reboot the 3Node so Zero-OS can change the NIC port attribution.

Some farmers reported that this got fixed by simply powering off the 3Node(s), the router and modem for 2 minutes then powering it all back on. Resetting the modem and router (switch on the hardware) in the process can also help.

If this doesn't work, try to upgrade the firmware of the NIC and the motherboard. If this still doesn't work, the NIC card might be broken. Try with another NIC card.

When I boot my Dell server, I get the message: All of the disks from your previous configuration are gone... Press any key to continue or 'C' to load the configuration utility. What can I do?

Many changes to your server can lead to this message.

Usually, the easiest solution is to reset the disk configuration in iDRAC's configuration utility.

What can causes this message:

  1. During a new installation, the cables connecting to your external storage are not wired to the correct ports.
  2. Your RAID adapter has failed.
  3. Your SAS cables are not plugged properly or are malfunctioning.

Note: Resetting the configuration will destroy all data on all virtual disks. Make sure you know what you are doing! In doubt, ask the TF community.

I have a Dell R620. In Zero-OS, I get the failure message No network card found and then the 3Node reebots after few seconds. The same happens for every LAN input. What can I do?

The first thing to try here is to boot the server in BIOS mode instead of UEFI mode. If this doesn't fix the problem, try the following.

Sometimes, this happens when the firmwares of BIOS, iDRAC, Lifecycle Controller and NIC are incompatible to each other. The solution is then to update them all correctly. Some problems can arise in the process.

First, you should try to do the updates using iDRAC as you can update both iDRAC and BIOS there. If this does not work, try to update separate, with a live-linux distro, the BIOS, iDRAC and Lifecycle Controller. Once this is done, the server should be able to do a liveupdate, https to dell support website, via lifecycle-controller. This would update the other components. For more details on this method, watch this video.

Note: Some farmers have reported that the Broadcom NIC card does not work well for Zero-OS and that a standard Intel PCI NIC card replacement resolved the issue. This could be a more straightforward method if updating the firmwares doesn't resolve the issue.

I am using freeDos to crossflash my raid controller on a Dell server, but I can't see the RAID controller with the Command Info. What can I do?

Turn on the raid controller in the BIOS, otherwise freeDos does not show you the raid controller with the command Info.

Can I use a VGA to HDMI adaptor to connect a TV screen or monitor to the 3Node? I tried to boot a 3Node with a VGA to HDMI adaptor but the boot fails, what can I do?

This might work, but it has been reported by farmers that Zero-OS might have difficulties booting when this is done with a VGA/HDMI adaptor on a TV screen. This is most likely due to the TV screen not supporting the output once the system loaded into Zero-OS. The easy fix to this issue is to use a standard computer monitor with a VGA plug.

When I try to boot my 3Node, the fans start spinning fast with a loud noise and the screen is black. What can I do to resolve this?

There may be several causes to this issue. You can try to remove all the RAM sticks, to clean the dust and then to reseat the RAM sticks. If it still doesn't resolve the issue, you can check the RAM sticks one by one to see if one is malfunctioning. This often resolves the issue. Also, some cables might not be properly connected.

When booting Zero-OS with IPV6 configurations, I get the errors (1) dial tcp: address IPV6-address too many columns in address and (2) no pools matches key: not routable. What can I do to fix this issue?

This usually means that the IPV6 attributed is not valid. It is also often caused when the DNS configuration does not resolve IPV6 correctly.

To fix this issue, it is often necessary to adjust the IPV6 settings related to the router and the modem. Confirming with your Internet service provider (ISP) that the IPV6 settings are properly configured could also be necessary to fix the issue.

When booting a 3Node, Zero-OS downloads fine, but then I get the message: error no route with default gateway found, and the message: info check if interface has a cable plugged in. What could fix this?

Make sure you have network stack enabled in BIOS. If so, check you ethernet port and make sure that it's clean. Also make sure the ethernet rj45 connectors are clean on both ends. If that does not work, verify the state of your SATA cables. If all this doesn't work, download and re-install Zero-OS.

How can I update Dell and HP servers to Intel E5-2600v2, E5-2400v2 and E5-4600v2, when applicable?

There are many ressources online with steps on how to do this. You can check this youtube video on Dell and HP servers, as welll as this documentation for HP Proliant Gen8.

How can I update the firmware and driver of a Dell PowerEdge server?

Dell has excellen documentation for this. Read this for the detailed steps.

When I boot a 3Node in UEFI mode, it gets stuck at: Initializing Network Device, is there a way to fix this?

In short, booting the 3Node in BIOS mode instead of UEFI mode usually fixes this issue.

You can make bootable USB with the USB option of the Zero-OS bootstrap image page. Make sure to boot your server using BIOS and not UEFI. In the boot sequence, make the USB as your first choice to boot.

When I boot my 3Node, it gets stuck during the Zero-OS download. It never reaches 100%. What can I do to fix this issue?

Here are some ways to troubleshoot your 3Node when it cannot download Zero-OS completely (to 100%):

  • Sometimes, just rebooting the 3Node and/or trying a little bit later can work.
  • It can help to reboot the modem and the router.
  • Make sure your BIOS/UEFI is up to date. Updating the BIOS/UEFI can help.
  • It can also help to set the correct date and time.

When booting a 3Node, I get the error=“context deadline exceeded” module=network error=failed to initialize rmb api failed to initialized admin mw: failed to get farm: farm not found: object not found. What can I do to fix this issue?

Usually, the simple fix to this issue is to make sure that your bootstrap image is on the same network as your farm. For example, if you created your farm on the Main net, you should use a Main net Zero-OS bootstrap image.

ThreeFold Grid and Data

How is the farming minting reward calculated? Is the Grid always monitoring my 3Node?

The Grid uses an algorithm that does not continually monitor the 3Node. It does its best to determine uptime through occasional checking in, which we call ping. The 3Node sends a ping to the Grid and the Grid sends a ping to the 3Node to confirm the reception. (Ping-Pong!)

It’s helpful to understand that the Grid is really just 3Nodes and TF Chain (which itself is a collection of nodes). Nodes report their uptime by writing an entry on TF Chain, about once every two hours. These reports are used for minting.

How does communication happen on the ThreeFold Grid at the 3Node's level?

There are two ways to get information about nodes. Once is to query TF Chain, and the other is to communicate with nodes directly.

The link is the following: https://t.me/tfnodestatusbot.

How does the ThreeFold Node Status bot work? How can I use the ThreeFold Node Status bot to verify if my 3Node is online?

  1. Click on this link: https://t.me/tfnodestatusbot

  2. To subscribe a node, write the command /subscribe nodeID. With the ID 100 as example, write: /subscribe 100

  3. To verify the status of all your 3Nodes, write: /status

  4. To verify the status of all your 3Nodes through Yggdrasil, write: /ping

Note: The bot should send you alerts when it considers any registered node to be offline.

How does the Telegram Status Bot get information from my 3Node? My 3Node is online on the ThreeFold Explorer, but offline on the Telegram Status Bot, is this normal?

The status bot communicates directly by sending pings to the nodes over Yggdrasil every five minutes. Therefore, it will report on temporary network interruptions that might not affect your total uptime calculation as used for minting.

I noticed that when I reboot my 3Node, the uptime counter on the ThreeFold Explorer goes back to zero. Does it mean I lose uptime and the uptime start over again when I reboot the 3Node?

No. The only uptime you lose is the time your 3Node was offline from the ThreeFold Grid. This ThreeFold Grid still has the data of your total uptime of the month. The Explorer only shows this statistics as: "This node has been up non-stop without being rebooted for now [insert time]". If you maintain a total uptime above the minimum uptime, you're fine.

*For now the farming rewards are proportional to the total uptime.

One of my nodes is showing the wrong location. Any problem with that?

The ThreeFold Explorer is showing your ISP location. This is perfectly normal.


Can I use different type of RAM for the same 3Node?

No. Always use the same type of RAM per 3Node. If you use RDIMM, go all RDIMM, etc. Check your hardware specifications to make sure you have the right type of memory.

How can I know if the memory I am buying is correct for my specific hardware?

To be sure, look into the owner's manual of your specific computer.

In general, you can go to Memory.net and look for your specific computer model. As general steps, select your computer's system in By system, then select the series and then select the specific model of the series. You will then see available memories to buy from memory.net. You can also simply read the documentation at the bottom. The memory type supported by your computer will be explained. Then you can buy the memory needed from any other computer store.

For servers, you can check with Cloudninja's documentation here. Search for your specific hardware and look for the compatible memory. This reference is good for rack and tower servers.

What do the terms RDIMM, LDIMM, UDIMM, LRDIMM, FBDIMM mean when it comes to RAM memory sticks?

Well first, the DIMM means dual inline memory module.

  • U stands for or unregistered (or unbuffered).

  • R stands for registered memory.

  • LR stands for load-reduced.

  • FB stands for fully-buffered.

What is the difference between ECC and non-ECC memory?

ECC means error correction code memory. This type of memory can detect and correct data corruption. Non-ECC mostly cannot detect nor correct, but some can detect, but never correct data corruption. Check your hardware specifications to make sure you have the right type of memory (ECC or non-ECC).

How can I change the RAM memory sticks on my 3Nodes? How can I achieve dual channel configuration with sticks of RAM?

First, always use RAM sticks of the same size and type. It should be noted on your motherboard which slots to populate first. As a general guide, there is usually 2 slots A and B, with each 2 memory stick entries. You must then install the ram sticks on A1 and B1 in order to achieve dual channel, then A2 and B2 if you have more (visual order: A1 A2 B1 B2).

Example: You want to start with your largest sticks, evenly distributed between both processors and work your way down to your smallest. Let's take an example with 2 processors as well as 4x 16GB sticks and 4x 8GB sticks. The arrangement would be A1-16GB, B1-16GB, A2-16GB, B2-16GB, A3-8GB, B3-8GB, A4-8GB, B4-8GB. Avoid odd numbers as well. You optimally want pairs. So if you only have 5x 8GB sticks, only install 4 until you have an even 6.

What does RAM mean?

RAM means random access memory. Those type of memory can be read and changed in any order.

What does DIMM mean when it comes to RAM sticks?

It means dual in-line memory module. This type of computer memory is natively 64 bits, enabling fast data transfer.

I have 24 DIMMS ram slots on my server. Can I use them all?

Be careful when installing memory on a server. Always check your server's documentation to make sure your RAM sticks combination are correct.

For example, on the Dell R720, you can have 24x16gb RAM ECC sticks, but it can only handle 16 Quad ranked DIMMs. In this case, you can fill up all slots with registered DIMMs if you have a maximum of 4 quad DIMMS ranked on each CPU.


Why does the farmerbot need to wake nodes up for uptime report, if they are unused and shut down?

Because we want to know that the node is still available (is still there to be used). A farmer can unplug a node at any time so we can't distinct a node that has been unplugged from a node that is off.

Can a farmer opt in for farmerbot but also make exemption for certain nodes to never be shutdown regardless (for v1)?

We could do that, but as we are in the testing phase right now, it is not a good idea. But since The farmer is already able to configure the capacity planning rule: the percentage of how much unused resources he/she wants to be available, this deemed to be unnecessary. Whenever that percentage is reached a new node is powered on.

Will this feature require a master node that will never be shut down?

Yes, that is a requirement. Nodes are powered on by other nodes (WOL packet comes from one of the nodes in the farm). So if you want to be able to power them back on you have to have at least one node powered on.

Concerning the turning on of offline nodes, at the end, how does a farmer decide what almost full means? What do we decide?

Nodes are powered on in two cases: when the total resource usage reaches a certain percentage (defined by the farmer) or when there is an incoming find_node request and that the selected node is off.

Does the Farmerbot need to run physically in the farm?

The Farmerbot doesn’t have to run physically in the farm since it instructs nodes over RMB to shut down / power on nodes.

How many Farmerbot can you run per farm?

You can run only one Farmerbot for now.

On how many nodes can the Farmerbot run?

Currently you can only deploy one Farmerbot for each farm, so the Farmerbot can only run on one node.

Can you run multiple Farmerbots on the same computer or VM?

You can run multiple Farmerbot on the same computer or VM. where each Farmerbot can take care of one farm at time. So, for example, with two Farmerbots, you could manage two different farms, and so on.

In this case, you need to make sure that each Farmerbot is running in its own directory. We show here a directory tree example with two different Farmerbots running each a docker image.

├── farmerbot_docker_1
│   ├── config
│   │   ├── config.md
│   │   └── farmerbot.log
│   └── docker-compose.yaml
└── farmerbot_docker_2
    ├── config
    │   ├── config.md
    │   └── farmerbot.log
    └── docker-compose.yaml

To achieve this, you can simply follow the Farmerbot Quick Guide and create a distinct directory for each Farmerbot (mkdir farmerbot_docker_1, etc.) and complete the guide for each Farmerbot and farm combination.

What is the uptime requirement for the Farmerbot?

The Farmerbot should be running all the time or not at all (this is up to the farmer)

Can I run the Farmerbot on my farm?

Though you can run the Farmerbot anywhere you want, it doesn’t have to be on a 3Node in your farm.

Can the Farmerbot be the same node that wakes the other nodes?

If you want, you can set your Farmerbot on your farm, in the same LAN as all other nodes, and designate this 3Node to be the node that wakes up the other nodes.

What if I want to have several LANs with different group of 3Nodes?

You can set different farms in different LANs and set one Farmerbot per farm.

Can I turn all my nodes off while the Farmerbot runs? Why do I need at least one node per farm to be powered on?

The farmer bot uses the nodes in the farm to send WOL packets to the node that needs to wakeup. For this reason, you need at least one node per farm to be powered on at all time.

What type of computer can run the Farmerbot? What are the minimum specs to run the Farmerbot?

The Farmerbot can run on any computer/server, it could even run on a laptop so to speak, as long as it has an internet connection, the Farmerbot will be working fine.

The Farmerbot runs fine on a VM with a single vcore and 2GB of RAM. For the storage, you need to have room for Docker and its dependencies. Thus 1 or 2GB of free storage, with the OS already installed, should be sufficient.

What happened if all the nodes are powered off?

If all nodes in a subnet are powered off, there is no way other nodes in other subnets will be able to power them on again so that is an issue.

Is there a fail over setup possible for the Farmerbot?

It should be possible to set (at least) 2 instances of the Farmerbot and have a fail over setup. Stay tuned for more information on this.

How do 3Nodes power on and off with the Farmerbot?

Nodes power themselves down by checking TF Chain for a new power target. They power back up by receiving the magic packet from another node in the same LAN.

Can you have only one 3Node in your farm with the Farmerbot?

No. Since you need at least one node to power up a second node. you can't test the Farmerbot with just one node. You need at least two 3Nodes in your farm with the Farmerbot.

Is there a way to access more error checking?

Yes. In the config-path where you run the docker-compose, you have more logging for error checking. Under the directory where you set up your Farmerbot, you have the directory “config” in there where it creates a *.log file if you start the bot via Docker-Compose. In this directory, you can search for errors if something doesn't work as expected.

Do I need TFT to run the Farmerbot? How much?

Yes. How much depends on where you run the farmerbot and how many nodes it will power on/off. If you run the farmerbot on a node on the grid you will have to pay TFT to rent that node (or deploy on that node). Next to that, you will have to pay the transaction fees every time the farmerbot has to wakeup a node or shutdown a node. This is with 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)

On the Farmerbot, I receive the error: "Balance is not enough to apply an extrinsic". What can I do to fix this issue?

This means that you do not have sufficient funds (TFT) in your wallet for the Farmerbot's fees.

You thus simply need to add some TFTs in the wallet that is connected to the farm on which you are running the Farmerbot. 1 TFT can suffice for many transactions.

For more information on the Farmerbot running cost, read this QnA.

When deploying the Farmerbot, I get an error in "root-grid3_client-1". The farmerbot.log error is: "Error: Invalid twin id. Twin id must be postive integer". Is there a fix?

This indicates that the seed phrase has no associated twin. There can be many reasons behind this.

  • You are using the wrong seed phrase for your farm.
    • To fix it, simply find the proper seed phrase for the farm hosting your 3Nodes.
  • You created the farm in the TF Connect app and are using the seed phrase in words instead of the seed phrase in HEX format (the TFChain secret).
    • To fix it, simply use the TFChain secret (HEX format) in the TF Connect app.

How are dedicated nodes power managed?

Dedicated nodes are managed like any other node. Nodes marked as dedicated can only be rented completely. Whenever a user wants to rent a dedicated node the user sends a find_node job to the farmerbot. The farmerbot will find such a node, power it on if it is down and reserve the full node (for 30 minutes). The user can then proceed with creating a rent contract for that node. The farmerbot will get that information and keep that node powered on. It will no longer return that node as a possible node in future find_node jobs. Whenever the rent contract is canceled the farmerbot will notice this and shutdown the node if the resource usage allows it.

Can I run the Farmerbot on a Raspberry Pi?

It is possible to run the Farmerbot on a Pi. That being said, it is experimental and Threefold might never support it officially.

To run the Farmerbot on a Raspberry Pi, read this guide.

I want to set up the Farmerbot for my 3Node farm. Should all my nodes have the same twin ID?

The farmerbot can only manage the nodes that you define in the configuration. So, for each node in your farm, you will need to fill in these required attributes:

  • id
    • the id of the node
  • twinid
    • the twin id of the node

How can I use GraphQL to see if a 3Node is up or down in relation with the Farmerbot?

This script will show you all the nodes' status on GraphQL:

query MyQuery {
  nodes {
    power {

To find a specific node, write the following with the proper nodeID (here we use 655 as an example):

query MyQuery {
  nodes(where: {nodeID_eq: 655}) {
    power {

To find the nodes of a specific farm, write the following with the proper farmID (here we use 1 as an example):

query MyQuery {
  nodes(where: {farmID_eq: 1}) {
    power {

When setting up the Farmerbot, I get the error: dependency failed to start: container qa-redis-1 is unhealthy. What can I do?

There's some redis database state stored in a persistent volume. The issue is that the database got corrupted somehow and thus redis is crashing.

To remove the volume, and thus actually get a clean start, you can do this:

docker compose down -v

With the Farmerbot, how can I set a node to never shut down?

In the config file, set the following: never_shutdown:true for the node you want to never shut down.

How long does it take for the Farmerbot to do the periodic wake?

The minimum period between two nodes to be waken is currently 5 minutes. So every 5 minutes a new node wakes up.

Once all nodes are awaken, they all shut down at the same time, except the node that stays awaken to wake up the other during the next periodic wake.

The Farmerbot is set up and the containers are up and running, but in the logs I see following "Node xxx is not responding while we expect it to: timeout on blpop". Is this an issue?

This always happens when you start the Farmerbot while the nodes are down. Although this is not an issue, it is recommended to have the nodes running when starting the Farmerbot. The nodes data will then be up to date and the nodes that are allowed to be shut down will be shut down.

Does the Farmerbot operate in UTC or local time?

The Farmerbot works in UTC, independently of the local time of your machine.

Setting up the Farmerbot, I get the following error: "Failed initializing the database: Invalid duration value" What can I do to fix this?

If you see this error, it's because you've used 24h time format in conjunction with AM/PM time format. Note that if you add AM/PM, the Farmerbot will use the 12h time format (AM/PM). Otherwise, it is the 24h time format.

How can I update the Farmerbot with the new release?

Please follow these steps to update the Farmerbot with the new release:

  • Go to the Farmerbot folder
  • Stop the existing Farmerbot
    • docker compose rm -f -s -v
  • Make a copy of the Farmerbot log file
    • cp config/farmerbot.log config/farmerbot.log.archive
  • Remove the docker-compose file of the previous Farmerbot release
    • rm docker-compose.yaml
  • Download the new docker-compose file
    • wget https://raw.githubusercontent.com/threefoldtech/farmerbot/development/docker-compose.yaml
  • Run the new Farmerbot
    • docker compose up -d

This last command can take some time as it is downloading new docker images. Let the Farmerbot run for some time. If you think something is wrong or if you want to check if there is something wrong you should look into the config/farmerbot.log file. If you see some errors please share that file with us.

What are the changes brought in with the new Farmerbot release?

Among new changes, we adjusted the periodic_wakeup_limit which allows you to specify how much sleeping nodes you want to wake up at the same time during a periodic wakeup.

Also, we got rid of the requirement to have at least one node up that is unused. So if you have two nodes and one of them is running the Farmerbot the other one will be able to shutdown (it wouldn't shut down before).

How can I properly stop the Farmerbot and start it again?

Here are the steps to properly stop the Farmerbot and start it again.

  • Make sure to fully stop the Farmerbot before starting it again:

    • docker compose rm -f -s -v
  • You should also make sure that there are no containers left from the previous runs. First, list all containers:

    • docker container ls --all
  • Then delete the remaining containers:

    • docker container rm -f -v NAME_OF_CONTAINER
  • To start again the Farmerbot, write the following:

    • docker compose up -d

Can I deploy the Farmerbot with Portainer or other container management tools?

The Farmerbot should be compatible with Portainer and other container management tools, but there may be practical issues when deploying the Farmerbot. In that regard, ThreeFold can only support such tools on a best effort basis.

Concerning Portainer, some farmers tried it and it led to issues. It is thus recommended to use something else than Portainer to deploy the Farmerbot.

Can I run multiple Farmerbots on a single computer? How can I install a second Farmerbot for a different farm on the same computer?

You can run multiple Farmerbots on the same computer, as long as each Farmerbot is associated with only one farm. Note that you also need to have a separate twin for each farm. Currently, each Farmerbot can only control a single twin account, and each twin should only oversee a single farm.

You can follow the same process as with the first Farmerbot, with the new seed phrase associated with the new farm. You simply need to install the second Farmerbot in a different directory and it won't interfere with the other Farmerbot. This means that each Farmerbot will need its own .env and config files.

I did an update on my Farmerbot and now all my 3Nodes are waking up. Is this an expected behaviour?

Yes, this is an expected behaviour. When you restart the Farmerbot, it will then proceed to reboot all the 3Nodes of your farm.

I deleted the log files in the config folder, but no new log files have been generated. How can I generate new log files for the Farmerbot?

You can always get the logs from docker too via docker compose logs (run this command in the folder where your docker compose file is located). You can restart the Farmerbot to start the logging to file again (keep in mind that it will execute the periodic wakeup for all nodes at startup).

You should also make sure that you didn't use a different file structure.

When running the Farmerbot, I get the following: "error: UnauthorizedToChangePowerTarget". What can I do to fix this?

It means that the twin associated with the SECRET you loaded into the Farmerbot is not the owner of the farm. In other words, this error means that you provided a wrong mnemonic.

Note that only the twin of the farm is able to set the node power on chain (setNodePower).

How can I manually change the Farmerbot's power target of my 3Nodes?

If you know which nodes are down, you can change the power target manually in the Polkadot extrinsics.

Go to this link. Then do the following:

  • Under, submit the following extrinsics, choose the following:
    • tfgridModule
  • Then, select the following parameter:
    • changePowerTarget(nodeId, powerTarget)
  • Under nodeID, enter the 3Node ID
  • Then, select the power target's status
    • powerTarget (up or down)
  • Click submit transaction

I created my farm with the TFConnect app. What should I put in the parameter SECRET to properly set the Farmerbot?

You need to use the TFChain secret from the farm page on the TFConnect app as the SECRET, which is in HEX format. The main template should look like this: SECRET="0x12345ABCDEF..."

Ask a Question to the ThreeFold Community

If you have any question, you can ask the ThreeFold community via the ThreeFold forum or the ThreeFold Telegram channels:

Note 1: If we wrote something wrong, tell us!

Note 2: This is a collective effort. A big Thank You to the great ThreeFold Community. Many Q+A are contributions from the enthusiast farmers, users and developers of the ever-growing ThreeFold community.