# 使用 Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper 安装 borgmatic

查看 borgmatic 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:borgmatic
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install borgmatic
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install borgmatic
```

  证据: 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
```

  证据: 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
```

  证据: 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
```

  证据: Fedora Rawhide package metadata: borgmatic from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#borgmatic
```

  证据: 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
```

  证据: 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
```

  证据: openSUSE Tumbleweed package metadata: borgmatic from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## 软件包事实

- **软件包键:** brew:borgmatic
- **软件包管理器:** Homebrew
- **版本:** 2.1.6
- **来源摘要:** Simple wrapper script for the Borg backup software
- **主页:** <https://torsion.org/borgmatic/>
- **最后更新:** 2026-06-02T23:51:48Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- borgmatic (别名)
- generate-borgmatic-config (别名)
- validate-borgmatic-config (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 2.1.6
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://projects.torsion.org/api/v1/repos/borgmatic-collective/borgmatic>
- <https://torsion.org/borgmatic/>
- <https://torsion.org/borgmatic/how-to/install-borgmatic/>
- <https://torsion.org/borgmatic/how-to/set-up-backups/>
- source_facts.package-manager


## 安全说明

没有找到 borgmatic 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 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
## 其他软件包管理器记录

- 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-3.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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Simple Python wrapper script for borgbackup | https://torsion.org/borgmatic
- pacman - borgmatic - 2.1.6-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.5: normalized package name match | openSUSE Tumbleweed package metadata: borgmatic from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-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


## Combined YAML source

View the package source record on GitHub. [combined/borgmatic.yml](https://github.com/mxcl/pkgdb/blob/main/combined/borgmatic.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph