Set container to a desired timezone (usually same as this host)

Objetivo

TZ

Space separated list of domains that will be started along with the container if found powered off (case sensitive)

Objetivo

VM_AUTOSTART_LIST

Space separated list of domains to exclude from backup schedule and automatic checks (case sensitive)

Objetivo

VM_IGNORED_LIST

Backups rotation: Number of checkpoints to save incrmentally into a backup chain before to archive it. If set to `0`, backup chain will grow indefinitely (and no retention policies will be applied)

Objetivo

MAX_BACKUPS_PER_CHAIN

Por defecto

30

Path to user share where all backups will be stored

Objetivo

/backups

Por defecto

/mnt/user/backups/domains

Cron expression to schedule incremental backups

Objetivo

BACKUP_SCHEDULE

Por defecto

@daily

Local retention policy: How many backup chains to keep archived at `LOCAL_BACKUP_PATH`. If set to `0`, disables retention policy on the local endpoint

Objetivo

LOCAL_BACKUP_CHAINS_TO_KEEP

Por defecto

1

Path to private SSH key to perform operations onto remote servers via SSH and Rsync. Key must be owned by root and file permissions equal to '0600' (in most cases, necessary for send Unraid notifications)

Objetivo

/private/hostname.key

Por defecto

/mnt/user/appdata/vm-babysitter/hostname.key

Unraid IP/Hostname to send notifications (usually, same as this host). It has no effect on non-Unraid OS

Objetivo

UNRAID_NOTIFY_HOST

Por defecto

localhost

Usually, a SSH address to a path into another host, where backup chains will be mirrored. Requires r/w permissions at the remote host. If not set, this feature remains disabled and `RSYNC_` env vars have no effect. (Read documentation for advanced usage)

Objetivo

RSYNC_BACKUP_PATH

When a cron expression is set, backup mirrors are updated at this specific schedule, instead of immediately after backups schedule

Objetivo

RSYNC_SCHEDULE

Mirror's retention policy: How many backup chains to keep archived at `RSYNC_BACKUP_PATH`. If set to `0`, disables retention policy on the mirror

Objetivo

RSYNC_BACKUP_CHAINS_TO_KEEP

Por defecto

2

Attempts to repair backup chains when virtnbdbackup was interrupted in the middle of an operation, by removing the last checkpoint at both backup and domain, avoiding thus a forced rotation and creation of a new backup chain. (Set a non-empty value to enable)

Objetivo

VM_ALLOW_BACKUP_CHAIN_FIX

Performs controlled powercycle of running domains under certain scenarios during container startup. If not set, vm-babysitter will ask the user (via logs and Unraid notifications, when available) to manually shut down domains in need of this action. Read documentation for more info (Set a non-empty string to enable)

Objetivo

VM_ALLOW_POWERCYCLE

Verify data integrity of backups. This operation may take long time, delaying container's full initialization. Only useful under suspect of data corruption (Set a non-empty value to enable)

Objetivo

CHECK_BACKUPS_INTEGRITY

Max amount in seconds scripts will await for domains responding to libvirt queries during powercycle operations. Increase this value if you get often warnings about scripts 'giving up' awaiting for slow domains

Objetivo

VM_WAIT_TIME

Por defecto

60

Extra arguments passed to virtnbdbackup (only tested with `--start-domain`, `--compress` and `--no-color`. Other combinations usually lead to unexpected results

Objetivo

VIRTNBDBACKUP_ARGS

Extra arguments passed to Rsync

Objetivo

RSYNC_ARGS

Por defecto

-a

Common SSH options for communications with remote, and the unraid hosts (expert use only)

Objetivo

SSH_OPTIONS

Por defecto

-q -o IdentityFile=/private/hostname.key -o BatchMode=yes -o StrictHostKeyChecking=no -o ConnectTimeout=10

Container path where vm-babysitter will save and vm-restore will search for backups. Container will not start if not set, or if not mounted in r/w mode

Objetivo

LOCAL_BACKUP_PATH

Por defecto

/backups

Change only if domain disk images are stored into a different user share than the default

Objetivo

/mnt/user/domains

Por defecto

/mnt/user/domains

Persistent bind mount for log files generated by scripts

Objetivo

/logs

Por defecto

/mnt/user/appdata/vm-babysitter/logs

Container path for the main log file

Objetivo

LOGFILE_PATH

Por defecto

/logs/vm-babysitter.log

Container path for scheduled tasks log file

Objetivo

SCHEDULE_LOGFILE_PATH

Por defecto

/logs/scheduled-tasks.log

Container path to place and read log rotation config

Objetivo

LOGROTATE_CONFIG_PATH

Por defecto

/tmp/logrotate.d/vm-babysitter

Cron expression to schedule internal logs rotation

Objetivo

LOGROTATE_SCHEDULE

Por defecto

@daily

Parsed string with *escaped* logrotate config to `LOGROTATE_CONFIG_PATH` during container (re)start

Objetivo

LOGROTATE_SETTINGS

Por defecto

compress\n copytruncate\n daily\n dateext\n dateformat .%Y-%m-%d.%H:%M:%S\n missingok\n notifempty\n rotate 30

Allows Virtnbdbackup to put its socket onto the main host

Objetivo

/var/tmp

Por defecto

/var/tmp

Allow scripts to read and interact with Libvirt socket from inside the container

Objetivo

/run/libvirt

Por defecto

/run/libvirt

Allow scripts to put locks onto the main host

Objetivo

/run/lock

Por defecto

/run/lock

Allow scripts to read/restore per domain nvram binaries for EFI/UEFI boot

Objetivo

/etc/libvirt/qemu/nvram

Por defecto

/etc/libvirt/qemu/nvram

Allow scripts to read/copy common nvram binaries for EFI/UEFI boot

Objetivo

/usr/share/qemu/ovmf-x64

Por defecto

/usr/share/qemu/ovmf-x64