Run URLs

Run URLs are configurable links available as quick-access shortcuts for each host in the table. They can contain variables that are dynamically replaced with host data.

Concept

A Run URL is a URL template with placeholders. When you click the URL, the placeholders are replaced with the actual values of the host and the URL is opened in the browser.

Example:

https://monitoring.company.com/host/{hostname}

Becomes for the host "web01":

https://monitoring.company.com/host/web01

Managing Run URLs

Access management via Settings > Run URLs.

Creating a Run URL

1. Click Add Run URL
2. Configure:

Field	Description
Name	Label (displayed as button/link)
URL Template	URL with {variable} placeholders
Modules	Which modules the URL is displayed for
Icon	Symbol for display (see icon list below)
Sort Order	Display order (ascending)
Enabled	On/Off toggle for the Run URL

Available Placeholders

Syntax

The correct placeholder syntax uses single curly braces: {varname} (not ).

General Variables (all modules)

Placeholder	Description	Example
{id}	Internal host ID	42
{name}	Display name of the host	Webserver 01
{hostname}	Hostname of the system	web01
{ip_address}	IP address	192.168.1.10
{description}	Description of the host	Main web server
{agent_version}	Agent version	1.3.0
{serial_number}	Hardware serial number	ABC123XYZ
{customer_name}	Customer name	Company Inc.
{customer_number}	Customer number	K-001
{customer_id}	Internal customer ID	5
{site}	Location	Data Center A
{external_ip}	External/WAN IP	203.0.113.1
{uptime}	Uptime in seconds	86400
{cpu_usage}	CPU usage in percent	45
{memory_usage}	RAM usage in percent	72
{disk_usage}	Disk usage in percent	58
{pending_updates}	Number of pending updates	3

Module-specific Variables

Placeholder	Modules	Description
{opnsense_version}	OPNsense	OPNsense version
{firmware_version}	OPNsense	Firmware version
{pve_version}	PVE	Proxmox VE version
{pbs_version}	PBS	PBS version
{kernel_version}	PVE, PBS, Linux	Kernel version
{distribution}	Linux	Distribution (e.g. Ubuntu 22.04)
{os_version}	Windows	Windows version
{domain}	Windows	Active Directory domain
{windows_display_version}	Windows	Windows build number
{windows_product_type}	Windows	Server / DC / Workstation
{rustdesk_id}	Windows	RustDesk ID (if installed)

Tip

Not all variables are populated for every host. If a value is not available, the placeholder is replaced with an empty string.

Available Icons

For visual identification, 14 icons are available:

Icon	Name	Typical Use
↗️	ExternalLink	External links (default)
🌐	Globe	Web applications
🔗	Link	General links
🖥️	Monitor	Monitoring
🔍	Search	Search systems
🛡️	Shield	Security tools
💻	Terminal	CLI/SSH access
🗄️	Database	Databases
🖧	Server	Server management
☁️	Cloud	Cloud services
🔑	Key	Access management
✉️	Mail	Email systems
👁️	Eye	Surveillance
📊	BarChart3	Statistics/Dashboards

Module Filter

Run URLs can be restricted to specific modules:

• All - Appears for all host types
• OPNsense - Only in the OPNsense module
• Proxmox VE - Only in the PVE module
• Proxmox PBS - Only in the PBS module
• Linux - Only in the Linux module
• Windows - Only in the Windows module

Multiple selection is possible - a URL can apply to e.g. only PVE and PBS.

Usage

In the Context Menu

Right-clicking on a host shows the configured Run URLs as a submenu under "Run URL":

• Only active (enabled: true) URLs are displayed
• Only URLs configured for the current module
• Sorted by the configured sort order
• Each URL shows the configured icon

URL Opening

When clicking a Run URL:

1. All {variable} placeholders are replaced with the host's values
2. The final URL is opened in a new browser tab

Practical Examples

Monitoring System

Name: Grafana
URL: https://grafana.company.com/d/host?var-host={hostname}
Modules: All
Icon: BarChart3

Ticket System

Name: New Ticket
URL: https://tickets.company.com/new?host={hostname}&customer={customer_name}
Modules: All
Icon: ExternalLink

WebUI Access

Name: PVE WebUI
URL: https://{ip_address}:8006
Modules: PVE
Icon: Monitor

GLPI Asset Search

Name: GLPI Asset
URL: https://glpi.company.com/front/computer.php?search={serial_number}
Modules: All
Icon: Search

RustDesk Remote Access

Name: RustDesk
URL: rustdesk://{rustdesk_id}
Modules: Windows
Icon: Monitor

Wiki Entry

Name: Wiki
URL: https://wiki.company.com/hosts/{hostname}
Modules: All
Icon: Globe

Integration

Run URLs are excellent for connecting DATAZONE Control with other tools in your IT infrastructure - monitoring, ticket systems, wikis, asset management, configuration management, and more.