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.

Adding a Host

Via Agent (recommended)

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 Modal

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

The detail modal 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
• Total count and security count

Sub-tab: Cron

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

Sub-tab: Disks

• Disks and partitions
• Mountpoints and usage as bars
• LVM, RAID, and ZFS (if present)
• File system type and options

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 modal
• Open Shell - Start a Bash terminal
• Start Tunnel - Quick access to tunnel templates
• Start Update - apt upgrade / dnf upgrade
• Run Script - Select and execute a script from the library

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 update && apt upgrade -y (or dnf upgrade -y)
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.