Sign inSign up

kolbyjack/borg-client

By kolbyjack

Updated about 5 years ago

Image
0

677

kolbyjack/borg-client repository overview

docker-borg-client - A docker container to run daily borg backups

To use, mount the volumes you wish to backup under /backup, then configure the following secrets/environment variables:

SecretDescription
borg_ssh_keyThe private key used for remote backups
borg_passphraseThe passphrase to use with repokey encrypted repositories (Required when BORG_ENCRYPTION is repokey)

Required Variables

VariableDefaultDescription
BORG_REPOnoneThe target borg repository where archives will be stored
BORG_ARCHIVE_NAMEnoneThe base name to use when creating an archive

Variables used to backup MySQL databases

VariableDefaultDescription
BORG_MYSQL_HOSTnoneThe MySQL host to connect to. (Required)
BORG_MYSQL_PASSWORDnoneThe password used to connect to MySQL. (Required)
BORG_MYSQL_USERrootThe user used to connect to MySQL.
BORG_MYSQL_PATH/backup/mysqldumpThe path where mysqldump files should be stored.
BORG_MYSQL_DUMP_OPTS--complete-insert --events --routines --triggers --single-transactionOptions passed to mysqldump.
BORG_MYSQL_DATABASESnoneIf set, the databases to dump. If unset, all databases except mysql, information_schema, and performance_schema will be dumped.
BORG_MYSQL_GZIPyesIf set to no, database dumps will not be compressed.

Variables to control repository encryption

VariableDefaultDescription
BORG_ENCRYPTIONrepokeyThe encryption type to use (repokey, keyfile, authenticated)

Variables to control archive creation and retention

VariableDefaultDescription
BORG_DATEPATTERN-%Y-%m-%d-%H-%M-%SThe date pattern suffix to use when creating archives
BORG_EXCLUDE_IF_PRESENTnoneIf set, exclude directories that contain the specified file
BORG_KEEP_DAILYnoneThe number of daily backups to keep when pruning
BORG_KEEP_WEEKLYnoneThe number of weekly backups to keep when pruning
BORG_KEEP_MONTHLYnoneThe number of monthly backups to keep when pruning
BORG_KEEP_YEARLYnoneThe number of yearly backups to keep when pruning
BORG_KEEP_WITHINnoneKeep all archives within this time interval

Variables to control reporting

VariableDefaultDescription
BORG_FAILED_BACKUP_URLnoneIf set, a url to request when the backup fails
BORG_POST_BACKUP_URLnoneIf set, a url to request when the backup is complete
BORG_PRE_BACKUP_URLnoneIf set, a url to request when the backup script begins

System Variables

VariableDefaultDescription
BORG_REMOTE_PATHnoneIf set, the path to the borg executable on the server

Cron Variables

VariableDefaultDescription
BORG_SCHEDULE@dailyA cron schedule expression to determine when to run the backup
CROND_LOG_LEVEL8The log level to use for crond in the container

Tag summary

Content type

Image

Digest

Size

30.7 MB

Last updated

about 5 years ago

docker pull kolbyjack/borg-client