restic-profile

Profile-based restic wrapper, deployed with Ansible.

This repository is an Ansible collection (ak1ra_lab.restic_profile) that installs and configures the restic-profile CLI on local or remote hosts:

restic-profile CLI - reads a TOML config and runs restic backup / forget / prune with hooks and IM notifications.
restic_profile role - deploys the CLI, renders the TOML config, and manages one systemd timer per profile (including user-level systemd_scope: user).
restic_rest_server role - deploys a rest-server instance for remote backup storage.

Deploy with Ansible

You need Ansible on the control node - see Ansible toolchain for a uv-based setup. Clone the repo and install this collection with its dependencies into the project-local tree:

git clone https://github.com/ak1ra-lab/restic-profile.git
cd restic-profile
ansible-galaxy collection install --collections-path .ansible/collections -r requirements.yaml
ansible-galaxy collection install --force --collections-path .ansible/collections .

Then pick an example from Ansible examples, fill in your host_vars, and run the playbook. Building restic from source (restic_profile_restic_install_source: go_build) also needs a go toolchain on the control node.

Development

Only needed to work on src/restic_profile or the roles and plugins:

uv sync --group dev
just lint
just typecheck
just test
ansible-lint

To develop ak1ra_lab.general alongside this repo, clone ansible-collection-general next to this checkout and run just ansible-collection-install - it installs this collection plus your local ../ansible-collection-general (skipping ansible.posix/community.general, which come from your user-level Ansible).

Documentation

https://ak1ra-lab.github.io/restic-profile/ - configuration lives in mkdocs.yml.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

restic_profile_cli-0.4.0.tar.gz (162.3 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

restic_profile_cli-0.4.0-py3-none-any.whl (19.4 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file restic_profile_cli-0.4.0.tar.gz.

File metadata

Download URL: restic_profile_cli-0.4.0.tar.gz
Upload date: Aug 11, 2026
Size: 162.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for restic_profile_cli-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`06f361a32edcca98662837ee9346d2375db5c176c9760ccb38fe49663b812043`
MD5	`53d049d839c7cf261461bd0ba324e24f`
BLAKE2b-256	`95b25a55e5f81b8fe875655070b32623145ec0193ce37f0953971fc425d489eb`

See more details on using hashes here.

Provenance

The following attestation bundles were made for restic_profile_cli-0.4.0.tar.gz:

Publisher: publish-to-pypi.yaml on ak1ra-lab/restic-profile

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: restic_profile_cli-0.4.0.tar.gz
- Subject digest: 06f361a32edcca98662837ee9346d2375db5c176c9760ccb38fe49663b812043
- Sigstore transparency entry: 2419421857
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: ak1ra-lab/restic-profile@5c6905f4858de2537249471652b94f40b4e683c0
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/ak1ra-lab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-to-pypi.yaml@5c6905f4858de2537249471652b94f40b4e683c0
- Trigger Event: push