# Install borgmatic with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper Simple wrapper script for the Borg backup software. Version 2.1.6 via Homebrew; verified 2026-06-02. ## Install ```sh sudo av install brew:borgmatic ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install borgmatic ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install borgmatic ``` Evidence: MacPorts ports tree: sysutils/borgmatic/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add borgmatic ``` Evidence: Alpine Linux edge package indexes: borgmatic from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install borgmatic ``` Evidence: Debian stable package indexes: borgmatic from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install borgmatic ``` Evidence: Fedora Rawhide package metadata: borgmatic from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#borgmatic ``` Evidence: nixpkgs package indexes: pkgs/by-name/bo/borgmatic/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S borgmatic ``` Evidence: Arch Linux sync databases: borgmatic from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install borgmatic ``` Evidence: openSUSE Tumbleweed package metadata: borgmatic from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:borgmatic - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.1.6 - **Source summary:** Simple wrapper script for the Borg backup software - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-or-later - **Source archive:** - **Last updated:** 2026-06-02T23:51:48Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - borgmatic (cli) - generate-borgmatic-config (cli) - validate-borgmatic-config (cli) - borgmatic (alias) - generate-borgmatic-config (alias) - validate-borgmatic-config (alias) ## Dependencies - certifi - python@3.14 - rpds-py ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2.1.6 - Package-manager updated: 2026-06-02 - Local data: ok - Upstream repository: https://torsion.org/borgmatic/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage borgmatic is configuration-driven backup automation for BorgBackup, turning Borg's deduplicating encrypted archive model into repeatable YAML-based backup jobs for servers and workstations. ### Project history The project grew as a wrapper and automation layer around BorgBackup. Its own documentation now presents borgmatic as the canonical project at torsion.org and the source repository as the official development home. borgmatic grew from a small wrapper script into a backup orchestrator with configuration validation, repository creation, pruning, checks, database dumps, hooks, monitoring integrations, and upgrade-aware command changes. The documentation's compatibility notes, such as the move from the older init action to repo-create, show an actively maintained tool tracking Borg's evolution. ### Adoption history borgmatic is packaged across mainstream Unix package managers, including Homebrew, Debian, Ubuntu, Fedora, Arch, openSUSE, Alpine, MacPorts, and Nix according to the batch input. Its presence in both Linux distribution repositories and macOS package managers reflects a practical role in personal server, workstation, and self-hosting backup setups. The project also appears in the Borg hosting ecosystem: borgmatic's README and site point users toward providers that explicitly support Borg or borgmatic workflows, making it a familiar layer for off-site encrypted backups. ### How it is used Typical use starts with a YAML configuration listing source directories, repositories, retention, checks, hooks, and optional database backup settings. Operators run borgmatic manually, from cron, or from systemd timers to create and prune Borg archives without hand-writing long Borg command lines. borgmatic relies on Borg being installed separately, then wraps Borg operations such as repository creation, archive creation, pruning, checks, extraction, and passphrase handling. Its docs describe both configuration-file passphrases and Borg environment variables such as BORG_PASSPHRASE and BORG_PASSCOMMAND. ### Why package nerds care For package maintainers, borgmatic is a useful example of a Python CLI that deliberately avoids bundling its core external engine, Borg, so distro packages must express the Borg relationship cleanly instead of hiding it inside the wrapper. For CLI users, it sits in the sweet spot between raw Borg commands and a full backup appliance: declarative config, Unix-friendly scheduling, and enough hooks to integrate with monitoring without requiring a daemon. ### Timeline - 2017: Official source repository metadata shows the borgmatic repository created on projects.torsion.org. - 2023: Official release metadata includes borgmatic 1.8.1, part of the mature 1.x series. - 2025: Documentation records the repo-create action replacing the older init action in borgmatic 1.9.0. - 2026: Project metadata and package-manager input show borgmatic maintained as a cross-distro backup CLI. ### Related projects - BorgBackup is the underlying deduplicating, encrypted backup tool that borgmatic automates. - BorgBase is a related hosting provider named by the borgmatic site as supporting Borg and borgmatic workflows. - systemd, Docker, Podman, database engines, and monitoring services are adjacent integrations documented by borgmatic. ### Sources - - - - - source_facts.package-manager ## Security Notes No matching local secret-handling manifest was found for borgmatic. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: /etc/borgmatic/config.yaml, ~/.config/borgmatic/config.yaml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** borgmatic - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - borgmatic - 1.9.14-0.1: normalized package name match | Debian stable package indexes: borgmatic from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | automatically create, prune and verify backups with borgbackup | https://torsion.org/borgmatic - Nix - borgmatic: normalized package name match | nixpkgs package indexes: pkgs/by-name/bo/borgmatic/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - borgmatic - 1.8.3-1: normalized package name match | Ubuntu 24.04 LTS package indexes: borgmatic from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | automatically create, prune and verify backups with borgbackup | https://torsion.org/borgmatic - apk - borgmatic - 2.1.4-r0: normalized package name match | Alpine Linux edge package indexes: borgmatic from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Simple, configuration-driven backup software for servers and workstations | https://torsion.org/borgmatic/ - apk - borgmatic-bash-completion - 2.1.4-r0: normalized package name match | Alpine Linux edge package indexes: borgmatic-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for borgmatic | https://torsion.org/borgmatic/ - apk - borgmatic-pyc - 2.1.4-r0: normalized package name match | Alpine Linux edge package indexes: borgmatic-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for borgmatic | https://torsion.org/borgmatic/ - dnf - borgmatic - 2.1.6-2.fc45: normalized package name match | Fedora Rawhide package metadata: borgmatic from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Simple Python wrapper script for borgbackup | https://torsion.org/borgmatic - pacman - borgmatic - 2.1.5-1: normalized package name match | Arch Linux sync databases: borgmatic from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Simple, configuration-driven backup software for servers and workstations | https://torsion.org/borgmatic - zypper - borgmatic - 1.9.5-2.4: normalized package name match | openSUSE Tumbleweed package metadata: borgmatic from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Automation tool for borgbackup | https://torsion.org/borgmatic - MacPorts - borgmatic: normalized package name match | MacPorts ports tree: sysutils/borgmatic/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Archive and compression packages](https://www.automicvault.com/pkg/archive-compression-tools/) - Matched archive or compression metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [resticprofile](https://www.automicvault.com/pkg/brew/resticprofile/) - Shares av.db curated category or tags: automation, backup, cli, configuration, system. - [afio](https://www.automicvault.com/pkg/brew/afio/) - Shares av.db curated category or tags: backup, cli, system. - [bacula-fd](https://www.automicvault.com/pkg/brew/bacula-fd/) - Shares av.db curated category or tags: backup, cli, system. - [borgbackup](https://www.automicvault.com/pkg/brew/borgbackup/) - Shares av.db curated category or tags: backup, cli, system. - [bup](https://www.automicvault.com/pkg/brew/bup/) - Shares av.db curated category or tags: backup, cli, system. - [bupstash](https://www.automicvault.com/pkg/brew/bupstash/) - Shares av.db curated category or tags: backup, cli, system. - [burp](https://www.automicvault.com/pkg/brew/burp/) - Shares av.db curated category or tags: backup, cli, system. - [dar](https://www.automicvault.com/pkg/brew/dar/) - Shares av.db curated category or tags: backup, cli, system. - [meta-package-manager](https://www.automicvault.com/pkg/brew/meta-package-manager/) - Both packages touch the same language runtime or ecosystem. Shared terms: automation, certifi, cli, python, python-3-14. - [duplicity](https://www.automicvault.com/pkg/brew/duplicity/) - Both packages touch the same language runtime or ecosystem. Shared terms: backup, certifi, cli, python, python-3-14. ## Combined YAML source View the package source record on GitHub. [combined/borgmatic.yml](https://github.com/automic-vault/db/blob/main/combined/borgmatic.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph