Proxmox Backup Server
The PBS module manages your backup infrastructure. It provides an overview of datastores, backup counts, and maintenance tasks such as garbage collection, verify, and prune.
Overview
Host Table
| Column | Description |
|---|---|
| Customer | Assigned customer |
| Hostname | Name of the PBS host |
| PBS Version | Installed PBS version |
| Kernel Version | Linux kernel version |
| Agent Version | DATAZONE Agent version |
| Datastores | Number of configured datastores |
| Backups | Total number of backups |
| CPU / RAM / Disk | Current utilization |
| Uptime | Uptime |
| Last Response | Last agent heartbeat |
| WebUI | Direct link to the PBS web interface (port 8007) |
Adding a Host
Via Agent (recommended)
- Install the agent on the PBS host (see Agent Installation)
- The agent automatically detects a PBS installation
- The host appears in the PBS module
Manual
- Click Add PBS Host
- Enter customer, hostname, and connection details
Detail Modal
Click on a PBS host in the table to open the detail modal.
The detail modal contains 9 main tabs at the top. The Overview tab additionally contains 8 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 to the PBS host |
| 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 well as datastore and backup counts as cards at the top. Below are editable fields and the sub-tab navigation.
Sub-tab: Hardware
- CPU model, cores, clock speed
- RAM size and usage
- Disks and SMART status
- System information (mainboard, BIOS)
Sub-tab: Updates
- Available package updates (apt)
- Package name, current and new version
- Security updates highlighted
Sub-tab: Cron
- Configured cron jobs
- System crontabs and user crontabs
Sub-tab: Disks
- Physical disks and SMART status
- ZFS pools and their health status
- Partitions and mountpoints with usage
Sub-tab: Network
- Network interfaces with status
- IP addresses (IPv4/IPv6)
- MAC addresses
Sub-tab: Ports
- Open network ports (TCP/UDP)
- Associated services and processes
Sub-tab: Services
- System services and their status
- PBS-specific services (proxmox-backup-proxy, proxmox-backup, etc.)
- Start/stop/restart services
Sub-tab: SSH Sessions
- Active SSH connections
- User, source IP, login time
Tab: Checks
Shows all health checks assigned to this host:
- OK (green), Warning (yellow), Critical (red), Unknown (gray)
- Last check result and timestamp
See Health Checks.
Tab: Jobs
Overview of all running and completed tasks.
Tab: Shell
Integrated Bash terminal directly in the browser to the PBS host.
Tab: Log
Chronological execution logs of all actions.
Tab: Groups
Manage group membership. See Groups.
Tab: Updates
Update history and configured schedules.
Tab: Agent
Agent status, configuration, and logs.
Tab: Delete
Permanently remove the host from DATAZONE Control.
Warning
This action cannot be undone.
Datastore Actions
The following maintenance actions are available for PBS datastores:
| Action | Task Type | Description |
|---|---|---|
| Garbage Collection | PBS_GC | Remove unreferenced chunks and free up storage space. Recommended after prune operations. |
| Verify | PBS_VERIFY | Check the integrity of all backups in the datastore. Reads all chunks and verifies checksums. |
| Prune | PBS_PRUNE | Remove old backups according to configured retention rules (keep-last, keep-daily, etc.). |
| Sync | PBS_SYNC | Synchronize datastores between PBS instances (pull-based). |
Execution
Datastore actions can be executed in two ways:
- Manually: In the detail modal via the datastore's context menu
- Scheduled: As an update schedule with the corresponding type (e.g.,
gc,verify,prune,sync)
For scheduled datastore actions, the target datastore can be selected on which the action will be executed.
Context Menu
Right-clicking on a PBS host:
- Open Details - Show the detail modal
- Open WebUI - PBS web interface (port 8007)
- Open Shell - Start a Bash terminal
- Start Tunnel - Quick access to tunnel templates
- Start Update - Trigger a package update
- Run Script - Execute a script from the library
Tunnel Templates
| Template | Target Port | Description |
|---|---|---|
| PBS Web UI | 8007 | PBS web interface |
| Agent SSH | 22 | SSH via the agent |
| SSH | 22 | Direct SSH access |
| VNC | 5900 | VNC remote access |
| HTTP | 80 | HTTP forwarding |
| Custom | Any | Any port |
Update Schedules
| Type | Description |
|---|---|
| System Update | apt update && apt dist-upgrade without reboot |
| Update + Reboot | Update with reboot |
| Upgrade Check | Check whether a major upgrade is available |
| Major Upgrade | Perform a PBS version upgrade |
| GC / Verify / Prune / Sync | Datastore maintenance actions (see above) |
Schedules can also be combined with scripts and playbooks. See Update Schedules for details.