Devices
A device is a machine you have registered so it can reach your labs over the private tunnel. This page covers looking after devices once you have them.
Follow Connect your device — it walks through installing WireGuard, registering, and testing the tunnel.
Go to Connectivity → My Devices.
Reading a device card
| Field | Meaning |
|---|---|
| Status | Online (green) — the tunnel is up. Unreachable (amber) or Offline (red) — the device has not been heard from recently; activate the tunnel on that machine. |
| Interface chip | Which network the device is on. The shared network is the default. |
| Device IP | The device's address inside the private network |
| Origin IP | Where the tunnel last connected from |
| Sent / Received | Traffic through the tunnel |
| Reserved | This address is kept for the device (below) |
Keep the same address: reserve it
Without a reservation, a device can be given a different address later. If you have scripts, firewall rules or bookmarks that point at a device's address, reserve it.
- Reserve IP in the device's menu keeps the current address.
- Unreserve IP gives it up. The address goes back to the pool and the device may get a different one next time.
You can also tick Reserve IP when Allocated when you add a device. Reserved addresses are listed under My Network → IP Addresses — see Private networks.
Get the configuration again
From the device's menu:
| Item | What you get |
|---|---|
| Show Configuration | The tunnel config as text, with Copy and Download Tunnel File |
| Show QR Code | A QR code for the mobile WireGuard app |
| Download Tunnel File | A .conf file for the desktop app |
If you supplied your own key
When you registered with your own public key instead of Auto Generate
Keypair, the platform never saw your private key. The configuration then
contains a {private_key} placeholder that you fill in on your machine, and
Show QR Code / Download Tunnel File are not offered — any QR code is
built in your browser and not stored.
To switch a device between the two modes, delete it and add it again.
Delete a device
Delete in the device's menu removes it and cuts its tunnel. Its address is released unless it is reserved.
Delete devices you no longer use — it is also how you free a slot when you reach the limit.
Limits
The Limit: N / M counter under Add Device shows how many you have used. Every account can register 5 devices by default; your administrator can change that for you. At the limit, Add Device is greyed out.
Labs appear here too
A running lab connected to the private network shows up in this list as a device of type Lab. That is expected — it is how your devices and your labs see each other. You do not need to manage these entries yourself.
When your plan or activity changes
| Situation | What happens to devices |
|---|---|
| Your plan is downgraded and you now have more devices than the new limit allows | The newest devices over the limit are disconnected. Their records are kept, and you get a Plan changed notification. Delete the ones you do not need. |
| A free account is inactive for a year | Devices are suspended along with your storage. Signing in again restores them. |
Common errors
| Message | Fix |
|---|---|
| You reached a rate limit. Please delete existing objects to continue. | You are at the device limit. Delete one first. |
| …conflicts with a device that is already registered… | That public key is already in use. Generate a new key pair for this machine. |
Do it with an AI assistant
You can also do this by asking an AI assistant connected to your account — see Connect an AI assistant to set one up.
| Ask | What the assistant does |
|---|---|
| “List my devices and when each last connected” | list_devices |
| “Give me the WireGuard config for my laptop again” | Finds the device with list_devices, then device_config |
| “Add my new desktop” | add_device, then device_config |
| “Remove my old phone” | list_devices, then delete_device |
A config the platform generated includes the device's private key. Reserving an address is done in the dashboard. Device tools work on every plan, including free.
Next
- Private networks — reserved addresses and extra networks
- Cannot connect — when the tunnel will not come up