BARMAN-CONFIG-UPDATE(1)

💖 BARMAN-CONFIG-UPDATE 💖

okay bestie, welcome to barman-config-update — it's a Barman sub-command, and it's literally the one that writes your configs for you so you don't have to hand-edit anything like a Victorian orphan. 🎀

---

✨ SYNOPSIS ✨

config-update
    [ { -h | --help } ]
    STRING

---

🦋 DESCRIPTION 🦋

So like, what this does is create or update the configurations for servers and/or models in Barman. slay. 💅

The parameter you hand over should be a JSON string containing an array of documents. Each document must include a scope key — and that key can be either server or model — plus either a server_name key or a model_name key, depending on what you put in scope. And then, bestie, the document should also include other keys representing Barman configuration options and the values you want them to have. that's the whole vibe. ✨

Note: ⚠️ listen up because this part matters fr fr — the barman config-update command writes configuration options to a file named .barman.auto.conf, located in the barman_home directory. This configuration file has higher precedence and will override values from the global Barman configuration file (usually /etc/barman.conf) and from any included files specified in configuration_files_directory (typically files in /etc/barman.d). Be aware of this if you decide to manually modify configuration options in those files later. 👀 no cap, she has main character energy and she will win the argument.

---

🌸 PARAMETERS 🌸

• STRING — List of JSON formatted string. 🧚
• -h / --help — Show a help message and exit. Provides information about command usage. iconic, honestly. 👑

---

🌈 EXAMPLE 🌈

JSON_STRING='[{“scope”: “server”, “server_name”: “my_server”,
“archiver”: “on”, “streaming_archiver”: “off”}]'

---

💜 Author

EnterpriseDB

---

🎀 Copyright

© Copyright EnterpriseDB UK Limited 2011-2026

---

okay that's the whole page, you ate that 🫶 this was version 3.20, dated Sep 29, 2026, and it's filed under BARMAN-CONFIG-UPDATE(1). go forth and configure, bestie 💖✨