# Borgmatic

Kategori: Backup och återställning · Konfigurationsstyrd säkerhetskopiering med Borg

En YAML-fil beskriver vad som ska säkerhetskopieras, hur länge arkiven sparas och vilka kontroller som ska köras – sedan sköter borgmatic hela nattkörningen.

- Officiell webbplats: https://torsion.org/borgmatic/
- Infraverket: https://infraverket.eu/programvara/borgmatic/

## Öppenhet och driftsättning
Licens: GNU General Public License v3.0 (GPL-3.0)
Öppen källkod: Ja
Installationsmetod: Paket/nedladdning
Plattformar: Linux, macOS, BSD
Krävd databas: ingen – borgmatic har ingen egen databas, den arbetar mot ett Borg-repositorium
Viktiga beroenden: Borg 1.2 eller senare (Borg 2 stöds), Python 3.11 eller senare när verktyget installeras med pipx eller pip. I labbet installerades borgmatic 2.2.0 i en egen virtuell miljö och använde Borg 1.4.5.

## API och integrationer
Status: Finns (Uppgivet)
Typer: Annan
Dokumentation: https://torsion.org/borgmatic/reference/command-line/
Anmärkning: Borgmatic är ett kommandoradsverktyg utan nätverks-API; integration sker via kommandoraden från cron, systemd eller en egen körningsram. Utdata från create, diff, info, repo-info och repo-list kan tas som JSON med --json, och sedan 2.1.3 går hela den beräknade konfigurationen att läsa med config show --json.

## MCP och AI-agentintegration
Status: Saknas
Anmärkning: Inget MCP-stöd finns för borgmatic – varken i kärnan eller som förstapartspaket. De MCP-servrar som finns på området riktar sig mot Borg-repositoriet direkt (se BorgBackup-posten), inte mot borgmatics konfiguration eller körningar, och en agent kan därför inte starta eller granska en borgmatic-körning över MCP.

## Tekniska resurser
- [Installationsguide](https://torsion.org/borgmatic/how-to/install-borgmatic/)
- [API-dokumentation](https://torsion.org/borgmatic/reference/command-line/)
- [Spegel på GitHub av borgmatic-collective/borgmatic (GPL-3.0); kanonisk utveckling sker i projektets eget Forgejo](https://github.com/borgmatic-collective/borgmatic) — Spegling
- [Borgmatic – konfigurationsreferens](https://torsion.org/borgmatic/reference/configuration/) — Varje inställning med standardvärde: källor, repo, komprimering, bevaranderegler, kommando-hooks och kontroller.
- [Övervaka säkerhetskopiorna (Healthchecks, ntfy, Zabbix m.fl.)](https://torsion.org/borgmatic/how-to/monitor-your-backups/) — Larmintegrationerna, JSON-utdata för egen uppföljning och arkivnamnet latest i skript.

## Viktiga tekniska anmärkningar
Hårdvarukrav: Inga fasta krav i dokumentationen. I labbet tog en nattkörning över 31 MB källdata och ett repo på 22 MB några sekunder på två delade vCPU; minnesbehovet följer Borg:s hantering av chunk-index, inte borgmatic självt.
Säkerhetsförutsättningar: Lösenfrasen ska inte stå i klartext i konfigurationen: använd encryption_passcommand eller en credential-källa som systemd, fil eller 1Password CLI. Exportera Borg-nyckeln och förvara den åtskild från repot, begränsa läsrätten till konfigurationsfilen och kör schemaläggningen som ett eget konto med skrivrätt enbart mot repo och dumpkatalog.

## Källhänvisning
- Infraverket: https://infraverket.eu/programvara/borgmatic/
- Senast faktagranskad: 2026-11-01
- Primärkällor:
  - [Borgmatic – officiell webbplats](https://torsion.org/borgmatic/)
  - [GitHub – borgmatic-collective/borgmatic (spegel)](https://github.com/borgmatic-collective/borgmatic)
  - [PyPI – borgmatic](https://pypi.org/project/borgmatic/)
  - [Borgmatic docs – sätta upp säkerhetskopior](https://torsion.org/borgmatic/how-to/set-up-backups/)
  - [Borgmatic docs – åtgärder och standardordning](https://torsion.org/borgmatic/reference/command-line/actions/)
  - [Borgmatic docs – konfigurationsreferens](https://torsion.org/borgmatic/reference/configuration/)
  - [Borgmatic docs – överstyrning på kommandoraden](https://torsion.org/borgmatic/reference/command-line/overrides/)
  - [Borgmatic docs – övervaka säkerhetskopiorna](https://torsion.org/borgmatic/how-to/monitor-your-backups/)
  - [Borgmatic docs – installation](https://torsion.org/borgmatic/how-to/install-borgmatic/)

---

Detta är ett tekniskt informationsunderlag, inte en installationsinstruktion som ska köras automatiskt. Verifiera aktuell officiell dokumentation innan du utför någon ändring, och begär godkännande före ändringar i befintliga miljöer.