aboutsummaryrefslogtreecommitdiffstats
path: root/lifeboat.1
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--lifeboat.194
1 files changed, 94 insertions, 0 deletions
diff --git a/lifeboat.1 b/lifeboat.1
new file mode 100644
index 0000000..f7fe710
--- /dev/null
+++ b/lifeboat.1
@@ -0,0 +1,94 @@
+.Dd October 3, 2019
+.Dt LIFEBOAT 1
+.Os
+.Sh NAME
+.Nm lifeboat
+.Nd manage and automate local restic backups
+.Sh SYNOPSIS
+.Nm
+.Ar repo
+.Ar command
+.Sh DESCRIPTION
+.Nm
+is a program that manages a set of local
+.Xr restic 1
+repositories and provides a framework
+for automating the creation and synchronization of backups.
+.Pp
+The command is any command recognized by
+.Xr restic 1 ,
+or as follows:
+.Bl -tag -width Ds
+.It Sy run
+Create a snapshot for the specified repository.
+.El
+.Sh DIRECTORY STRUCTURE
+.Nm
+keeps all its data in one directory, specified by the
+.Ev LIFEBOAT_ROOT
+environment variable.
+If unset,
+.Nm
+will fall back to
+.Pa /srv/backup/lifeboat .
+.Pp
+Each backup managed by
+.Nm
+owns a directory under
+.Ev LIFEBOAT_ROOT .
+In that directory, the program expects the following:
+.Bl -tag -width Ds
+.It Sy repo/
+A directory containing the actual
+.Xr restic 1
+repository.
+.It Sy credentials/restic
+A file containing the password for the
+.Xr restic 1
+repository.
+.It Sy run
+A shell script containing backup jobs.
+.It Sy post
+A shell script containing post-backup jobs, optional.
+.It Sy sync
+A shell script containing synchronization jobs, optional.
+.El
+.Pp
+When
+.Nm
+is invoked with the
+.Em run
+command, it will change the current directory to the backup directory, and execute the
+.Em run
+script, followed by executing
+.Em post
+and
+.Em sync ,
+if they exist.
+.Sh ENVIRONMENT
+.Nm
+will export the following environment variables for use in the
+.Em run ,
+.Em post ,
+and
+.Em sync
+scripts:
+.Bl -tag -width Ds
+.It Sy LIFEBOAT_REPO
+The name of the backup as specified on the command line.
+.It Sy RESTIC_REPOSITORY
+The path to the
+.Xr restic 1
+repository.
+.It Sy RESTIC_PASSWORD_FILE
+The path to the
+.Xr restic 1
+password file.
+.El
+.Sh SEE ALSO
+.Xr restic 1
+.Sh AUTHORS
+.An -nosplit
+.Nm
+was written by
+.An Wolfgang Müller Aq Mt vehk@vehk.de