psw/borgmatic
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve documentation around the installation process. Specifically, making borgmatic commands runnable via the system PATH.

Browse source
This commit is contained in:
Dan Helfman 2020-05-18 20:38:43 -07:00
parent 89cb5eb76d
commit d9c9d7d2ee
2 changed files with 21 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
NEWS
View file

@ -1,6 +1,8 @@
1.5.5.dev0 1.5.5.dev0
* #314: Fix regression in support for PostgreSQL's "directory" dump format. Unlike other dump * #314: Fix regression in support for PostgreSQL's "directory" dump format. Unlike other dump
formats, the "directory" dump format does not stream directly to/from Borg. formats, the "directory" dump format does not stream directly to/from Borg.
* Improve documentation around the installation process. Specifically, making borgmatic commands
runnable via the system PATH.
1.5.4 1.5.4
* #310: Fix legitimate database dump command errors (exit code 1) not being treated as errors by * #310: Fix legitimate database dump command errors (exit code 1) not being treated as errors by

31
docs/how-to/set-up-backups.md
View file

@ -12,30 +12,37 @@ First, [install
Borg](https://borgbackup.readthedocs.io/en/stable/installation.html), at least Borg](https://borgbackup.readthedocs.io/en/stable/installation.html), at least
version 1.1. version 1.1.
Then, download and install borgmatic by running the following command: Then, download and install borgmatic as a [user site
installation](https://packaging.python.org/tutorials/installing-packages/#installing-to-the-user-site)
by running the following command:
```bash ```bash
sudo pip3 install --user --upgrade borgmatic sudo pip3 install --user --upgrade borgmatic
``` ```
This is a [recommended user site This installs borgmatic and its commands at the `/root/.local/bin` path.
installation](https://packaging.python.org/tutorials/installing-packages/#installing-to-the-user-site).
You will need to ensure that `/root/.local/bin` is available on your `$PATH` Your pip binary may have a different name than "pip3". Make sure you're using
so Python 3, as borgmatic does not support Python 2.
that the borgmatic executable is available. For instance, adding this to
root's `~/.profile` or `~/.bash_profile` may do the trick: The next step is to ensure that borgmatic's commands are on your system
`PATH`, so that you can run borgmatic:
```bash ```bash
export PATH="$PATH:~/.local/bin" echo export 'PATH="$PATH:/root/.local/bin"' >> ~/.bashrc
source ~/.bashrc
``` ```
Note that your pip binary may have a different name than "pip3". Make sure This adds `/root/.local/bin` to your non-root user's system `PATH`.
you're using Python 3, as borgmatic does not support Python 2.
If you're using a command shell other than Bash, you may need to use different
commands here.
### Other ways to install ### Other ways to install
Along with the above process, you have several other options for installing Besides the process described above, there are several other options for
borgmatic: installing borgmatic:
* [Docker image with scheduled backups](https://hub.docker.com/r/b3vis/borgmatic/) * [Docker image with scheduled backups](https://hub.docker.com/r/b3vis/borgmatic/)
* [Docker base image](https://hub.docker.com/r/monachus/borgmatic/) * [Docker base image](https://hub.docker.com/r/monachus/borgmatic/)