tfgrid/docs_tfgrid_get_started
11
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Restructure farming setup guide with pre-built vs DIY paths and simplified steps

Browse Source
This commit is contained in:
mik-tf
2025-10-16 12:15:04 -04:00
parent 817c4054b6
commit dea3b30d08
1 changed files with 83 additions and 178 deletions
Download Patch File Download Diff File Expand all files Collapse all files

261
docs/farming/setup.md
View File

@@ -4,39 +4,60 @@ sidebar_position: 3
# Set Up Your Node
This guide walks you through the basic steps to get your 3Node connected to the ThreeFold Grid and start farming.
This guide provides an overview of setting up your ThreeFold node. The process differs depending on whether you bought a pre-built node or are building your own (DIY).
## Overview
## Setup Overview
Setting up a node involves:
The setup process differs based on your hardware choice:
1. Creating a ThreeFold account
2. Creating a farm on the dashboard
3. Downloading and booting Zero-OS
4. Verifying your node is online
### Pre-Built Node (Easiest)
## Prerequisites
**Time to farm: ~30 minutes** (after node arrives)
Before you begin:
1. **Create Account** - Download ThreeFold Connect app and create account
2. **Create Farm** - In the app, go to Farming → Create farm and save your **Farm ID**
3. **Order Node** - Purchase from [official vendor](https://yourdata.network/product-category/nodes/) and provide your Farm ID
4. **Receive & Power On** - Connect to network, plug in, and power on
5. **Verify** - Node appears online in ThreeFold Connect app
- ✅ Hardware ready (purchased or built)
- ✅ Reliable network connection (wired Ethernet)
- ✅ Power supply connected
- ✅ USB drive (16GB+) for Zero-OS boot image
**Important:** You need your Farm ID BEFORE ordering the pre-built node, as the vendor will configure it with your Farm ID.
## Step 1: Create Your ThreeFold Account
### DIY Node (More Steps)
### Get a Wallet
**Time to farming: ~2-6 hours**
You'll need a ThreeFold Connect wallet:
1. **Create Account** - Download ThreeFold Connect app and create account
2. **Create Farm** - In the app, go to Farming → Create farm and save your **Farm ID**
3. **Download Zero-OS** - Get bootstrap image with your Farm ID from [v4.bootstrap.grid.tf](https://v4.bootstrap.grid.tf)
4. **Burn to USB** - Write the image to a USB drive using BalenaEtcher or similar tool
5. **Configure BIOS** - Enable virtualization, set USB boot, configure power settings
6. **Boot Node** - Insert USB, power on, and wait for Zero-OS to load
7. **Verify** - Node appears online in ThreeFold Connect app
1. Download **ThreeFold Connect** app:
- iOS: [App Store](https://apps.apple.com)
- Android: [Google Play](https://play.google.com)
DIY requires creating a bootable USB and configuring hardware settings manually.
2. Create a new account
3. **Save your seed phrase securely** - This is critical!
4. Complete the setup wizard
## Step-by-Step Details
### Download ThreeFold Connect App
<div className="info-box">
**📱 Get the App**
- **iOS**: [Apple App Store](https://itunes.apple.com/be/app/3bot-login/id1459845885?l=nl&mt=8)
- **Android**: [Google Play Store](https://play.google.com/store/apps/details?id=org.jimber.threebotlogin)
</div>
### Create Account & Farm in ThreeFold Connect
1. Open the ThreeFold Connect app
2. Create a new account and **securely save your seed phrase**
3. Verify your email address
4. Go to **Farming** section → Click the **+** button
5. Choose a farm name and select a wallet
6. Click **Create**
7. Save your **Farm ID** (shown below "Farm ID" on the farm page)
<div className="info-box">
@@ -46,184 +67,68 @@ Your seed phrase is the **only** way to recover your account. Write it down and
</div>
## Step 2: Create Your Farm
### Verify Your Node is Online
### Access the Dashboard
After your node is powered on:
1. Go to [dashboard.grid.tf](https://dashboard.grid.tf)
2. Connect with your ThreeFold Connect wallet
3. Select the appropriate network (usually **mainnet**)
1. Wait 5-10 minutes for initial connection
2. Open ThreeFold Connect app
3. Go to **Farming** → Your farm name
4. Your node should appear with status **Online**
5. Check that resources (CPU, RAM, Storage) are correctly detected
### Register Your Farm
## Troubleshooting
1. Navigate to **Farms** section
2. Click **Create Farm**
3. Fill in farm details:
- **Farm Name** - Choose a unique name
- **Pricing Policy** - Usually default is fine
- **Certification** - Select appropriate level
4. Save your farm
**Node not appearing?**
- Wait 10-15 minutes for initial sync
- Check network cable is connected
- Verify Farm ID is correct
- Restart the node
You'll receive a **Farm ID** - save this number, you'll need it for the next step.
**DIY node won't boot?**
- Check BIOS boot order (USB should be first)
- Verify virtualization is enabled in BIOS
- Try re-burning the USB image
- Check USB drive is properly inserted
## Step 3: Download Zero-OS
## Need Detailed Step-by-Step Instructions?
### Create Boot Image
1. In the dashboard, go to your farm
2. Click **Bootstrap Image**
3. Select options:
- **Network**: Choose your network interface
- **Format**: USB or ISO (USB for most cases)
4. Download the image
The image is customized with your Farm ID, so your node will automatically connect to your farm.
### Write to USB Drive
**On Linux/Mac:**
```bash
# Find your USB device
lsblk
# Write the image (replace /dev/sdX with your USB device)
sudo dd if=zero-os-farm-XXXX.img of=/dev/sdX bs=4M status=progress
sync
```
**On Windows:**
- Use [Rufus](https://rufus.ie/) or [balenaEtcher](https://www.balena.io/etcher/)
- Select the downloaded image
- Select your USB drive
- Click Write/Flash
This guide provides a quick overview. For comprehensive setup instructions with screenshots and detailed troubleshooting, visit the **ThreeFold Farming Manual**:
<div className="info-box">
### ⚠️ Warning
### 📖 Comprehensive Setup Guides
Double-check you're writing to the correct device. The dd command will overwrite whatever device you specify!
**If you bought a pre-built node:**
- [Pre-Built Node Setup Guide](https://manual.grid.tf/farmers/category/buy-a-3node)
**If you're building your own (DIY):**
- [DIY Node Build Guide](https://manual.grid.tf/farmers/category/build-a-3node)
Both guides include:
- Step-by-step instructions with screenshots
- BIOS configuration details
- Detailed troubleshooting
- Advanced farming options
</div>
## Step 4: Boot Your Node
### BIOS/UEFI Configuration
Before first boot, configure your node's BIOS:
1. **Boot Order**
- Set USB as first boot device
- Enable boot from USB
2. **Virtualization**
- Enable Intel VT-x / AMD-V
- Enable VT-d / AMD-Vi (if available)
3. **Network Boot** (optional)
- Can enable PXE for future use
- Not required for USB boot
4. **Power Management**
- Disable deep sleep modes
- Enable "restore on AC/power loss" for automatic recovery
### First Boot
1. Insert the USB drive with Zero-OS
2. Power on the node
3. Select USB boot (or it should auto-boot)
4. Zero-OS will start loading
**What to expect:**
- Initial boot takes 2-5 minutes
- Node will download latest Zero-OS version
- Screen will show node information
- After setup, displays Farm ID and Node ID
## Step 5: Verify Your Node
### Check Dashboard
1. Go to [dashboard.grid.tf](https://dashboard.grid.tf)
2. Navigate to your Farm
3. You should see your node listed
4. Check status shows **Online**
### Node Information
Your node displays:
- **Node ID** - Unique identifier
- **Farm ID** - Your farm
- **Status** - Should be "Up"
- **Resources** - CPU, RAM, Storage capacity
- **Uptime** - Connection time
### Troubleshooting
**Node not appearing?**
- Wait 5-10 minutes for initial sync
- Check network cable connection
- Verify farm ID on boot screen matches dashboard
- Check firewall isn't blocking connections
**Node shows offline?**
- Check power and network
- Verify BIOS settings
- Ensure USB drive is properly inserted
- Check Zero-OS boot logs on screen
## Step 6: Monitor & Maintain
### Regular Monitoring
Check your node periodically via the dashboard:
- Uptime percentage
- Capacity utilization
- Rewards accumulation
- Network connectivity
### Maintenance Tasks
**Monthly:**
- Verify node is online
- Check reward accumulation
- Monitor uptime statistics
**As Needed:**
- Update Zero-OS (usually automatic)
- Replace failed drives
- Clean dust from hardware
- Verify network connectivity
### Maximize Uptime
For best rewards:
- Keep node powered 24/7
- Use reliable network connection
- Monitor for hardware issues
- Join farmer community for alerts
## What's Next?
🎉 **Congratulations!** Your node is now farming on the ThreeFold Grid.
### Advanced Topics
### Monitor Your Farm
For more details, check the advanced manual:
- Multiple node management
- Advanced networking setup
- GPU farming
- Farmerbot automation
- **ThreeFold Connect App** - Check node status and farm details
- **Community Support** - Join [Telegram Farmers](https://t.me/threefoldfarmers) for help and tips
**Resources:**
- [Manual](https://manual.grid.tf/farmers) - Comprehensive farming guide
- [Dashboard](https://dashboard.grid.tf) - Manage your farm
- [Telegram](https://t.me/threefold/1) - Community support
- [Forum](https://forum.threefold.io) - Discussions and updates
### Grow Your Farm
Once comfortable with one node, you can add more to increase capacity and earning potential. Each additional node is simpler since you already have your farm set up!
---
:::tip Growing Your Farm
:::tip Need Help?
Once you're comfortable with one node, you can add more nodes to your farm to increase capacity and earning potential!
The [Farmers Community](https://t.me/threefoldfarmers) has experienced farmers ready to help you succeed. Don't hesitate to ask questions!
:::