# Install autorestic with Homebrew, apk, dnf, MacPorts, Nix

High level CLI utility for restic. Version 1.8.3 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:autorestic
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install autorestic
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install autorestic
```

  Evidence: MacPorts ports tree: sysutils/autorestic/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add autorestic
```

  Evidence: Alpine Linux edge package indexes: autorestic from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- dnf (92%):

```sh
sudo dnf install autorestic
```

  Evidence: Fedora Rawhide package metadata: autorestic 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#autorestic
```

  Evidence: nixpkgs package indexes: pkgs/by-name/au/autorestic/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:autorestic
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/autorestic>
- **Version:** 1.8.3
- **Source summary:** High level CLI utility for restic
- **Homepage:** <https://autorestic.vercel.app/>
- **Repository:** <https://github.com/cupcakearmy/autorestic>
- **Upstream docs:** <https://autorestic.vercel.app/>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/cupcakearmy/autorestic/archive/refs/tags/v1.8.3.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- autorestic (cli)
- autorestic (alias)

## Dependencies

- restic

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.8.3
- Local data: ok
- Upstream repository: https://github.com/cupcakearmy/autorestic
- Upstream latest detected: v1.8.3 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

autorestic is a config-driven backup wrapper around restic. Its niche is turning restic's low-level repository commands into a YAML-managed backup layout with named locations, multiple backends, hooks, retention policies, and cron-oriented automation.

### Project history

The project was created in 2019 by cupcakearmy as a higher-level CLI for restic. The official README and docs frame it as a response to restic becoming cumbersome when many locations need to be backed up to multiple destinations.

The first GitHub release, 0.1 Alpha, was published in June 2019. Later documentation describes the version 2 configuration format and a migration path for users coming from the older 0.x series, indicating a rewrite or format break significant enough for backup operators to notice.

### Adoption history

autorestic's adoption path is typical of small but useful backup tooling: binaries and shell installer first, then package-manager availability. Its own installation docs list Homebrew, Fedora, AUR, Docker, and manual binary installation, while the package input records availability in Homebrew, Fedora, Alpine, MacPorts, and Nix.

### How it is used

Users define locations and backends in `.autorestic.yml`, then run commands such as backup, forget, check, restore, or cron integration through the `autorestic` executable. The docs emphasize storing backend credentials in environment variables or a sibling `.autorestic.env` file so repository keys do not have to live directly in YAML.

### Why package nerds care

For package users, autorestic is interesting because it packages an opinionated workflow rather than a storage engine. It depends on restic's ecosystem but adds a declarative layer that makes repeated laptop, server, and Docker-volume backups easier to reproduce across machines.

### Timeline

- 2019: GitHub repository created and 0.1 Alpha release published.
- 2020s: Version 2 YAML configuration and environment-file credential handling documented.
- 2020s: Distribution through Homebrew, Fedora, AUR, Docker, and other package sets broadened the install path beyond the upstream shell installer.

### Related projects

- restic: the backup program autorestic wraps.
- rclone-compatible and cloud backends: commonly reached through restic backend configuration.
- system cron: used by autorestic's scheduled backup workflow.

### Sources

- <https://github.com/cupcakearmy/autorestic>
- <https://raw.githubusercontent.com/cupcakearmy/autorestic/master/docs/pages/backend/env.md>
- <https://raw.githubusercontent.com/cupcakearmy/autorestic/master/docs/pages/config.md>
- <https://raw.githubusercontent.com/cupcakearmy/autorestic/master/docs/pages/index.md>
- <https://raw.githubusercontent.com/cupcakearmy/autorestic/master/docs/pages/installation.md>
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## 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: ./.autorestic.yml, ~/.autorestic.yml, ~/.config/autorestic/.autorestic.yml

## Credential files

- Unix: ./.autorestic.env, ~/.autorestic.env, ~/.config/autorestic/.autorestic.env
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** autorestic
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - autorestic: normalized package name match | nixpkgs package indexes: pkgs/by-name/au/autorestic/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - autorestic - 1.8.3-r15: normalized package name match | Alpine Linux edge package indexes: autorestic from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Config driven, easy backup cli for restic. | https://github.com/cupcakearmy/autorestic
- dnf - autorestic - 1.8.3-11.fc44: normalized package name match | Fedora Rawhide package metadata: autorestic from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Config driven, easy backup cli for restic | https://github.com/cupcakearmy/autorestic
- MacPorts - autorestic: normalized package name match | MacPorts ports tree: sysutils/autorestic/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.
- [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.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [restic](https://www.automicvault.com/pkg/brew/restic/) - Runtime dependency declared by Homebrew.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [redu](https://www.automicvault.com/pkg/brew/redu/) - Shares av.db curated category or tags: backup, cli, restic, system.
- [resticprofile](https://www.automicvault.com/pkg/brew/resticprofile/) - Shares av.db curated category or tags: backup, cli, restic, system.
- [afio](https://www.automicvault.com/pkg/brew/afio/) - Shares av.db curated category or tags: backup, cli, system.
- [asimov](https://www.automicvault.com/pkg/brew/asimov/) - Shares av.db curated category or tags: backup, cli, system.
- [backupninja](https://www.automicvault.com/pkg/brew/backupninja/) - 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.
- [bareos-client](https://www.automicvault.com/pkg/brew/bareos-client/) - 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.
- [httm](https://www.automicvault.com/pkg/brew/httm/) - Local package facts share a topical domain. Shared terms: backup, cli, level, system.

## Combined YAML source

View the package source record on GitHub. [combined/autorestic.yml](https://github.com/automic-vault/db/blob/main/combined/autorestic.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