Sites
A site is a group of devices, usually a physical location, datacenter, or team. Once devices belong to a site, you can run profiles, deploy apps, or apply firewall rules against the whole group at once.
Overview
A site can contain any number of devices. Once a device is assigned to a site you can:
- View aggregate metrics (avg CPU, memory, disk, total bandwidth)
- Track online / offline counts at a glance
- Run provisioning profiles across all devices in one click
- Auto-deploy apps to every device that joins the site
- Apply firewall rules scoped to the site
Managing Sites
Go to Site Management in the main navigation.
Creating a Site
- Click New Site
- Fill in:
- Name — display name (e.g.,
Amsterdam Office) - Slug — URL-safe identifier (e.g.,
amsterdam-office, lowercase, hyphens only) - Description — optional free-text note
- Location — optional lat/lon for map display
- Labels — optional key-value metadata
- Click Create
Editing a Site
Click the pencil icon on a site card to update name, description, location, or labels.
Deleting a Site
Click the trash icon. Devices in the site are not deleted — they are unassigned and remain in the tenant.
Assigning Devices to a Site
From Sites → [Site Name] → Devices, click Assign Device and select from the tenant's unassigned devices.
To unassign a device, click the × next to it in the device list. The device returns to the unassigned pool.
Devices keep their site assignment across re-registrations unless the assignment is explicitly cleared.
Site Metrics
The site detail view shows aggregated metrics across all devices:
| Metric | Description |
|---|---|
| Avg CPU | Mean CPU usage across online devices |
| Avg Memory | Mean memory usage across online devices |
| Avg Disk | Mean disk usage across online devices |
| Total Rx / Tx | Summed WireGuard traffic for the site |
Provisioning Profiles
Run all eligible profiles against every device in the site at once:
- Go to Sites → [Site Name] → Profiles
- Click Run Profiles
Each device in the site is matched against its tags and all applicable profiles are queued. Results appear in the profile run history per device.
Auto-Deploy
Sites support automatic app deployment — whenever a new device joins the site, selected apps are deployed to it automatically.
- Go to Sites → [Site Name] → Apps
- Toggle Auto-Deploy for any app in the catalog
- New devices assigned to the site will have those apps deployed immediately
Firewall Rules (Site Scope)
Firewall rules can be scoped to a site — they apply to all devices in the site as a group. See Firewall for details.
Sites Inventory
The Sites view (main nav) shows a live overview of all sites with device counts and online status. Click any site to drill into its devices, metrics, and apps.
API
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/sites |
List all sites |
POST |
/api/sites |
Create a site |
GET |
/api/sites/{id} |
Get site detail with devices and metrics |
PUT |
/api/sites/{id} |
Update site |
DELETE |
/api/sites/{id} |
Delete site |
POST |
/api/sites/{id}/assign |
Assign a device to the site |
POST |
/api/sites/unassign |
Unassign a device |
POST |
/api/sites/{id}/profiles/run |
Run profiles on all site devices |
POST |
/api/sites/{id}/apps/auto-deploy |
Configure auto-deploy settings |