Getting Started
# ZeroTier Remote Access Guide
This guide explains how any team member canto connect to the NFE OpenEMS Raspberry Pi from anywhere in the world using ZeroTier. It covers both SSH access (Mac Terminal) and graphicaltroubleshooting accesscommon (VNCissues.
Viewer).
==================================================================
---
## Table of Contents
1. PREREQUISITES[Prerequisites](#prerequisites)
2. [Network Information](#network-information)
3. [Installing ZeroTier on Your Computer](#installing-zerotier-on-your-computer)
4. [Joining the Network](#joining-the-network)
5. [SSH Access to Raspberry Pi](#ssh-access-to-raspberry-pi)
6. [Troubleshooting](#troubleshooting)
7. [Setting Up ZeroTier on a New Raspberry Pi](#setting-up-zerotier-on-a-new-raspberry-pi)
==================================================================
---
## Prerequisites
Before starting, theyou teamneed:
member needs:
•- A Mac or Windows laptop
•- A ZeroTier account (free)free
•at https://my.zerotier.com)
- ZeroTier One installed
•on SSHyour orcomputer
VNC- enabledNetwork onauthorization from the network administrator
---
## Network Information
**Network ID:** `2873fd00f2d70904`
**Network Name:** `my-first-network`
**Raspberry Pi ZeroTier IP:** `10.135.127.86`
**Raspberry Pi Username:** `nfetestpi2`
•
The---
Network
ID## fromInstalling Hillary:ZeroTier 1d719394043ed7b9on Your ==================================================================Computer
2.
INSTALL### ZEROTIERMac:
ON YOUR DEVICE
==================================================================
Mac:
1. Download ZeroTier One: https://www.zerotier.com/download/
2. Install it normally.
normally
3. After installation, click the ZeroTier icon will appear in the top-right menu bar.bar
4.
It### shouldWindows:
show your Device ID.
Windows:
1. Download ZeroTier from thehttps://www.zerotier.com/download/
same link above.
2. Install and launch it.
it
3. ZeroTier icon will appear in the taskbar.system ==================================================================tray
3.
JOIN---
THE
COMPANY## ZEROTIERJoining NETWORKthe Network
==================================================================
### Method 1: Using the ZeroTier Menu (Mac - Recommended)
1. Click the ZeroTier icon onin your computer.
menu bar
2. ChooseYou'll “Joinsee Network…”
"My Address:" with your device ID
3. EnterClick on the network ID:ID `2873fd00f2d70904` if it's already listed
4. Or select "Join New Network..." and enter: `2873fd00f2d70904`
5. The status will show "REQUESTING_CONFIGURATION"
### 1d719394043ed7b9Method 2: Using Command Line
Mac/Linux:
```bash
sudo zerotier-cli join 2873fd00f2d70904
```
Windows (run as Administrator):
```cmd
zerotier-cli join 2873fd00f2d70904
```
### Authorization
After joining, you need to be authorized:
1. Contact the network administrator
2. Provide them with your device's MAC address or Device ID
3. They will authorize your device at https://my.zerotier.com
4. ClickOnce Join.authorized, your device will receive an IP address like `10.135.127.xxx`
5.
Tell### HillaryVerify soConnection
he
Mac/Linux:
```bash
sudo zerotier-cli listnetworks
```
You should see:
```
200 listnetworks 2873fd00f2d70904 my-first-network ... OK PRIVATE ... 10.135.127.xxx/24
```
The status should show **OK** and you should have an IP address assigned.
---
## SSH Access to Raspberry Pi
Once connected to the ZeroTier network, you can approveSSH yourto device.the Raspberry Pi:
6.
Once```bash
approved,ssh nfetestpi2@10.135.127.86
```
Enter the password when prompted.
**Note:** If you get a password prompt but it keeps failing, try using the `-v` flag for verbose output:
```bash
ssh -v nfetestpi2@10.135.127.86
```
### Optional: Set Up SSH Keys (Recommended)
To avoid entering passwords every time:
1. Generate SSH key on your computer will(if receiveyou adon't virtualhave IPone):
like:```bash
ssh-keygen -t ed25519 -C "your-email@example.com"
```
2. 192.168.192.xxxCopy ==================================================================your public key:
```bash
cat ~/.ssh/id_ed25519.pub
```
4.
FIND3. THEAdd RASPBERRY PI'S ZEROTIER IP
==================================================================
The Pi is already joinedit to the network.Pi's authorized keys (via SSH or Raspberry Pi Connect):
```bash
mkdir -p ~/.ssh
nano ~/.ssh/authorized_keys
# Paste your public key, save and exit
Its
# Set correct permissions
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
```
4. Now you can SSH without a password:
```bash
ssh nfetestpi2@10.135.127.86
```
---
## Troubleshooting
### Issue: ZeroTier IPshows is:"REQUESTING_CONFIGURATION"
192.168.192.83
==================================================================
**Cause:** Your device hasn't been authorized on the network yet.
5.
**Solution:**
1. Go to https://my.zerotier.com
2. Log in and navigate to network `2873fd00f2d70904`
3. Click "Member Devices" tab
4. Find your device and check the "Auth" checkbox
### Issue: ZeroTier shows "OFFLINE"
**Cause:** ZeroTier service isn't running properly.
**Solution for Mac:**
```bash
# Restart ZeroTier service
sudo launchctl unload /Library/LaunchDaemons/com.zerotier.one.plist
sudo launchctl load /Library/LaunchDaemons/com.zerotier.one.plist
# Verify it's online
sudo zerotier-cli info
```
You should see:
```
200 info <device-id> 1.16.0 ONLINE
```
**Solution for Windows:**
- Restart the ZeroTier service from Services (services.msc)
- Or restart the ZeroTier One application
### Issue: Can't ping or SSH ACCESSto (MACRaspberry TERMINAL)Pi
==================================================================
**Symptoms:**
```bash
ping 10.135.127.86
# Shows: "No route to host" or "Request timeout"
```
**Solutions:**
1. Open**Check Terminal.if ZeroTier is running on both devices:**
```bash
sudo zerotier-cli info
# Should show: ONLINE
```
2. Run:**Verify both devices are on the same network:**
```bash
sudo zerotier-cli listnetworks
# Both should show network 2873fd00f2d70904 with status OK
```
ssh pi@192.168.192.83
3. If**Try promptedchanging WiFi networks:**
Sometimes the initial WiFi network blocks ZeroTier's peer-to-peer connections. Try connecting to a different WiFi network or mobile hotspot.
4. **Check for RELAY connection:**
```bash
sudo zerotier-cli peers
```
If the password:Pi shows as "RELAY" instead of "DIRECT", there's a NAT traversal issue. Try:
- Restarting ZeroTier on both devices
- Leaving and rejoining the network
- Changing WiFi networks
5. pi**Restart userZeroTier on both devices:**
Mac:
```bash
sudo launchctl unload /Library/LaunchDaemons/com.zerotier.one.plist
sudo launchctl load /Library/LaunchDaemons/com.zerotier.one.plist
```
Raspberry Pi (via Raspberry Pi Connect):
```bash
sudo systemctl restart zerotier-one
```
6. **Leave old networks:**
If you have multiple networks joined, leave unused ones:
```bash
# List networks
sudo zerotier-cli listnetworks
# Leave old network
sudo zerotier-cli leave <old-network-id>
```
### Issue: SSH password keeps failing
**Solutions:**
1. Try verbose SSH to see what's happening:
```bash
ssh -v nfetestpi2@10.135.127.86
```
2. Make sure you're using the correct username (provided`nfetestpi2`, privately)not `pi`)
4.
You3. areSet nowup remotelySSH insidekeys instead (see SSH Keys section above)
---
## Setting Up ZeroTier on a New Raspberry Pi
If you need to set up ZeroTier on a new Raspberry Pi, follow these steps:
### Prerequisites
- Raspberry Pi with Raspberry Pi OS installed
- Internet connection
- Access to the Pi (via Raspberry Pi Connect, monitor/keyboard, or local SSH)
### Installation Steps
1. **Install ZeroTier on the Raspberry Pi.Pi:**
==================================================================
```bash
curl -s https://install.zerotier.com | sudo bash
```
2. **Join the network:**
```bash
sudo zerotier-cli join 2873fd00f2d70904
```
3. **Verify the Pi joined:**
```bash
sudo zerotier-cli listnetworks
```
You'll see status as "ACCESS_DENIED" initially.
4. **Authorize the Pi:**
- Go to https://my.zerotier.com
- Log in and navigate to network `2873fd00f2d70904`
- Click "Member Devices" tab
- Find the new Pi device (you can identify it by the MAC address or hostname)
- Check the "Auth" checkbox
- Note the "Managed IP" assigned to the Pi (e.g., `10.135.127.xxx`)
5. **Verify connection:**
```bash
sudo zerotier-cli listnetworks
```
Should now show:
```
200 listnetworks 2873fd00f2d70904 my-first-network ... OK PRIVATE ztxxxxxx 10.135.127.xxx/24
```
6. **Enable SSH (if not already enabled):**
```bash
sudo systemctl enable ssh
sudo systemctl start ssh
```
7. **Make ZeroTier start on boot:**
```bash
sudo systemctl enable zerotier-one
```
8. **Test connection from another device:**
```bash
# From your computer (already on ZeroTier network)
ping <new-pi-ip>
ssh <username>@<new-pi-ip>
```
9. **Update this documentation** with the new Pi's IP address!
---
## Advanced: VNC ACCESSAccess (REMOTERemote DESKTOP)Desktop)
==================================================================
If you need graphical access to the Raspberry Pi:
1. **Enable VNC on the Pi:**
```bash
sudo raspi-config
# Navigate to: Interface Options → VNC → Enable
```
2. **Install VNC Viewer:Viewer on your computer:**
https://www.realvnc.com/en/connect/download/viewer/
2.
Open it.
3. In**Connect the address box, enter:
192.168.192.83
4. Click Connect.
5. Enter the Pi login username & password.
6. You now have full graphical remote access.
==================================================================
7. TROUBLESHOOTING
==================================================================
• If ZeroTier shows “Not authorized,” ask Hillary to approve your device.
• If you cannot SSH, confirm:
– ZeroTier shows “Online”
– Pi is powered & connected
• If VNC fails:
– Make sure VNC is enabled on the Pi
– Useusing the ZeroTier IP,IP:**
not- theOpen homeVNC WiFiViewer
IP- ==================================================================Enter: `10.135.127.86`
- Enter Pi username and password
8.
CONTACT---
==================================================================
## Contact
For network authorization or configuration updates:issues, contact the network administrator.
Contact:
Hillary**Network ArindaManagement:** https://my.zerotier.com/network/2873fd00f2d70904
---
## Quick Reference
### Useful Commands
```bash
# Check ZeroTier status
sudo zerotier-cli info
# List joined networks
sudo zerotier-cli listnetworks
# Join a network
sudo zerotier-cli join <network-id>
# Leave a network
sudo zerotier-cli leave <network-id>
# Check peer connections
sudo zerotier-cli peers
# SSH to Raspberry Pi
ssh nfetestpi2@10.135.127.86
```
### Network Details
- **Network ID:** `2873fd00f2d70904`
- **Network Name:** `my-first-network`
- **Pi IP:** `10.135.127.86`
- **Pi Username:** `nfetestpi2`
---
*Last updated: 2026-03-28*
# ZeroTier Remote Access Guide
This guide explains how any team member canto connect to the NFE OpenEMS Raspberry Pi from anywhere in the world using ZeroTier. It covers both SSH access (Mac Terminal) and graphicaltroubleshooting accesscommon (VNCissues.
==================================================================
---
## Table of Contents
1. PREREQUISITES[Prerequisites](#prerequisites)
2. [Network Information](#network-information)
3. [Installing ZeroTier on Your Computer](#installing-zerotier-on-your-computer)
4. [Joining the Network](#joining-the-network)
5. [SSH Access to Raspberry Pi](#ssh-access-to-raspberry-pi)
6. [Troubleshooting](#troubleshooting)
7. [Setting Up ZeroTier on a New Raspberry Pi](#setting-up-zerotier-on-a-new-raspberry-pi)
---
## Prerequisites
Before starting, theyou teamneed:
- A Mac or Windows laptop
- A ZeroTier account (free)free
•at https://my.zerotier.com)
- ZeroTier One installed
•on SSHyour orcomputer
- enabledNetwork onauthorization from the network administrator
---
## Network Information
**Network ID:** `2873fd00f2d70904`
**Network Name:** `my-first-network`
**Raspberry Pi ZeroTier IP:** `10.135.127.86`
**Raspberry Pi Username:** `nfetestpi2`
---
## fromInstalling Hillary:ZeroTier 1d719394043ed7b9on Your
==================================================================Computer
### ZEROTIERMac:
1. Download ZeroTier One: https://www.zerotier.com/download/
2. Install it normally.
normally
normally
3. After installation, click the ZeroTier icon will appear in the top-right menu bar.bar
### shouldWindows:
Windows:
1. Download ZeroTier from thehttps://www.zerotier.com/download/
2. Install and launch it.
it
it
3. ZeroTier icon will appear in the taskbar.system
==================================================================tray
---
## ZEROTIERJoining NETWORKthe Network
### Method 1: Using the ZeroTier Menu (Mac - Recommended)
1. Click the ZeroTier icon onin your computer.
menu bar
menu bar
2. ChooseYou'll “Joinsee Network…”
"My Address:" with your device ID
"My Address:" with your device ID
3. EnterClick on the network ID:ID `2873fd00f2d70904` if it's already listed
4. Or select "Join New Network..." and enter: `2873fd00f2d70904`
5. The status will show "REQUESTING_CONFIGURATION"
### 1d719394043ed7b9Method 2: Using Command Line
Mac/Linux:
```bash
sudo zerotier-cli join 2873fd00f2d70904
```
Windows (run as Administrator):
```cmd
zerotier-cli join 2873fd00f2d70904
```
### Authorization
After joining, you need to be authorized:
1. Contact the network administrator
2. Provide them with your device's MAC address or Device ID
3. They will authorize your device at https://my.zerotier.com
4. ClickOnce Join.authorized, your device will receive an IP address like `10.135.127.xxx`
### HillaryVerify soConnection
Mac/Linux:
```bash
sudo zerotier-cli listnetworks
```
You should see:
```
200 listnetworks 2873fd00f2d70904 my-first-network ... OK PRIVATE ... 10.135.127.xxx/24
```
The status should show **OK** and you should have an IP address assigned.
---
## SSH Access to Raspberry Pi
Once connected to the ZeroTier network, you can approveSSH yourto device.the Raspberry Pi:
```bash
ssh nfetestpi2@10.135.127.86
```
Enter the password when prompted.
**Note:** If you get a password prompt but it keeps failing, try using the `-v` flag for verbose output:
```bash
ssh -v nfetestpi2@10.135.127.86
```
### Optional: Set Up SSH Keys (Recommended)
To avoid entering passwords every time:
1. Generate SSH key on your computer will(if receiveyou adon't virtualhave IPone):
```bash
ssh-keygen -t ed25519 -C "your-email@example.com"
```
2. 192.168.192.xxxCopy
==================================================================your public key:
```bash
cat ~/.ssh/id_ed25519.pub
```
3. THEAdd RASPBERRY PI'S ZEROTIER IP
==================================================================
The Pi is already joinedit to the network.Pi's authorized keys (via SSH or Raspberry Pi Connect):
```bash
mkdir -p ~/.ssh
nano ~/.ssh/authorized_keys
# Paste your public key, save and exit
# Set correct permissions
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
```
4. Now you can SSH without a password:
```bash
ssh nfetestpi2@10.135.127.86
```
---
## Troubleshooting
### Issue: ZeroTier IPshows is:"REQUESTING_CONFIGURATION"
==================================================================
**Cause:** Your device hasn't been authorized on the network yet.
**Solution:**
1. Go to https://my.zerotier.com
2. Log in and navigate to network `2873fd00f2d70904`
3. Click "Member Devices" tab
4. Find your device and check the "Auth" checkbox
### Issue: ZeroTier shows "OFFLINE"
**Cause:** ZeroTier service isn't running properly.
**Solution for Mac:**
```bash
# Restart ZeroTier service
sudo launchctl unload /Library/LaunchDaemons/com.zerotier.one.plist
sudo launchctl load /Library/LaunchDaemons/com.zerotier.one.plist
# Verify it's online
sudo zerotier-cli info
```
You should see:
```
200 info <device-id> 1.16.0 ONLINE
```
**Solution for Windows:**
- Restart the ZeroTier service from Services (services.msc)
- Or restart the ZeroTier One application
### Issue: Can't ping or SSH ACCESSto (MACRaspberry TERMINAL)Pi
**Symptoms:**
```bash
ping 10.135.127.86
# Shows: "No route to host" or "Request timeout"
```
**Solutions:**
1. Open**Check Terminal.if ZeroTier is running on both devices:**
```bash
sudo zerotier-cli info
# Should show: ONLINE
```
2. Run:**Verify both devices are on the same network:**
```bash
sudo zerotier-cli listnetworks
# Both should show network 2873fd00f2d70904 with status OK
```
3. If**Try promptedchanging WiFi networks:**
Sometimes the initial WiFi network blocks ZeroTier's peer-to-peer connections. Try connecting to a different WiFi network or mobile hotspot.
4. **Check for RELAY connection:**
```bash
sudo zerotier-cli peers
```
If the password:Pi shows as "RELAY" instead of "DIRECT", there's a NAT traversal issue. Try:
- Restarting ZeroTier on both devices
- Leaving and rejoining the network
- Changing WiFi networks
5. pi**Restart userZeroTier on both devices:**
Mac:
```bash
sudo launchctl unload /Library/LaunchDaemons/com.zerotier.one.plist
sudo launchctl load /Library/LaunchDaemons/com.zerotier.one.plist
```
Raspberry Pi (via Raspberry Pi Connect):
```bash
sudo systemctl restart zerotier-one
```
6. **Leave old networks:**
If you have multiple networks joined, leave unused ones:
```bash
# List networks
sudo zerotier-cli listnetworks
# Leave old network
sudo zerotier-cli leave <old-network-id>
```
### Issue: SSH password keeps failing
**Solutions:**
1. Try verbose SSH to see what's happening:
```bash
ssh -v nfetestpi2@10.135.127.86
```
2. Make sure you're using the correct username (provided`nfetestpi2`, privately)not `pi`)
3. areSet nowup remotelySSH insidekeys instead (see SSH Keys section above)
---
## Setting Up ZeroTier on a New Raspberry Pi
If you need to set up ZeroTier on a new Raspberry Pi, follow these steps:
### Prerequisites
- Raspberry Pi with Raspberry Pi OS installed
- Internet connection
- Access to the Pi (via Raspberry Pi Connect, monitor/keyboard, or local SSH)
### Installation Steps
1. **Install ZeroTier on the Raspberry Pi.Pi:**
==================================================================
```bash
curl -s https://install.zerotier.com | sudo bash
```
2. **Join the network:**
```bash
sudo zerotier-cli join 2873fd00f2d70904
```
3. **Verify the Pi joined:**
```bash
sudo zerotier-cli listnetworks
```
You'll see status as "ACCESS_DENIED" initially.
4. **Authorize the Pi:**
- Go to https://my.zerotier.com
- Log in and navigate to network `2873fd00f2d70904`
- Click "Member Devices" tab
- Find the new Pi device (you can identify it by the MAC address or hostname)
- Check the "Auth" checkbox
- Note the "Managed IP" assigned to the Pi (e.g., `10.135.127.xxx`)
5. **Verify connection:**
```bash
sudo zerotier-cli listnetworks
```
Should now show:
```
200 listnetworks 2873fd00f2d70904 my-first-network ... OK PRIVATE ztxxxxxx 10.135.127.xxx/24
```
6. **Enable SSH (if not already enabled):**
```bash
sudo systemctl enable ssh
sudo systemctl start ssh
```
7. **Make ZeroTier start on boot:**
```bash
sudo systemctl enable zerotier-one
```
8. **Test connection from another device:**
```bash
# From your computer (already on ZeroTier network)
ping <new-pi-ip>
ssh <username>@<new-pi-ip>
```
9. **Update this documentation** with the new Pi's IP address!
---
## Advanced: VNC ACCESSAccess (REMOTERemote DESKTOP)Desktop)
If you need graphical access to the Raspberry Pi:
1. **Enable VNC on the Pi:**
```bash
sudo raspi-config
# Navigate to: Interface Options → VNC → Enable
```
2. **Install VNC Viewer:Viewer on your computer:**
https://www.realvnc.com/en/connect/download/viewer/
3. In**Connect the address box, enter:
192.168.192.83
4. Click Connect.
5. Enter the Pi login username & password.
6. You now have full graphical remote access.
==================================================================7. TROUBLESHOOTING==================================================================• If ZeroTier shows “Not authorized,” ask Hillary to approve your device.• If you cannot SSH, confirm: – ZeroTier shows “Online” – Pi is powered & connected• If VNC fails: – Make sure VNC is enabled on the Pi – Useusing the ZeroTier IP,IP:**
- theOpen homeVNC WiFiViewer
-
==================================================================Enter: `10.135.127.86`
- Enter Pi username and password
---
## Contact
For network authorization or configuration updates:issues, contact the network administrator.
**Network ArindaManagement:**
https://my.zerotier.com/network/2873fd00f2d70904
---
## Quick Reference
### Useful Commands
```bash
# Check ZeroTier status
sudo zerotier-cli info
# List joined networks
sudo zerotier-cli listnetworks
# Join a network
sudo zerotier-cli join <network-id>
# Leave a network
sudo zerotier-cli leave <network-id>
# Check peer connections
sudo zerotier-cli peers
# SSH to Raspberry Pi
ssh nfetestpi2@10.135.127.86
```
### Network Details
- **Network ID:** `2873fd00f2d70904`
- **Network Name:** `my-first-network`
- **Pi IP:** `10.135.127.86`
- **Pi Username:** `nfetestpi2`
---
*Last updated: 2026-03-28*