{"id":19635874,"url":"https://github.com/tozd/docker-rdiff-backup-remote","last_synced_at":"2026-04-29T16:34:16.878Z","repository":{"id":82333833,"uuid":"159009485","full_name":"tozd/docker-rdiff-backup-remote","owner":"tozd","description":"Docker image providing remote backups with rdiff-backup. Read-only mirror of https://gitlab.com/tozd/docker/rdiff-backup-remote","archived":false,"fork":false,"pushed_at":"2023-11-14T09:02:21.000Z","size":17,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-01-09T16:37:26.873Z","etag":null,"topics":["backup","docker","docker-image","rdiff-backup"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tozd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["plast8","mitar"]}},"created_at":"2018-11-25T07:46:15.000Z","updated_at":"2021-10-18T02:21:23.000Z","dependencies_parsed_at":"2024-11-11T12:31:22.449Z","dependency_job_id":"0d4013fb-24cc-4c10-9fe5-b0a06dc1f041","html_url":"https://github.com/tozd/docker-rdiff-backup-remote","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tozd%2Fdocker-rdiff-backup-remote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tozd%2Fdocker-rdiff-backup-remote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tozd%2Fdocker-rdiff-backup-remote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tozd%2Fdocker-rdiff-backup-remote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tozd","download_url":"https://codeload.github.com/tozd/docker-rdiff-backup-remote/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240941485,"owners_count":19882062,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","docker","docker-image","rdiff-backup"],"created_at":"2024-11-11T12:27:23.126Z","updated_at":"2025-09-20T07:11:38.277Z","avatar_url":"https://github.com/tozd.png","language":"Shell","funding_links":["https://github.com/sponsors/plast8","https://github.com/sponsors/mitar"],"categories":[],"sub_categories":[],"readme":"# tozd/rdiff-backup-remote\n\n\u003chttps://gitlab.com/tozd/docker/rdiff-backup-remote\u003e\n\nAvailable as:\n\n- [`tozd/rdiff-backup-remote`](https://hub.docker.com/r/tozd/rdiff-backup-remote)\n- [`registry.gitlab.com/tozd/docker/rdiff-backup-remote`](https://gitlab.com/tozd/docker/rdiff-backup-remote/container_registry)\n\n## Image inheritance\n\n[`tozd/base`](https://gitlab.com/tozd/docker/base) ← [`tozd/dinit`](https://gitlab.com/tozd/docker/dinit) ← [`tozd/mailer`](https://gitlab.com/tozd/docker/mailer) ← [`tozd/cron`](https://gitlab.com/tozd/docker/cron) ← `tozd/rdiff-backup-remote`\n\n## Tags\n\n- `1`: rdiff-backup 1.2.8\n- `2`: rdiff-backup 2.2.6\n\n## Volumes\n\n- `/config`: Configuration files.\n- `/backup`: Destination to where the backup is made.\n\n## Variables\n\n- `RDIFF_BACKUP_SOURCE`: Remote location from which to backup. Example: `user@example.com::/`\n- `RDIFF_BACKUP_EXPIRE`: How long to keep past versions, provided as a string according to\n  _time formats_ section of [rdiff-backup man page](http://www.nongnu.org/rdiff-backup/rdiff-backup.1.html).\n  Default is 12M for 12 months.\n\n## Description\n\nDocker image providing daily backups with [rdiff-backup](http://www.nongnu.org/rdiff-backup/).\nThe main purpose is to backup remote machines to a local backup volume. Using rdiff-backup\ngives you direct access to the latest version with past versions possible to be\nreconstructed using rdiff-backup. Past changes are stored using reverse increments.\n\nFor local host backup instead of remote backup, consider\n[tozd/rdiff-backup Docker image](https://gitlab.com/tozd/docker/rdiff-backup).\n\nUse a config volume `/config` for config files and mount a directory to where\nyou want to store the backup to `/backup` volume.\n\nIf you want to configure only parts of the remote machine to be backed up, you can provide\na `/config/backup.list` file which is passed as `include-globbing-filelist` to rdiff-backup.\nExample:\n\n```\n+ /etc\n+ /home\n+ /root\n+ /var/log\n+ /usr/local/bin\n+ /usr/local/etc\n+ /usr/local/sbin\n- /\n```\n\nThis file configures that `/etc`, `/home`, `/root` and parts of `/var` and `/usr` are backed up, while the\nrest of the remote machine is ignored. Consult section _file selection_ of\n[rdiff-backup man page](http://www.nongnu.org/rdiff-backup/rdiff-backup.1.html)\nfor more information on the format of this file.\n\nFor rdiff-backup to be able to connect to the remote machine, a SSH key pair should be generated:\n\n```\n$ ssh-keygen -t rsa -f backup_rsa\n```\n\nDo not set any password on key pair. This generates two files, `backup_rsa` and `backup_rsa.pub`.\nYou should add (append) contents of the `backup_rsa.pub` file to `~/.ssh/authorized_keys` file on the\nremote machine for the user which you are planing to use to connect to the remote machine.\nPut both generated files into `/config/.ssh` directory inside the `/config` volume.\n\nYou should also configure SSH client inside the Docker container to use the private\nkey for the connection to the remote machine. You can do this by creating a `config`\nfile inside `/config/.ssh`. For example:\n\n```\nHost example.com\n    HostName example.com\n    User user\n    Port 22\n    IdentityFile /config/.ssh/backup_rsa\n```\n\nImportant is to configure `IdentityFile` to point to the private key file.\n\nMoreover, you should create `known_hosts` file inside `/config/.ssh`, with\nthe fingerprint of the remote machine's public key:\n\n```\n$ ssh-keyscan example.com \u003e known_hosts\n```\n\n`/config` volume should generally contain the following files:\n\n```\n/config/backup.list\n/config/.ssh/backup_rsa\n/config/.ssh/backup_rsa.pub\n/config/.ssh/config\n/config/.ssh/known_hosts\n```\n\nRemote machine should:\n\n- Have rdiff-backup installed at `/usr/bin/rdiff-backup`.\n- Have the user used to connect to the machine configured with sudo `NOPASSWD`\n  so that rdiff-backup can obtain root permissions automatically.\n- Have a SSH public key added to user's `~/.ssh/authorized_keys` file.\n\nTo get e-mails with any errors during daily backups, you have also to\nconfigure `MAILTO`, `ADMINADDR`, and `REMOTES` environment variables\nas described in [`tozd/mailer`](https://gitlab.com/tozd/docker/mailer)\nand [`tozd/cron`](https://gitlab.com/tozd/docker/cron) Docker images.\n\n## GitHub mirror\n\nThere is also a [read-only GitHub mirror available](https://github.com/tozd/docker-rdiff-backup-remote),\nif you need to fork the project there.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftozd%2Fdocker-rdiff-backup-remote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftozd%2Fdocker-rdiff-backup-remote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftozd%2Fdocker-rdiff-backup-remote/lists"}