ourworld_web/docs_projectmycelium
23
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update hoster setup page to reflect current grid development status

Browse Source
This commit is contained in:
mik-tf
2025-11-26 12:51:39 -05:00
parent 8de23fa9f9
commit 1d892813e8
1 changed files with 19 additions and 136 deletions
Download Patch File Download Diff File Expand all files Collapse all files

155
docs/hosters/setup.md
View File

@@ -4,148 +4,31 @@ sidebar_position: 4
# Set Up Your Hosting Node
This guide summarizes how to set up a **Mycelium hosting node (3Node)** and connect it to your farm so it can start earning SPORE.
> **Status – Mycelium Grid hoster onboarding**
>
> The Mycelium Grid and native hoster onboarding flow are not yet available. The information below is a preparation guide only. A full step‑by‑step setup guide will be published once the grid is live.
The process differs slightly depending on whether you **bought a pre‑built node** or **built your own (DIY)**.
## Where Things Stand Today
## Setup Overview
- **Mycelium Network** and **Mycelium Cloud** are live and usable today.
- The **Mycelium Grid** (decentralized capacity layer backed by hosters) is in active development.
- A fully Mycelium‑branded hoster experience (accounts, dashboards, SPORE rewards) will be documented here when ready.
### Pre‑Built Node (Easiest)
## How to Prepare as a Future Hoster
**Time to hosting: ~30 minutes** after the node arrives.
While the final onboarding flow is being finished, you can already:
1. **Create Account** – Use the ThreeFold Connect app.
2. **Create a Farm** – In the app, go to *Farming* → *Create farm* and note your **Farm ID**.
3. **Order Node** – Purchase from an official vendor and provide your Farm ID.
4. **Receive & Power On** – Connect power and network, then switch it on.
5. **Verify** – The node should appear online in your dashboard / app.
- Read the **[Hosters Overview](/hosters)** to understand the role.
- Choose or plan hardware via **[Buy or Build a Node](/hosters/buy-node)** and **[Advanced Node Options](/hosters/advanced-nodes)**.
- Learn about rewards and tokenomics in **[Hosting Economics](/hosters/economics)**.
> You must have your **Farm ID before ordering** a pre‑built node so the vendor can pre‑configure it.
## What’s Next
### DIY Node (More Steps)
Once the Mycelium Grid hoster onboarding is live, this page will be replaced with a concrete, end‑to‑end setup guide covering:
**Time to hosting: ~2–6 hours**, depending on your experience.
- Account creation and identity for hosters.
- Attaching nodes to the Mycelium Grid.
- Monitoring capacity, utilization, and SPORE rewards.
- Best practices for operating reliable nodes.
1. **Create Account** – Install ThreeFold Connect and create your account.
2. **Create Farm** – In the app, create a farm and save your **Farm ID**.
3. **Download Zero‑OS** – Get a 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 (e.g. with BalenaEtcher).
5. **Configure BIOS** – Enable virtualization, set USB boot, configure power‑on behavior.
6. **Boot Node** – Insert USB, power on, and wait for Zero‑OS to start.
7. **Verify** – Confirm the node appears in the dashboard / app.
DIY requires more low‑level work (BIOS configuration, boot media, etc.), but gives you full control over hardware.
## Step 1: Install ThreeFold Connect
ThreeFold Connect is used for account creation, wallet, and farm management.
:::info Get the App
- **iOS** – [itunes.apple.com/.../3bot-login](https://itunes.apple.com/be/app/3bot-login/id1459845885?l=nl&mt=8)
- **Android** – [play.google.com/.../threebotlogin](https://play.google.com/store/apps/details?id=org.jimber.threebotlogin)
:::
## Step 2: Create Account & Farm
1. Open ThreeFold Connect.
2. Create a new account and **securely save your seed phrase** (offline).
3. Verify your email address.
4. Go to the **Farming** section.
5. Tap **+** to create a new farm.
6. Choose a farm name and select which wallet will receive rewards.
7. Confirm and **note your Farm ID**.
:::warning Security
Your **seed phrase** is the *only* way to recover your account. Write it down and store it safely offline. Never share it with anyone, and never enter it into untrusted apps or websites.
:::
## Step 3: Prepare Your Node
### If You Bought a Pre‑Built Node
- The vendor will typically preload Zero‑OS and configure your Farm ID.
- On arrival, simply connect **power** and **Ethernet**, and power it on.
- Wait a few minutes for the node to boot and register.
### If You Built a DIY Node
1. **Download Zero‑OS image** for your Farm ID from [v4.bootstrap.grid.tf](https://v4.bootstrap.grid.tf).
2. **Flash the image** to a USB drive (e.g. BalenaEtcher or `dd`).
3. **Enter BIOS/UEFI** on your machine and:
- Enable CPU virtualization features.
- Set USB drive as first boot device.
- Configure power‑on after power loss (recommended).
4. **Boot from USB** and wait for Zero‑OS to provision and join the grid.
## Step 4: Verify Node Status
After boot, the node should appear in your farm overview.
Check via:
- **ThreeFold Connect app** – See your farm and node status.
- **Dashboard** – [dashboard.grid.tf](https://dashboard.grid.tf) shows node details, uptime, and capacity.
If the node does not show up:
- Wait 10–15 minutes for initial registration.
- Double‑check the network cable and router.
- Confirm the correct Farm ID is used.
- Reboot the node and verify BIOS boot order.
## Monitoring & Growth
Once your node is online, you’re effectively a hoster – your capacity can be used by workloads launched via Mycelium Cloud and other tooling.
### Monitor Your Farm
- **ThreeFold Connect** – Quick view of node status and balances.
- **Dashboard** – Detailed node metrics, capacity, and utilization.
- **Community** – Use the Telegram farmers/hosters group for peer support.
### Expand Over Time
- Start with a single node until you’re comfortable.
- Add more nodes to the same farm to increase capacity and earning potential.
- Experiment with **Edge Compute** or **Edge AI** nodes for higher‑value workloads.
## Troubleshooting Quick Answers
**Node not appearing?**
- Wait a bit longer, check network connectivity, and confirm Farm ID.
- Ensure the router/firewall is not blocking outbound connections.
**DIY node won’t boot Zero‑OS?**
- Re‑flash the USB image.
- Check BIOS for correct boot order and virtualization settings.
- Try another USB drive or port.
## Deep‑Dive Guides
For full, step‑by‑step instructions (with screenshots and corner cases), use the official farming manuals (the terminology there still says *farmer*):
:::info Comprehensive Setup Guides
**Pre‑Built Node Setup**
[manual.grid.tf/farmers/category/buy-a-3node](https://manual.grid.tf/farmers/category/buy-a-3node)
**DIY Node Build Guide**
[manual.grid.tf/farmers/category/build-a-3node](https://manual.grid.tf/farmers/category/build-a-3node)
These include BIOS details, advanced troubleshooting, and more.
:::
## What’s Next?
🎉 **Your hosting node is now part of the grid.**
From here you can:
- Learn about rewards and SPORE in **[Hosting Economics](/hosters/economics)**.
- Consider adding capacity or upgrading hardware.
- Join the community for tips, monitoring strategies, and best practices.
:::tip Need Help?
The **Farmers / Hosters Community** at [t.me/threefoldfarmers](https://t.me/threefoldfarmers) has experienced operators who can help you debug setup issues and optimize your configuration.
:::
Stay tuned in the docs and community channels for updates.