https://github.com/geerlingguy/ansible-role-sanoid
Ansible Role - Sanoid
https://github.com/geerlingguy/ansible-role-sanoid
ansible backup replication sanoid syncoid zfs
Last synced: 11 months ago
JSON representation
Ansible Role - Sanoid
- Host: GitHub
- URL: https://github.com/geerlingguy/ansible-role-sanoid
- Owner: geerlingguy
- License: gpl-3.0
- Created: 2024-04-27T04:14:32.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2025-01-31T03:25:47.000Z (over 1 year ago)
- Last Synced: 2025-04-02T08:21:26.308Z (about 1 year ago)
- Topics: ansible, backup, replication, sanoid, syncoid, zfs
- Homepage: https://galaxy.ansible.com/ui/standalone/roles/geerlingguy/sanoid/
- Size: 19.5 KB
- Stars: 23
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Role: Sanoid
[](https://github.com/geerlingguy/ansible-role-sanoid/actions/workflows/ci.yml)
An Ansible Role that installs [Sanoid and Syncoid](https://github.com/jimsalterjrs/sanoid) on Linux servers for ZFS snapshot, backup, and replication management.
## Requirements
ZFS.
## Role Variables
Available variables are listed below, along with default values (see `defaults/main.yml`):
```yaml
sanoid_conf: ""
```
The configuration to be stored inside `/etc/sanoid/sanoid.conf`. See the Sanoid project's [README file](https://github.com/jimsalterjrs/sanoid/blob/master/README.md) and [Wiki](https://github.com/jimsalterjrs/sanoid/wiki/Sanoid#options) for examples.
## Dependencies
None.
## Example Playbook
Install from the system package manager:
```yaml
- hosts: zfs
vars:
# This assumes you have a ZFS volume `tank/volume`.
sanoid_conf: >
# Filesystem Backups
[tank/volume]
use_template = production
recursive = yes
# Templates
[template_production]
frequently = 0
hourly = 24
daily = 30
monthly = 3
yearly = 0
autosnap = yes
autoprune = yes
roles:
- role: geerlingguy.sanoid
```
## License
GPLv3
## Author Information
This role was created in 2024 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).