BARMAN-CHECK-BACKUP(1)

📦
version 3.20.1 · 7 versions
, in epel 10, fedora 43, fedora 44

💅 BARMAN-CHECK-BACKUP — the manual page, but make it make sense

okay bestie, so this is barman-check-backup, part of the Barman Sub-Commands family. It's the little sanity-checker that goes through your backup's WAL files and makes sure they're all actually archived, so you can trust that your physical backup is consistent. Sit down, grab a boba, we're doing this. 🧋✨

✨ SYNOPSIS ✨

check-backup
    [ { -h | --help } ]
    SERVER_NAME BACKUP_ID

🌸 DESCRIPTION 🌸

This command checks that all the necessary WAL files needed to verify the consistency of a physical backup are properly archived. That's it, that's the whole vibe check. 💖

Two things you should know, fr fr:

  • This command is automatically executed by the cron job — you don't have to run it yourself, it just shows up and does its thing.
  • It's also run at the end of each backup operation, so every backup gets its little consistency check before anyone calls it done.

Also? You can use a shortcut instead of BACKUP_ID. Yes, really. Details below. 👑

🎀 PARAMETERS 🎀

  • SERVER_NAME — the name of the server in the barman node. Like, which server are we checking, bestie?
  • BACKUP_ID — the id of the backup in the barman catalog. (Or a shortcut! See the next section, iykyk.)
  • -h / --help — shows a help message and exits. Gives you the info about how to use the command, then dips. 🙈

🦋 SHORTCUTS 🦋

Instead of typing out a whole BACKUP_ID, you can use one of these little shortcuts. Iconic behaviour, honestly:

  • first / oldest — the oldest available backup for the server, in chronological order.
  • last / latest — the most recent available backup for the server, in chronological order.
  • last-full / latest-full — the most recent full backup taken with methods rsync or postgres.
  • last-failed — the most recent backup that failed, in chronological order.
No cap: those slash-pairs are two spellings of the same shortcut, so pick whichever one your fingers like. 💅

🌈 Author

EnterpriseDB

© Copyright EnterpriseDB UK Limited 2011-2026

and that's the whole page, bestie!! 🫶 this is from Barman 3.20, dated Sep 29, 2026 — go check those WALs, you absolute main character. 🌟💖

📦 where this page comes from