Settings
The system settings configure the behavior of DATAZONE Control. Open them in the sidebar under Administration → Settings.
General Settings
Onboarding Token
The onboarding token is required for automatic agent installation:
- Navigate to Settings > General
- Click Generate Token
- Copy the token
- Use it during agent installation
TIP
The token can be regenerated at any time. A new token invalidates the previous one.
SMTP Configuration
For sending reports via email:
| Field | Description |
|---|---|
| SMTP Server | Hostname of the mail server |
| Port | SMTP port (587 for STARTTLS, 465 for SSL) |
| Username | SMTP login |
| Password | SMTP password |
| Sender | Email sender address |
API Settings
Configuration for external API access:
| Field | Description |
|---|---|
| CORS Origins | Allowed origins for API access |
| Rate Limiting | Request limit per time period |
Customer Management
Customers organize your hosts in a multi-tenant structure.
Creating a Customer
- Settings > Customers
- Click Add Customer
- Enter the customer name
- Save
Deleting a customer
A customer can only be deleted when no hosts (PVE, PBS, OPNsense, Linux, Windows) and no users are assigned to it. If schedules or check assignments still reference the customer, deletion is rejected as well.
ERP integration
When the ERP integration is active, customers come from the ERP and cannot be created in Control. When a customer that was already reported is deleted, Control sends one empty full inventory so the ERP marks its features as removed.
Customer Filtering
The customer filter at the top of the sidebar (field Customer) applies to host lists, the status page, the bell and the search (Ctrl+K):
- All customers - complete overview
- Specific customer - only that customer's hosts (search by name or customer number)
The selected customer is remembered in the browser and shown in the top bar; the x there removes the filter.
Onboarding Commands
Under Settings > Onboarding you will find the installation command for each module, which is used to install the agent on a new host:
Linux
curl -sSL https://control.yourdomain.com/agent/linux-install.sh | bash -s -- --token <TOKEN>Proxmox VE
curl -sSL https://control.yourdomain.com/agent/pve-install.sh | bash -s -- --token <TOKEN>Proxmox Backup Server
curl -sSL https://control.yourdomain.com/agent/pbs-install.sh | bash -s -- --token <TOKEN>OPNsense (FreeBSD)
fetch -o - https://control.yourdomain.com/agent/opnsense-install.sh | sh -s -- --token <TOKEN>Windows (PowerShell)
irm https://control.yourdomain.com/agent/windows-install.ps1 | iex; Install-DatazoneAgent -Token "<TOKEN>"Token
The <TOKEN> is the onboarding token from the general settings. It is automatically inserted into the copied commands.
Parameters
Under Settings > Parameters you can configure advanced system parameters. These settings are stored as key-value pairs in the database.
System Scripts
DATAZONE Control includes predefined system scripts for standard operations:
- Update scripts (per module and OS)
- Restart scripts
- Information collection scripts
- Health check scripts
- Agent update scripts
- Force update scripts
System scripts cannot be edited but can be used as templates. They are marked with a lock icon.
Configuration Parameters
Advanced settings for system behavior:
| Parameter | Description | Default |
|---|---|---|
| Agent Heartbeat Interval | Interval between agent heartbeats | 30 seconds |
| Offline Timeout | When a host is considered offline | 120 seconds |
| Tunnel Port Range | Port range for tunnels | 20000-25000 |
| Session Timeout | Automatic logout after inactivity | 24 hours |
Data Backup
Database Backup
The PostgreSQL database should be backed up regularly:
# Manual backup
docker exec datazone-db pg_dump -U datazone datazone_control > backup.sql
# Restore
cat backup.sql | docker exec -i datazone-db psql -U datazone datazone_controlRecommendation
Set up automatic database backups, e.g., via a cron job or through a PBS backup job.
What's new (since v3.41.0)
The sparkle button at the top right of the header shows what has changed in Control. The number says how many changes the user has not seen yet. Opening it marks them as read. Entries marked important appear once as a notice. Entries with a module are only shown to users with access to that module, entries admins only only to administrators.
Settings > What's new (administrators only): create, edit, save as draft, publish, withdraw and delete entries, with preview. Each update adds the entries of the new version automatically. Deleted entries do not come back.