all lists on lists.proxmox.com
 help / color / mirror / Atom feed
From: Yahya Jabary <y.jabary@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: [pve-devel] [PATCH proxmox-backup] fix: #6496 - add `sync-job run` to docs
Date: Thu, 22 Jan 2026 15:48:50 +0100	[thread overview]
Message-ID: <20260122144900.2144503-1-y.jabary@proxmox.com> (raw)

Signed-off-by: Yahya Jabary <y.jabary@proxmox.com>
---
 docs/managing-remotes.rst | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/docs/managing-remotes.rst b/docs/managing-remotes.rst
index 60ac3bc6..95ac4823 100644
--- a/docs/managing-remotes.rst
+++ b/docs/managing-remotes.rst
@@ -67,8 +67,8 @@ itself. Alternatively, you can manage them with the ``proxmox-backup-manager
 sync-job`` command. The configuration information for sync jobs is stored at
 ``/etc/proxmox-backup/sync.cfg``. To create a new sync job, click the add button
 in the GUI, or use the ``create`` subcommand. After creating a sync job, you can
-either start it manually from the GUI or provide it with a schedule (see
-:ref:`calendar-event-scheduling`) to run regularly.
+start it manually from the GUI, use the ``run`` subcommand, or provide it with
+a schedule (see :ref:`calendar-event-scheduling`) to run regularly.
 Backup snapshots, groups and namespaces which are no longer available on the
 **Remote** datastore can be removed from the local datastore as well by setting
 the ``remove-vanished`` option for the sync job.
@@ -87,6 +87,17 @@ trusted remote backup server.
   ╞════════════╪═══════╪════════╪══════════════╪═══════════╪═════════╡
   │ pbs2-local │ local │ pbs2   │ local        │ Wed 02:30 │ offsite │
   └────────────┴───────┴────────┴──────────────┴───────────┴─────────┘
+  # proxmox-backup-manager sync-job run pbs2-local
+  Starting datastore sync job 'pbs2:local:local::pbs2-local'
+  sync datastore 'local' from 'pbs2/local'
+  ----
+  Syncing datastore 'local', root namespace into datastore 'local', root namespace
+  found 0 groups to sync (out of 0 total)
+  Finished syncing root namespace, current progress: 0 groups, 0 snapshots
+  Summary: sync job found no new data to pull
+  sync job 'pbs2:local:local::pbs2-local' end
+  queued notification (id=a8ce89b5-330a-4ad7-9906-3a876e7ed174)
+  TASK OK
   # proxmox-backup-manager sync-job remove pbs2-local
 
 To set up sync jobs, the configuring user needs the following permissions:
-- 
2.47.3


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

             reply	other threads:[~2026-01-22 14:49 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-01-22 14:48 Yahya Jabary [this message]
2026-01-22 14:48 ` [pve-devel] [PATCH] add sync-job run to pbs/docs Yahya Jabary
2026-01-22 15:10 ` [pve-devel] [PATCH proxmox-backup] fix: #6496 - add `sync-job run` to docs Yahya Jabary

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260122144900.2144503-1-y.jabary@proxmox.com \
    --to=y.jabary@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal