Borgmatic - ArchWiki

Jump to content

# Borgmatic

From ArchWiki

borgmatic is a Python-based wrapper script for Borg backup, designed to simplify and automate backups. It aims to provide an easy-to-use and flexible solution for creating backups using borgbackup.

## Installation

Install the borgmatic package.

## Configuration

By default no configuration file is installed. To create one you can use the command `borgmatic config generate` to generate one:

    # borgmatic config generate

    Generating a configuration file at: /etc/borgmatic/config.yaml

    This includes all available configuration options with example values, the few
    required options as indicated. Please edit the file to suit your needs.

    If you ever need help: https://torsion.org/borgmatic/#issues

    summary:
    Generate successful

The configuration file for borgmatic is located at one of the following

- `/etc/borgmatic/config.yaml` (or drop-ins in `/etc/borgmatic.d`)
- `~/.config/borgmatic/config.yaml` (or drop-ins in `~/.config/borgmatic.d`)

The configuration file allows you to define backup repositories, backup sources, retention policies, and other parameters.

## Usage

Once you have configured borgmatic to your liking, you can run it using the following command:

    # borgmatic --verbosity 2

This will start the backup process using the settings specified in your configuration file. borgmatic provides various options and flags that you can use to customize your backup behavior.

Borgmatic also provides systemd system and user units and timers.

## See also

- How to snapshot your filesystems

Category:

- Backup

Borgmatic
Add topic