diff --git a/docs/farming/setup.md b/docs/farming/setup.md index eeb418e..722a9e0 100644 --- a/docs/farming/setup.md +++ b/docs/farming/setup.md @@ -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 + +
+ +**📱 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) + +
+ +### 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)
@@ -46,184 +67,68 @@ Your seed phrase is the **only** way to recover your account. Write it down and
-## 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**:
-### ⚠️ 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
-## 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! :::