Readme update to fix Marktdown lint issues
This commit is contained in:
62
Readme.md
62
Readme.md
@@ -13,9 +13,11 @@ Version 4.0 introduces default borg repository name with `-file` for the `file`
|
||||
*Example:*
|
||||
|
||||
Old backup name
|
||||
|
||||
```sh
|
||||
BACKUP_FILE="some-backup-data.borg"
|
||||
```
|
||||
|
||||
Then the file need to be renamed the following way:
|
||||
`mv some-backup-data.borg some-backup-data-file.borg`
|
||||
|
||||
@@ -42,60 +44,79 @@ No settings files will be overwritten
|
||||
## Possible command line options
|
||||
|
||||
### `-c <config folder>`
|
||||
|
||||
if this is not given, /usr/local/scripts/borg/ is used
|
||||
|
||||
### `-L <log folder>`
|
||||
|
||||
override config set and default log folder
|
||||
|
||||
### `-T <tag>`
|
||||
|
||||
create one time stand alone backup prefixed with tag name
|
||||
|
||||
### `-D <tag backup set>`
|
||||
|
||||
remove a tagged backup set, full name must be given
|
||||
|
||||
### `-b <borg executable>`
|
||||
|
||||
override the default borg executable found in path
|
||||
|
||||
### `-P`
|
||||
|
||||
print list of archives created
|
||||
|
||||
### `-V`
|
||||
|
||||
verify if repository exists, if not abort
|
||||
|
||||
### `-e`
|
||||
|
||||
exit after running verify `-V`
|
||||
|
||||
### `-I`
|
||||
|
||||
init repository (must be run first)
|
||||
|
||||
### `-Z`
|
||||
|
||||
run `borg compact` over given repository
|
||||
|
||||
### `-C`
|
||||
|
||||
run `borg check` over given repository
|
||||
|
||||
#### `-y`
|
||||
|
||||
Add `--verify-data` to `borg check`. Only works with `-C`
|
||||
|
||||
#### `-p <prefix|glob>`
|
||||
|
||||
Only `borg check` data that has given prefix or glob (with *). Only works with `-C`
|
||||
|
||||
### `-i`
|
||||
|
||||
print out only info
|
||||
|
||||
### `-l`
|
||||
|
||||
list files during backup
|
||||
|
||||
### `-v`
|
||||
|
||||
be verbose
|
||||
|
||||
### `-d`
|
||||
|
||||
debug output all commands
|
||||
|
||||
### `-n`
|
||||
|
||||
only do dry run
|
||||
|
||||
### `-h`
|
||||
|
||||
this help page
|
||||
|
||||
## Basic Settings
|
||||
@@ -109,7 +130,6 @@ LOG_FOLDER: default `/var/log/borg.backup/`
|
||||
TARGET_FOLDER: must be set to a path where the backups can be written
|
||||
BACKUP_FILE: the folder inside the TARGET_FOLDER that is the target for borg. Must end with `.borg`
|
||||
|
||||
|
||||
Note: BACKUP_FILE is the base name. For all except file (current) a module suffix will be added:
|
||||
|
||||
eg:
|
||||
@@ -118,6 +138,7 @@ eg:
|
||||
If `FILE_REPOSITORY_COMPATIBLE` is set to `false` in the borg.backup.file.settings then the file borg name will have `-file` added too. Currently this is not added to stay compatible with older scripts
|
||||
|
||||
All below have default values if not set in the main settings file
|
||||
|
||||
* COMPRESSION: zstd
|
||||
* COMPRESSION_LEVEL: 3
|
||||
* ENCRYPTION: none
|
||||
@@ -132,6 +153,7 @@ All below have default values if not set in the main settings file
|
||||
* KEEP_YEARS: 1
|
||||
|
||||
All module settings files can have the following prefixed with `SUB_` to override master settings:
|
||||
|
||||
* SUB_BACKUP_FILE
|
||||
* SUB_COMPRESSION
|
||||
* SUB_COMPRESSION_LEVEL
|
||||
@@ -150,7 +172,7 @@ All module settings files can have the following prefixed with `SUB_` to overrid
|
||||
|
||||
For this the following settings are from interest
|
||||
|
||||
```
|
||||
```sh
|
||||
TARGET_USER="";
|
||||
TARGET_HOST="";
|
||||
TARGET_PORT="";
|
||||
@@ -180,10 +202,9 @@ to `true`
|
||||
|
||||
### Config variables
|
||||
|
||||
|
||||
### Control files
|
||||
|
||||
```
|
||||
```sh
|
||||
backup.borg.file.include
|
||||
backup.borg.file.exclude
|
||||
```
|
||||
@@ -197,16 +218,16 @@ backup.borg.file.exclude
|
||||
This script must be run as the postgres user, normaly `postgres`.
|
||||
The postgres user must be added to the backup group for this, so that the basic init file can be created in the borg base folder.
|
||||
|
||||
### Config variables
|
||||
### PostgreSQL Config variables
|
||||
|
||||
Variable | Default | Description
|
||||
| - | - | - |
|
||||
DATABASE_FULL_DUMP | | if empty, dump per databse, if set dump all in one file, if set to schema dump only schema
|
||||
DATABASE_USER | | overide username to connect to database
|
||||
|
||||
### Control files
|
||||
### PostgreSQL Control files
|
||||
|
||||
```
|
||||
```sh
|
||||
backup.borg.pgsql.include
|
||||
backup.borg.pgsql.exclude
|
||||
backup.borg.pgsql.schema-only
|
||||
@@ -216,16 +237,16 @@ backup.borg.pgsql.schema-only
|
||||
|
||||
If non root ident authentication run is used, be sure that the `mysql` user is in the backup group.
|
||||
|
||||
### Config variables
|
||||
### MySQL Config variables
|
||||
|
||||
Variable | Default | Description
|
||||
| - | - | - |
|
||||
DATABASE_FULL_DUMP | | if empty, dump per databse, if set dump all in one file, if set to schema dump only schema
|
||||
MYSQL_DB_CONFIG | | override file for connection. In modern mariaDB installations it is rcommended to run the script as root or mysql user and use the ident authentication instead.
|
||||
|
||||
### Control files
|
||||
### MySQLControl files
|
||||
|
||||
```
|
||||
```sh
|
||||
backup.borg.mysql.include
|
||||
backup.borg.mysql.exclude
|
||||
backup.borg.mysql.schema-only
|
||||
@@ -236,7 +257,7 @@ backup.borg.mysql.schema-only
|
||||
Note that the backup needs the GIT_USER set that runs gitea.
|
||||
This user is neede to create the temporary dump folder and access for the git files and database.
|
||||
|
||||
### Config Variables
|
||||
### gitea Config Variables
|
||||
|
||||
Variable | Default | Description
|
||||
| - | - | - |
|
||||
@@ -245,14 +266,13 @@ GITEA_TMP | /tmp/gitea/ | Where the temporary dump files from the backup are sto
|
||||
GITEA_BIN | /usr/local/bin/gitea | Where the gitea binary is located |
|
||||
GITEA_CONFIG | /etc/gitea/app.ini | The configuration file for gitea |
|
||||
|
||||
|
||||
### Control files
|
||||
### gitea Control files
|
||||
|
||||
There are no control files for gitea backup
|
||||
|
||||
## zabbix config backup settings
|
||||
|
||||
### Config Variables
|
||||
### zabbix Config Variables
|
||||
|
||||
Variable | Default | Description
|
||||
| - | - | - |
|
||||
@@ -261,19 +281,19 @@ ZABBIX_DATABASE | '' | Must be set as either psql or mysql
|
||||
ZABBIX_CONFIG | '' | if not set uses default location
|
||||
ZABBIX_UNKNOWN_TABLES | '' | if set, changed to -f (force)
|
||||
|
||||
### Control files
|
||||
### zabbix Control files
|
||||
|
||||
There are no control files for zabbix settings backup
|
||||
|
||||
|
||||
## File connection
|
||||
|
||||
Running any of the commands below
|
||||
- borg.backup.file.sh
|
||||
- borg.backup.gitea.sh
|
||||
- borg.backup.mysql.sh
|
||||
- borg.backup.pgsql.sh
|
||||
- borg.backup.zabbix.sh
|
||||
|
||||
* borg.backup.file.sh
|
||||
* borg.backup.gitea.sh
|
||||
* borg.backup.mysql.sh
|
||||
* borg.backup.pgsql.sh
|
||||
* borg.backup.zabbix.sh
|
||||
|
||||
1) Run `borg.backup.functions.init.sh` (always)
|
||||
2) Run `borg.backup.functions.verify.sh` (always)
|
||||
|
||||
Reference in New Issue
Block a user