4.7 KiB
sidebar_position
| sidebar_position |
|---|
| 2 |
Install Mycelium
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:
- Open the App Store
- Search for "Mycelium" or use the link above
- Tap Get or Install
- Open the app and you're ready to go!
Android
Download the Mycelium app from Google Play:
- Open Google Play Store
- Search for "Mycelium ThreeFold" or use the link above
- Tap Install
- Open the app and you're ready to go!
Windows
Download the latest Windows app:
- Go to the releases page
- Download the latest
.exefile - Double-click to install
- Important: Run as administrator for proper network connectivity
💡 Super Simple!
The Mycelium app provides an easy graphical interface - no command-line needed. Just install, open, and start connecting!
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)
-
Download the latest release:
wget https://github.com/threefoldtech/mycelium/releases/latest/download/mycelium-linux-x64.tar.gz -
Extract and install:
tar -xzf mycelium-linux-x64.tar.gz chmod +x mycelium sudo mv mycelium /usr/local/bin/ -
Verify installation:
mycelium --version
Building from Source
If you prefer to build from source:
# 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:
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
- Check internet connection - Ensure you're online
- Restart the app - Close and reopen
- Add public peers - Use the app's peer management (see Quick Start)
- Check firewall - Ensure the app isn't blocked
Linux Command-Line Issues
"Command not found" Error:
- Ensure
/usr/local/binis in your PATH - Try running with full path:
/usr/local/bin/mycelium - Check file permissions:
ls -l /usr/local/bin/mycelium
Permission Denied:
# 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:
# 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 - Connect in 5 minutes
Additional Resources
- Full User Guide: threefoldtech.github.io/www_myceliumguide
- GitHub Repository: github.com/threefoldtech/mycelium
- Technical Docs: Available in the repository
- Get Help: Telegram Community
:::tip Ready to Connect? Installation complete! Continue to the Quick Start guide to join the network. :::