Skip to content

Linux Servers ​

The Linux module manages servers running all common Linux distributions. It provides Docker overview, package updates, service monitoring, and remote shell access.

Overview ​

Host Table ​

ColumnDescription
CustomerAssigned customer
HostnameName of the server
DistributionLinux distribution and version
Kernel VersionLinux kernel version
Agent VersionDATAZONE Agent version
CPU / RAM / DiskCurrent utilization as progress bars
Pending UpdatesNumber of available package updates (security updates highlighted in red)
UptimeUptime
Last ResponseLast agent heartbeat

Update Display ​

The Pending Updates column shows:

  • The total number of available updates
  • A red badge with the number of security updates (if any)

The agent checks for new updates hourly and caches the results.

Updates are detected and installed via apt. This covers Debian, Ubuntu and derived distributions.

Deferred Packages (since v3.6.0) ​

apt lists some packages as upgradable but does not install them in an update run yet. The agent detects this by simulating apt full-upgrade and marks these packages as deferred:

ReasonMeaning
Phased updateUbuntu rolls the update out in stages and releases it for this host later
On holdThe package is held via apt-mark hold
Kept backapt keeps the package back due to dependencies

Deferred packages do not count as pending updates or security updates. They appear greyed out with a reason badge in the Updates sub-tab and can be shown with the Deferred filter. A host therefore no longer shows leftover updates permanently after a successful update.

Adding a Host ​

  1. Install the agent on the Linux server (see Agent Installation)
  2. The agent automatically detects the distribution
  3. The host appears in the Linux module

Manual ​

  1. Click Add Linux Server
  2. Enter customer, hostname, and IP address

Detail Panel ​

Click on a host in the table to open the detail panel.

The detail panel contains 9 main tabs at the top. The Overview tab additionally contains 9 sub-tabs for detailed system information.

Main Tabs ​

TabIconDescription
OverviewMonitorSystem information with sub-tabs (see below)
ChecksClipboardCheckHealth check results and status
JobsListTodoRunning and completed tasks
ShellTerminalRemote Bash terminal directly in the browser
LogFileTextExecution logs for all actions
GroupsTagsManage group membership
UpdatesRefreshCwUpdate history and schedules
AgentCpuAgent status, logs, and management
DeleteTrash2Remove host from DATAZONE Control

Tab: Overview ​

The overview shows the most important metrics (CPU, RAM, Disk, Uptime) as cards at the top. Below are editable fields (Name, Customer, Description) and the sub-tab navigation.

Sub-tab: Hardware ​

  • CPU model, cores, clock speed
  • RAM size and usage
  • Disks with SMART status
  • BIOS/UEFI information
  • Mainboard and serial number

Sub-tab: Updates ​

  • List of all available package updates
  • Package name, current and new version
  • Security updates highlighted
  • Deferred packages greyed out with reason (phased update, on hold, kept back)
  • Total count and security count

Sub-tab: Cron ​

  • Configured system cron jobs
  • System crontabs and user crontabs
  • Schedule, command, and executing user

Sub-tab: Processes (since v3.19.0) ​

Live list of running processes, fetched from the agent when opened (agent 3.19.0 or newer, host online):

  • Name, path, PID, user, CPU (share of the whole machine like Task Manager), memory, start time
  • Sort by clicking column headers, search across name, PID, user and command line
  • Auto refreshes the list every 8 seconds
  • End (permission End processes): with confirmation. The agent first checks that the PID still belongs to the same program. System-critical processes (e.g. systemd, init) and the agent itself cannot be ended. Every kill is recorded in the audit log (process_kill).

Sub-tab: Event log (since v3.24.0) ​

Systemd journal live from the agent (journalctl, agent 3.24.0 or newer, host online, permission Event log). It works the same way as the Windows event log:

  • Source: Whole journal, Kernel (kernel messages like dmesg) or a single service under Services (units), e.g. nginx.service or ssh.service. The unit list loads the first time the list is opened
  • Period: last hour, 24 hours, 7 or 30 days
  • Levels as filters: Critical, Error, Warning, Information (default: Critical + Error + Warning). Journal priorities are mapped as follows: emerg/alert/crit = Critical, err = Error, warning = Warning, notice/info = Information
  • Search in message, program and unit
  • Column Source shows the program (syslog identifier), the unit on hover; column PID shows the process ID
  • Click a row to see the full message
  • The newest 200 entries are shown; narrow the filters to see older ones

Hosts without a systemd journal show a notice instead of entries. Older agents report "agent too old" – update it in the Agent tab.

Sub-tab: Files (since v3.19.0) ​

File manager directly in the browser (agent 3.19.0 or newer, host online, permission Files or Manage files):

  • Drives or / as entry point, navigate by click, breadcrumb or typing a path
  • Download folders (since v3.22.4): the download icon on a folder delivers a ZIP including all subfolders. Locked or unreadable files are skipped and listed in _FEHLER.txt inside the ZIP; links/junctions are not followed
  • Download: click a file. The agent transfers it to Control via HTTP, the browser fetches it once; it is deleted right after (at the latest after 1 hour)
  • Upload (Manage files): button or drag files into the area, with progress; existing files are only replaced after confirmation
  • New folder, rename, delete (Manage files). Folders are deleted including their contents – this requires typing the name. Drive roots and system folders (e.g. C:\Windows, C:\Program Files, /etc, /usr) are protected
  • Size limit: setting file_transfer_max_mb (default 2048 MB)
  • Every opened folder (file_list, with path), download, upload, rename and delete is recorded in the audit log

Permissions

The agent runs as SYSTEM or root and can therefore read any file. The permissions Files and Manage files are therefore not part of the Viewer role.

Sub-tab: Disks ​

  • ZFS pools (agent 3.32.0 or later): usage bar, free, size, health (ONLINE / DEGRADED / …) and fragmentation per pool, including pools that are not mounted (e.g. the VM pool holding the zvols)
  • Mount points with device, file system, usage bar, free, size and inodes
  • ZFS datasets only show their own used space ("in pool …"): a dataset reports the whole pool as free space, so a percentage would be misleading (0–1 % although the pool may be full). Usage is shown on the pool.
  • The total in the top right counts the shared pool space only once

Sub-tab: Docker ​

Shows all Docker containers on the host (only when Docker is installed):

ColumnDescription
NameContainer name
ImageDocker image with tag
StatusRunning (green), Exited (red), Paused (yellow)
CreatedContainer creation date
PortsPort mappings (e.g., 0.0.0.0:8080->80/tcp)
CPU / RAMCurrent resource usage

Container Actions (via context menu per container):

  • Start - Start a stopped container
  • Stop - Stop a running container
  • Restart - Restart a container

Docker Detection

Docker information is only displayed when Docker is installed on the server. The agent detects this automatically and sends container data with every heartbeat (30s).

Sub-tab: Network ​

  • Network interfaces with status (UP/DOWN)
  • IP addresses (IPv4/IPv6)
  • MAC addresses
  • Received/sent bytes

Sub-tab: Ports ​

  • Open network ports (TCP and UDP)
  • Listening address and port
  • Associated processes (PID and process name)
  • Protocol (TCP/UDP)

Sub-tab: Services ​

  • All systemd services and their status:
    • active (green) - Service is running
    • inactive (gray) - Service is stopped
    • failed (red) - Service has failed
  • Startup type: enabled, disabled, static, masked
  • Service actions directly from the table:
    • Start - Start a service
    • Stop - Stop a service
    • Restart - Restart a service

Sub-tab: SSH Sessions ​

  • Active SSH connections
  • Username, source IP, login time
  • Connection duration

Tab: Checks ​

Shows all health checks assigned to this host with their current status:

  • OK (green), Warning (yellow), Critical (red), Unknown (gray)
  • Last check result and timestamp
  • Direct link to check configuration

See Health Checks for details.

Tab: Jobs ​

Overview of all running and completed tasks:

  • Task type (Update, Script, Backup, etc.)
  • Status (Pending, Running, Completed, Failed)
  • Start time and duration
  • Expandable result details

Tab: Shell ​

Integrated Bash terminal directly in the browser. Uses a secure WebSocket connection via the agent.

  • Full interactive terminal (xterm.js)
  • Supports color output and special characters
  • Copy/paste available

WebShell

Via the context menu, you can also open the shell in a separate browser window (WebShell). See Shell.

Tab: Log ​

Chronological execution logs of all actions on this host:

  • Timestamp, action, user
  • Result (success/failure)
  • Expandable detail output

Tab: Groups ​

Manage group membership for this host:

  • Current groups with colored badges
  • Add/remove groups

See Groups.

Tab: Updates ​

  • Update history with date, type, and result
  • Configured update schedules
  • Next scheduled update

Tab: Agent ​

  • Agent status (Online/Offline) and version
  • View agent configuration
  • View agent logs
  • Restart agent

Tab: Delete ​

Permanently remove the host from DATAZONE Control. This action:

  • Deletes all stored data for this host
  • Removes the host from all groups
  • Deletes associated tunnels and schedules

Warning

This action cannot be undone. The agent on the server will not be uninstalled.

Context Menu ​

Right-clicking on a Linux server in the table provides quick actions:

  • Open Details - Show the detail panel
  • Open Shell - Start a Bash terminal
  • Start Tunnel - Quick access to tunnel templates
  • Start Update - apt-get update + apt full-upgrade
  • Run Script - Select and execute a script from the library
  • Remote control in browser (since v3.28.0) - Control the screen of a Linux desktop (X11, since v3.50.0 also Wayland), see Remote control

Tunnel Templates ​

TemplateTarget PortDescription
SSH22Direct SSH access
Agent SSH22SSH via the agent tunnel
HTTP80Web server access
HTTPS443Encrypted web server access
VNC5900VNC remote access
RDP3389Remote Desktop (e.g., xrdp)
CustomAnyAny port

Update Schedules ​

TypeDescription
System Updateapt-get update && apt full-upgrade -y (non-interactive, existing config files are kept)
Update + RebootUpdate with reboot and optional post-update script

Update schedules can be combined with scripts that run before or after the update. See Update Schedules.

DATAZONE Control Documentation