docs_tfgrid_get_started/docs/mycelium-network/quick-start.md

sidebar_position

sidebar_position
3

Quick Start

Get connected to the Mycelium network in under 5 minutes!

Using the Mycelium App (Easy)

If you're on iOS, Android, macOS, or Windows - use the app for the easiest experience.

Step 1: Open the App

1. Open the Mycelium app you installed
2. You'll see a simple interface with a Start button

Step 2: Start Mycelium

1. Click the Start button
2. The app will automatically connect to the network
3. That's it! You're now on the Mycelium network

💡 That's It!

The app handles everything automatically. No configuration needed!

Step 3: Get Your Mycelium Address

Your unique Mycelium IPv6 address is shown in the app:

1. Look for your address in the main screen
2. Click the copy button next to it to copy your address
3. Share this address with others to let them connect to you

Step 4: Add More Peers (Optional)

For better connectivity, you can add public peers:

1. Click on the Peers section in the app
2. Add peer addresses (see list below)
3. Click Restart to connect to the new peers

Example peers to add:

tcp://188.40.132.242:9651
tcp://185.69.166.8:9651
tcp://65.21.231.58:9651

Step 5: Test Your Connection

Try connecting to another Mycelium address to verify everything works!

---

Using Command-Line (Linux & Advanced Users)

For Linux users or those who prefer the command-line:

Step 1: Start Mycelium

sudo mycelium --peers tcp://188.40.132.242:9651 quic://185.69.166.8:9651

You should see output indicating Mycelium is starting and connecting to peers.

Step 2: Get Your IPv6 Address

Open a new terminal and check your node info:

mycelium inspect --json

You'll see output like:

{
  "publicKey": "abd16194646defe7ad2318a0f0a69eb2e3fe939c3b0b51cf0bb88bb8028ecd1d",
  "address": "5c4:c176:bf44:b2ab:5e7e:f6a:b7e2:11ca"
}

Save your address - this is your unique Mycelium IPv6 address.

Step 3: Test Connectivity

Ping one of the public peers to verify connectivity:

ping6 54b:83ab:6cb5:7b38:44ae:cd14:53f3:a907

If you see responses, you're connected!

Step 4: Keep It Running (Linux)

Run in Background:

# Using nohup
nohup sudo mycelium --peers tcp://188.40.132.242:9651 quic://185.69.166.8:9651 &

Better: Use systemd:

Create /etc/systemd/system/mycelium.service:

[Unit]
Description=Mycelium Network
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/mycelium --peers tcp://188.40.132.242:9651 quic://185.69.166.8:9651
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Enable and start:

sudo systemctl enable mycelium
sudo systemctl start mycelium
sudo systemctl status mycelium

---

Public Peers List

Here are stable public peers you can connect to:

Region	Address for App	Mycelium IP
Germany	tcp://188.40.132.242:9651	54b:83ab:6cb5:7b38:44ae:cd14:53f3:a907
Germany	tcp://136.243.47.186:9651	40a:152c:b85b:9646:5b71:d03a:eb27:2462
Belgium	tcp://185.69.166.7:9651	597:a4ef:806:b09:6650:cbbf:1b68:cc94
Belgium	tcp://185.69.166.8:9651	549:8bce:fa45:e001:cbf8:f2e2:2da6:a67c
Finland	tcp://65.21.231.58:9651	410:2778:53bf:6f41:af28:1b60:d7c0:707a
Finland	tcp://65.109.18.113:9651	488:74ac:8a31:277b:9683:c8e:e14f:79a7
US East	tcp://209.159.146.190:9651	4ab:a385:5a4e:ef8f:92e0:1605:7cb6:24b2
US West	tcp://5.78.122.16:9651	4de:b695:3859:8234:d04c:5de6:8097:c27c
Singapore	tcp://5.223.43.251:9651	5eb:c711:f9ab:eb24:ff26:e392:a115:1c0e
India	tcp://142.93.217.194:9651	445:465:fe81:1e2b:5420:a029:6b0:9f61

Using the App? Just copy these addresses and paste them in the Peers section!

Using Command-Line? Add multiple peers for better reliability:

sudo mycelium --peers \
  tcp://188.40.132.242:9651 \
  tcp://185.69.166.8:9651 \
  tcp://185.69.166.7:9651 \
  tcp://65.21.231.58:9651

What You Can Do Now

SSH to Another Device

If you have SSH running on another device with Mycelium:

ssh user@5c4:c176:bf44:b2ab:5e7e:f6a:b7e2:11ca

Access a Web Service

curl http://[5c4:c176:bf44:b2ab:5e7e:f6a:b7e2:11ca]:8080

Note: IPv6 addresses must be in brackets for URLs.

Connect Multiple Devices

Run Mycelium on devices at different locations:

• They'll automatically find each other through the mesh
• Use their Mycelium IPs to communicate
• All traffic is encrypted end-to-end

Access ThreeFold Grid

Deploy workloads on the ThreeFold Grid and connect to them using your Mycelium connection. Check the ThreeFold Dashboard to deploy with Mycelium enabled.

Troubleshooting

App Not Connecting

Using the app:

1. Restart the app - Close and reopen
2. Check internet - Verify you're online
3. Add more peers - Use the Peers section to add public peers
4. Check firewall - Ensure the app isn't blocked
5. Windows: Run as administrator

Command-Line Issues

Can't Connect to Peers:

1. Check internet connection - Verify you're online
2. Try different peers - Some may be temporarily down
3. Firewall issues - Mycelium should work behind NAT, but check firewall settings
4. IPv6 support - Ensure IPv6 is enabled

Can't Ping Other Nodes:

1. Wait a few minutes - Network discovery takes time
2. Verify the address - Make sure you're pinging a valid Mycelium address
3. Check peer connections - Ensure you're connected to peers

Permission Errors (Linux):

• Must run with sudo to create network interface
• Check executable permissions: chmod +x /usr/local/bin/mycelium

What's Next?

Now that you're connected, explore what you can do:

Use Cases

• Remote Access: Access your services from anywhere
• Connect Devices: Link multiple locations securely
• ThreeFold Grid: Access your grid deployments
• P2P Applications: Build distributed systems

Advanced Configuration

For more advanced setup options:

• Custom port configuration
• Private peer networks
• SOCKS5 proxy setup
• Advanced routing options

Resources

• GitHub: github.com/threefoldtech/mycelium
• Community: Telegram
• Forum: forum.threefold.io

---

:::tip Connected Successfully?

Great! You're now part of the global Mycelium network. Try deploying on Mycelium Cloud to run workloads on the ThreeFold Grid. :::