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

---
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

<div className="info-box">

### 💡 That's It!

The app handles everything automatically. No configuration needed!

</div>

### 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

```bash
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:

```bash
mycelium inspect --json
```

You'll see output like:
```json
{
  "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:

```bash
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:**
```bash
# 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`:
```ini
[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:
```bash
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:

```bash
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:

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

### Access a Web Service

```bash
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](https://dashboard.grid.tf) 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

Check the [detailed Mycelium guide](https://threefoldtech.github.io/www_myceliumguide/) for more information.

## Resources

- **Full Documentation**: [Mycelium User Guide](https://threefoldtech.github.io/www_myceliumguide/)
- **GitHub**: [github.com/threefoldtech/mycelium](https://github.com/threefoldtech/mycelium)
- **Community**: [Telegram](https://t.me/threefold/1)
- **Forum**: [forum.threefold.io](https://forum.threefold.io)

---

:::tip Connected Successfully?

Great! You're now part of the global Mycelium network. Try deploying on **[Mycelium Cloud](../mycelium-cloud/overview)** to run workloads on the ThreeFold Grid.
:::