github-backup

module

v0.0.0-...-f310107 Latest Latest Go to latest Published: Dec 21, 2025 License: MIT

Details

Automated backups of GitHub repo's using Git mirroring.

GitHub Backup can be configured in 2 ways:

Create a file called config.yml in the same folder or the parent folder of the binary. See config.yml for an example.
Set environment variables

If both are defined, the environment variables take precedence.

Config key	Env variable	Description	Default value
Username	GHB_USERNAME	GitHub username
PersonalAccessToken	GHB_PERSONAL_ACCESS_TOKEN	GitHub PAT
		(Fine-grained with `All repo's` and `Contents` set to `Read-only`)
Verbose	GHB_VERBOSE	Enable verbose logging. Logs sensitive values!	false
Console	GHB_CONSOLE	Enable console logging (default is JSON).	false
BackupPath	GHB_BACKUP_PATH	Path to backup repo's to	./backup
RemoveRedundantFolders	GHB_REMOVE_REDUNDANT_FOLDERS	Remove local directories for which no repo is found	false
MaxFoldersToDelete	GHB_MAX_FOLDERS_TO_DELETE	Maximum allowed number of directories to delete.	3
		If more to be deleted, program will return an error without deleting any folder.
		Can be ignored with --ignore-max-folders-to-delete or by setting a negative value.