190 lines
4.7 KiB
Markdown
190 lines
4.7 KiB
Markdown
---
|
|
sidebar_position: 2
|
|
---
|
|
|
|
# Install Mycelium Network
|
|
|
|
The Mycelium app is available for Android, Windows, macOS, and iOS. Installation is simple and user-friendly!
|
|
|
|
## Easy Installation (Recommended)
|
|
|
|
### iOS & macOS
|
|
|
|
Download the Mycelium app from the App Store:
|
|
|
|
**[Download from App Store](https://apps.apple.com/app/id6504277565)**
|
|
|
|
1. Open the App Store
|
|
2. Search for "Mycelium" or use the link above
|
|
3. Tap **Get** or **Install**
|
|
4. Open the app and you're ready to go!
|
|
|
|
### Android
|
|
|
|
Download the Mycelium app from Google Play:
|
|
|
|
**[Download from Google Play](https://play.google.com/store/apps/details?id=tech.threefold.mycelium)**
|
|
|
|
1. Open Google Play Store
|
|
2. Search for "Mycelium ThreeFold" or use the link above
|
|
3. Tap **Install**
|
|
4. Open the app and you're ready to go!
|
|
|
|
### Windows
|
|
|
|
Download the latest Windows app:
|
|
|
|
**[Download for Windows](https://github.com/threefoldtech/myceliumflut/releases)**
|
|
|
|
1. Go to the releases page
|
|
2. Download the latest `.exe` file
|
|
3. Double-click to install
|
|
4. **Important**: Run as administrator for proper network connectivity
|
|
|
|
<div className="info-box">
|
|
|
|
### 💡 Super Simple!
|
|
|
|
The Mycelium app provides an easy graphical interface - no command-line needed. Just install, open, and start connecting!
|
|
|
|
</div>
|
|
|
|
## What You Get
|
|
|
|
With the Mycelium app, you get:
|
|
|
|
- ✅ **Easy interface** - One-click to start/stop
|
|
- ✅ **Automatic setup** - No configuration needed
|
|
- ✅ **Peer management** - Add peers with a click
|
|
- ✅ **Your Mycelium address** - Copy with one tap
|
|
- ✅ **Status monitoring** - See connection status
|
|
|
|
## Linux Installation (Advanced)
|
|
|
|
For Linux users, Mycelium is installed via command-line.
|
|
|
|
### Using Pre-built Binaries (Recommended)
|
|
|
|
1. **Download the latest release:**
|
|
```bash
|
|
wget https://github.com/threefoldtech/mycelium/releases/latest/download/mycelium-linux-x64.tar.gz
|
|
```
|
|
|
|
2. **Extract and install:**
|
|
```bash
|
|
tar -xzf mycelium-linux-x64.tar.gz
|
|
chmod +x mycelium
|
|
sudo mv mycelium /usr/local/bin/
|
|
```
|
|
|
|
3. **Verify installation:**
|
|
```bash
|
|
mycelium --version
|
|
```
|
|
|
|
### Building from Source
|
|
|
|
If you prefer to build from source:
|
|
|
|
```bash
|
|
# Install Rust if you haven't already
|
|
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
|
|
|
|
# Clone and build
|
|
git clone https://github.com/threefoldtech/mycelium.git
|
|
cd mycelium/myceliumd
|
|
cargo build --release
|
|
|
|
# Install binary
|
|
sudo mv target/release/myceliumd /usr/local/bin/mycelium
|
|
```
|
|
|
|
## Docker Installation (Advanced)
|
|
|
|
Run Mycelium in a container:
|
|
|
|
```bash
|
|
docker run -d \
|
|
--name mycelium \
|
|
--cap-add NET_ADMIN \
|
|
--device /dev/net/tun \
|
|
--sysctl net.ipv6.conf.all.disable_ipv6=0 \
|
|
threefoldtech/mycelium:latest \
|
|
--peers tcp://188.40.132.242:9651
|
|
```
|
|
|
|
## System Requirements
|
|
|
|
### For Apps (iOS, Android, macOS, Windows)
|
|
|
|
- **OS**: iOS 14+, Android 8+, macOS 11+, Windows 10+
|
|
- **RAM**: Minimal (runs in background)
|
|
- **Disk**: ~50MB
|
|
- **Network**: Standard internet connection
|
|
|
|
### For Linux Command-Line
|
|
|
|
- **OS**: Any modern Linux distribution
|
|
- **RAM**: 50MB
|
|
- **Disk**: 20MB
|
|
- **Network**: IPv6 support (enabled by default on most systems)
|
|
|
|
## Troubleshooting
|
|
|
|
### App Not Starting (Windows)
|
|
|
|
**Windows users**: The app must run as administrator for network connectivity.
|
|
- Right-click the app icon
|
|
- Select "Run as administrator"
|
|
|
|
### App Not Connecting
|
|
|
|
1. **Check internet connection** - Ensure you're online
|
|
2. **Restart the app** - Close and reopen
|
|
3. **Add public peers** - Use the app's peer management (see Quick Start)
|
|
4. **Check firewall** - Ensure the app isn't blocked
|
|
|
|
### Linux Command-Line Issues
|
|
|
|
**"Command not found" Error:**
|
|
- Ensure `/usr/local/bin` is in your PATH
|
|
- Try running with full path: `/usr/local/bin/mycelium`
|
|
- Check file permissions: `ls -l /usr/local/bin/mycelium`
|
|
|
|
**Permission Denied:**
|
|
```bash
|
|
# Make the binary executable
|
|
chmod +x /usr/local/bin/mycelium
|
|
|
|
# Run with sudo for network operations
|
|
sudo mycelium --peers tcp://188.40.132.242:9651
|
|
```
|
|
|
|
**IPv6 Not Available:**
|
|
```bash
|
|
# Check if IPv6 is enabled
|
|
cat /proc/sys/net/ipv6/conf/all/disable_ipv6
|
|
|
|
# Enable if needed (0 = enabled)
|
|
sudo sysctl -w net.ipv6.conf.all.disable_ipv6=0
|
|
```
|
|
|
|
## What's Next?
|
|
|
|
Now that Mycelium is installed, let's connect to the network:
|
|
|
|
**[Quick Start Guide](/getstarted/mycelium-network/quick-start)** - Connect in 5 minutes
|
|
|
|
## Additional Resources
|
|
|
|
- **Full User Guide**: [threefoldtech.github.io/www_myceliumguide](https://threefoldtech.github.io/www_myceliumguide/)
|
|
- **GitHub Repository**: [github.com/threefoldtech/mycelium](https://github.com/threefoldtech/mycelium)
|
|
- **Technical Docs**: Available in the repository
|
|
- **Get Help**: [Telegram Community](https://t.me/threefold/1)
|
|
|
|
---
|
|
|
|
:::tip Ready to Connect?
|
|
Installation complete! Continue to the **[Quick Start](/getstarted/mycelium-network/quick-start)** guide to join the network.
|
|
:::
|