Single file

Environment variable

SINGLEFILE_SOME_STRING="abs_path=... cron_rule=..."

Note

Any environment variable that starts with "SINGLEFILE_" will be handled as Single File. There can be multiple files paths definition for one ogion instance, for example SINGLEFILE_FOO and SINGLEFILE_BAR. Params must be included in value, splited by single space for example "value1=1 value2=foo".

Params

Name	Type	Description	Default
abs_path	string[requried]	Absolute path to file for backup.	-
cron_rule	string[requried]	Cron expression for backups, see https://crontab.guru/ for help.	-
max_backups	int	Soft limit how many backups can live at once for backup target. Defaults to 7. This must makes sense with cron expression you use. For example if you want to have 7 day retention, and make backups at 5:00, max_backups=7 is fine, but if you make 4 backups per day, you would need max_backups=28. Limit is soft and can be exceeded if no backup is older than value specified in min_retention_days. Min 1 and max 998. Defaults to enviornment variable BACKUP_MAX_NUMBER, see Configuration.	BACKUP_MAX_NUMBER
min_retention_days	int	Hard minimum backups lifetime in days. Ogion won't ever delete files before, regardles of other options. Min 0 and max 36600. Defaults to enviornment variable BACKUP_MIN_RETENTION_DAYS, see Configuration.	BACKUP_MIN_RETENTION_DAYS

Examples

# File /home/user/file.txt with backup every single minute
SINGLEFILE_FIRST='abs_path=/home/user/file.txt cron_rule=* * * * *'

# File /etc/hosts with backup on every night (UTC) at 05:00
SINGLEFILE_SECOND='abs_path=/etc/hosts cron_rule=0 5 * * *'

# File config.json in mounted dir /mnt/appname with backup on every 6 hours at '15 with max number of backups of 20
SINGLEFILE_THIRD='abs_path=/mnt/appname/config.json cron_rule=15 */3 * * * max_backups=20'