{"id":45138249,"url":"https://github.com/octivi/borg-backup-wrapper","last_synced_at":"2026-02-20T00:13:09.440Z","repository":{"id":187386580,"uuid":"613747085","full_name":"octivi/borg-backup-wrapper","owner":"octivi","description":"Wrapper for a deduplicating archiver BorgBackup. It simplifies performing everyday tasks on multiply repositories.","archived":false,"fork":false,"pushed_at":"2026-02-13T00:09:30.000Z","size":78,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-13T09:55:47.080Z","etag":null,"topics":["backup","bash","borgbackup","borgbase","compression","dedupe","deduplication","encryption","servers"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/octivi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-03-14T07:32:43.000Z","updated_at":"2026-02-13T00:09:34.000Z","dependencies_parsed_at":"2024-11-22T21:36:54.310Z","dependency_job_id":null,"html_url":"https://github.com/octivi/borg-backup-wrapper","commit_stats":null,"previous_names":["octivi/borg-backup-wrapper"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/octivi/borg-backup-wrapper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octivi%2Fborg-backup-wrapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octivi%2Fborg-backup-wrapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octivi%2Fborg-backup-wrapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octivi%2Fborg-backup-wrapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/octivi","download_url":"https://codeload.github.com/octivi/borg-backup-wrapper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octivi%2Fborg-backup-wrapper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29637398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T22:32:43.237Z","status":"ssl_error","status_checked_at":"2026-02-19T22:32:38.330Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backup","bash","borgbackup","borgbase","compression","dedupe","deduplication","encryption","servers"],"created_at":"2026-02-20T00:13:08.741Z","updated_at":"2026-02-20T00:13:09.435Z","avatar_url":"https://github.com/octivi.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BorgBackup Wrapper\n\n[![GitHub Releases](https://img.shields.io/github/v/release/octivi/borg-backup-wrapper?sort=semver)](https://github.com/octivi/borg-backup-wrapper/releases)\n[![License: MIT](https://img.shields.io/github/license/octivi/borg-backup-wrapper)](https://choosealicense.com/licenses/mit/)\n[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org/)\n[![Semantic Versioning](https://img.shields.io/badge/SemVer-2.0.0-blue)](https://semver.org/spec/v2.0.0.html)\n\n`borg-backup-wrapper` is a wrapper around the deduplicating archiver [BorgBackup](https://www.borgbackup.org/)\nthat streamlines everyday tasks across multiple repositories.\n\nBorgBackup is an excellent archiver offering deduplication, compression, and encryption.\n\n## Requirements\n\n- Bash 4.4 or newer.\n- `borg` installed and available in `PATH`.\n- [Octivi Bash Boilerplate (OBB)](https://github.com/octivi/bash-boilerplate) is embedded in the `borg-backup` script, so no separate OBB installation is required.\n\n## Install\n\n### Manual\n\nJust download\n\n```bash\n# or https://github.com/octivi/borg-backup-wrapper/releases/latest/download/borg-backup if you always want the latest release\ncurl -fsSLO https://github.com/octivi/borg-backup-wrapper/releases/download/v1.1.0/borg-backup \\\n  \u0026\u0026 curl -fsSL https://github.com/octivi/borg-backup-wrapper/releases/download/v1.1.0/borg-backup.sha256 \\\n  | sha256sum -c - \\\n  \u0026\u0026 sudo install -m 0755 borg-backup /usr/local/bin/borg-backup \\\n  || { echo \"Checksum verification failed; aborting installation.\" \u003e\u00262; exit 1; }\n```\n\n### Ansible\n\nOne simple task to install `borg-backup`\n\n```yaml\n- name: \"Install Borg Backup Wrapper\"\n  ansible.builtin.get_url:\n    # or https://github.com/octivi/borg-backup-wrapper/releases/latest/download/borg-backup if you always want the latest release\n    url: \"https://github.com/octivi/borg-backup-wrapper/releases/download/v1.1.0/borg-backup\"\n    dest: \"/usr/local/bin/borg-backup\"\n    owner: \"root\"\n    group: \"root\"\n    mode: \"0755\"\n    # or https://github.com/octivi/borg-backup-wrapper/releases/latest/download/borg-backup.sha256 if you always want the latest release\n    checksum: \"sha256:https://github.com/octivi/borg-backup-wrapper/releases/download/v1.1.0/borg-backup.sha256\"\n  register: \"__borg_backup_wrapper_download\"\n  until: __borg_backup_wrapper_download is succeeded\n  retries: 5\n  delay: 2\n```\n\n## Quick start\n\nExample `borg-backup` configuration file:\n\n```bash\n# /etc/borg-backup.conf\nBORG_REPO=\"ssh://backup@example.com:22/./repo-hostname\"\nBORG_PASSPHRASE=\"replace-with-a-strong-passphrase\"\n\nBORG_BASE_DIR=\"/var/lib/borg-backup\"\nBORG_ARCHIVE_NAME=\"{hostname}-{now:%Y-%m-%dT%H:%M:%S}\"\nBORG_COMPRESSION=\"zstd,6\"\n\nBORG_KEEP_YEARLY=5\nBORG_KEEP_MONTHLY=24\nBORG_KEEP_WEEKLY=52\nBORG_KEEP_DAILY=30\nBORG_KEEP_HOURLY=168\n\nBORG_PATHS=(\n  \"/etc\"\n  \"/home\"\n  \"/var/www\"\n)\n\nBORG_OPTIONS_CREATE=(\n  \"--one-file-system\"\n  \"--exclude=/proc\"\n  \"--exclude=/sys\"\n  \"--exclude=/dev\"\n  \"--exclude=/run\"\n  \"--exclude=/tmp\"\n)\n```\n\nInitialize a repository, then run a normal backup cycle:\n\n```bash\nsudo borg-backup -c /etc/borg-backup.conf init\nsudo borg-backup -c /etc/borg-backup.conf create+prune+check\n```\n\n## Alternatives\n\n- [Borgmatic](https://github.com/borgmatic-collective/borgmatic)\n\n## License\n\nAll content is provided under the terms of [The MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foctivi%2Fborg-backup-wrapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foctivi%2Fborg-backup-wrapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foctivi%2Fborg-backup-wrapper/lists"}