---
name: "barman-config-update"
section: "1"
platform: "linux"
package: "barman-cli"
version: "3.13.3-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/barman-config-update"
---

# barman-config-update(1)

Barman Sub-Commands

## NAME

barman-config-update - Barman Sub-Commands

## SYNOPSIS

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

## DESCRIPTION

Create or update the configurations for servers and/or models in Barman. The parameter should be a JSON string containing an array of documents. Each document must include a **scope** key, which can be either server or model, and either a **server\_name** or **model\_name** key, depending on the scope value. Additionally, the document should include other keys representing Barman configuration options and their desired values.

**NOTE:**

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.

## PARAMETERS

- **STRING**

  List of JSON formatted string.

- **-h / --help**

  Show a help message and exit. Provides information about command usage.

## EXAMPLE

**JSON\_STRING='\[{“scope”: “server”, “server\_name”: “my\_server”, “archiver”:** **“on”, “streaming\_archiver”: “off”}\]'**

## AUTHOR

EnterpriseDB

## COPYRIGHT

© Copyright EnterpriseDB UK Limited 2011-2025