Settings

The system settings configure the behavior of DATAZONE Control. Access them via the gear icon in the navigation bar.

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:

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

1. Settings > Customers
2. Click Add Customer
3. Enter the customer name
4. Save

Customer Filtering

The customer filter in the main navigation affects all views:

• All Customers - Complete overview
• Specific Customer - Only hosts belonging to that customer

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_control

Recommendation

Set up automatic database backups, e.g., via a cron job or through a PBS backup job.