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
| Column | Description |
|---|---|
| Customer | Assigned customer |
| Hostname | Name of the server |
| Distribution | Linux distribution and version |
| Kernel Version | Linux kernel version |
| Agent Version | DATAZONE Agent version |
| CPU / RAM / Disk | Current utilization as progress bars |
| Pending Updates | Number of available package updates (security updates highlighted in red) |
| Uptime | Uptime |
| Last Response | Last 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:
| Reason | Meaning |
|---|---|
| Phased update | Ubuntu rolls the update out in stages and releases it for this host later |
| On hold | The package is held via apt-mark hold |
| Kept back | apt 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
Via Agent (recommended)
- Install the agent on the Linux server (see Agent Installation)
- The agent automatically detects the distribution
- The host appears in the Linux module
Manual
- Click Add Linux Server
- 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
| Tab | Icon | Description |
|---|---|---|
| Overview | Monitor | System information with sub-tabs (see below) |
| Checks | ClipboardCheck | Health check results and status |
| Jobs | ListTodo | Running and completed tasks |
| Shell | Terminal | Remote Bash terminal directly in the browser |
| Log | FileText | Execution logs for all actions |
| Groups | Tags | Manage group membership |
| Updates | RefreshCw | Update history and schedules |
| Agent | Cpu | Agent status, logs, and management |
| Delete | Trash2 | Remove 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.serviceorssh.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.txtinside 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):
| Column | Description |
|---|---|
| Name | Container name |
| Image | Docker image with tag |
| Status | Running (green), Exited (red), Paused (yellow) |
| Created | Container creation date |
| Ports | Port mappings (e.g., 0.0.0.0:8080->80/tcp) |
| CPU / RAM | Current 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
| Template | Target Port | Description |
|---|---|---|
| SSH | 22 | Direct SSH access |
| Agent SSH | 22 | SSH via the agent tunnel |
| HTTP | 80 | Web server access |
| HTTPS | 443 | Encrypted web server access |
| VNC | 5900 | VNC remote access |
| RDP | 3389 | Remote Desktop (e.g., xrdp) |
| Custom | Any | Any port |
Update Schedules
| Type | Description |
|---|---|
| System Update | apt-get update && apt full-upgrade -y (non-interactive, existing config files are kept) |
| Update + Reboot | Update with reboot and optional post-update script |
Update schedules can be combined with scripts that run before or after the update. See Update Schedules.