58fdc26044 | ||
---|---|---|
.github/workflows | ||
bin | ||
debian | ||
docs | ||
script | ||
share/github-backup-utils | ||
test | ||
.dockerignore | ||
.gitattributes | ||
.gitignore | ||
.ruby-version | ||
CONTRIBUTING.md | ||
Dockerfile | ||
Dockerfile.alpine | ||
LICENSE | ||
Makefile | ||
README.md | ||
RELEASING.md | ||
STYLEGUIDE.md | ||
backup.config-example |
README.md
GitHub Enterprise Server Backup Utilities
This repository includes backup and recovery utilities for GitHub Enterprise Server.
UPDATE: The new parallel backup and restore beta feature will require GNU awk and moreutils to be installed. Note that on some distributions/platforms, the moreutils-parallel
package is separate from moreutils
and must be installed on its own.
Note: the GitHub Enterprise Server version requirements have changed starting with Backup Utilities v2.13.0, released on 27 March 2018.
Features
Backup Utilities implement a number of advanced capabilities for backup hosts, built on top of the backup and restore features already included in GitHub Enterprise Server.
- Complete GitHub Enterprise Server backup and recovery system via two simple
utilities:
ghe-backup
andghe-restore
. - Online backups. The GitHub appliance need not be put in maintenance mode for the duration of the backup run.
- Incremental backup of Git repository data. Only changes since the last snapshot are transferred, leading to faster backup runs and lower network bandwidth and machine utilization.
- Efficient snapshot storage. Only data added since the previous snapshot consumes new space on the backup host.
- Multiple backup snapshots with configurable retention periods.
- Backup commands run under the lowest CPU/IO priority on the GitHub appliance, reducing performance impact while backups are in progress.
- Runs under most Linux/Unix environments.
- MIT licensed, open source software maintained by GitHub, Inc.
Documentation
- Requirements
- Getting started
- Using the backup and restore commands
- Scheduling backups
- Backup snapshot file structure
- How does Backup Utilities differ from a High Availability replica?
- Docker
Support
If you find a bug or would like to request a feature in Backup Utilities, please open an issue or pull request on this repository. If you have a question related to your specific GitHub Enterprise Server setup or would like assistance with backup site setup or recovery, please contact our Enterprise support team instead.