User Guide

Queue & Jobs

Real-time visibility into all backup operations. Monitor progress, troubleshoot failures, and manage jobs across all your clients.

Queue Page Overview

The Queue page shows all backup operations across all clients. Access it from the Queue link in the navigation. The page auto-refreshes every 10 seconds.

Borg Backup Server queue page showing stat cards, in-progress jobs, and recently completed jobs
Screenshot coming soon

Summary Statistics

Four stat cards at the top give you an at-a-glance picture:

  • In Queue — Jobs waiting to run
  • Completed (24h) — Successful jobs in the last 24 hours
  • Failed (24h) — Failed jobs in the last 24 hours
  • Avg Duration — Average job execution time for the last 50 jobs

Job States

Jobs progress through several states:

  • Queued (gray) — Job created, waiting to be sent to agent
  • Sent (blue) — Job sent to agent, agent acknowledged
  • Running (yellow) — Job actively executing with live progress bar
  • Completed (green) — Job finished successfully
  • Failed (red) — Job failed with an error
  • Cancelled (gray) — Job was manually cancelled

In Progress

Shows all currently running jobs with live progress bars, client name, job type, and elapsed time. For backup jobs, you'll see files processed and bytes transferred. For S3 sync jobs, you'll see upload speed and progress.

Recently Completed

Displays the 25 most recently finished jobs with their status badge, client name, job type, duration, and quick action buttons. Click any job to view its detail page.

Job Types

  • Backup — Creates a new Borg archive
  • Prune — Removes old archives based on retention policy
  • Compact — Reclaims disk space after pruning
  • Restore — Extracts files from an archive
  • Restore MySQL / PostgreSQL — Restores database dumps
  • Check — Verifies repository integrity
  • S3 Sync — Mirrors repository to cloud storage
  • Update Agent / Borg — Updates software on agents
  • Plugin Test — Tests a plugin configuration

Job Detail Page

Click any job to view its full detail page, which includes:

  • Job header — Status, client, plan name, timestamps, and duration
  • Job options — Configuration used (directories, exclusions, retention, etc.)
  • Output log — Real-time output from the borg command (scrollable, color-coded)
  • Error log — For failed jobs, detailed error message and exit code

Job Actions

Cancel

Cancel a queued, sent, or running job. The agent receives a cancellation signal and stops execution. Partial progress is discarded.

Retry

Re-run a failed job with the same configuration. A new job is queued — the original remains in history. Fix the underlying issue before retrying.

Tip: Click the stat cards to filter the job list. Click Failed (24h) to see only failed jobs, or use the search box to filter by client name.

Filtering & Search

  • Filter by status — Click stat cards to show only queued, completed, or failed jobs
  • Search by client — Type a client name to filter in real time
  • Filter by job type — Use the dropdown to show only backups, restores, S3 syncs, etc.
← Previous Notifications