Skip to content

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:

  1. Navigate to Settings > General
  2. Click Generate Token
  3. Copy the token
  4. 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:

FieldDescription
SMTP ServerHostname of the mail server
PortSMTP port (587 for STARTTLS, 465 for SSL)
UsernameSMTP login
PasswordSMTP password
SenderEmail sender address

API Settings ​

Configuration for external API access:

FieldDescription
CORS OriginsAllowed origins for API access
Rate LimitingRequest limit per time period

Customer Management ​

Customers organize your hosts in a multi-tenant structure.

Creating a Customer ​

  1. Settings > Customers
  2. Click Add Customer
  3. Enter the customer name
  4. 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 ​

bash
curl -sSL https://control.yourdomain.com/agent/linux-install.sh | bash -s -- --token <TOKEN>

Proxmox VE ​

bash
curl -sSL https://control.yourdomain.com/agent/pve-install.sh | bash -s -- --token <TOKEN>

Proxmox Backup Server ​

bash
curl -sSL https://control.yourdomain.com/agent/pbs-install.sh | bash -s -- --token <TOKEN>

OPNsense (FreeBSD) ​

bash
fetch -o - https://control.yourdomain.com/agent/opnsense-install.sh | sh -s -- --token <TOKEN>

Windows (PowerShell) ​

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:

ParameterDescriptionDefault
Agent Heartbeat IntervalInterval between agent heartbeats30 seconds
Offline TimeoutWhen a host is considered offline120 seconds
Tunnel Port RangePort range for tunnels20000-25000
Session TimeoutAutomatic logout after inactivity24 hours

Data Backup ​

Database Backup ​

The PostgreSQL database should be backed up regularly:

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

Recommendation

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.

DATAZONE Control Documentation