diff --git a/docs/how-to/develop-on-borgmatic.md b/docs/how-to/develop-on-borgmatic.md index e6590c675..e8f04dcef 100644 --- a/docs/how-to/develop-on-borgmatic.md +++ b/docs/how-to/develop-on-borgmatic.md @@ -41,7 +41,7 @@ you're in the `borgmatic/` working copy, install tox, which is used for setting up testing environments: ```bash -sudo pip3 install tox +pip3 install --user tox ``` Finally, to actually run tests, run: diff --git a/docs/how-to/set-up-backups.md b/docs/how-to/set-up-backups.md index c1cbd2181..e8b266dc1 100644 --- a/docs/how-to/set-up-backups.md +++ b/docs/how-to/set-up-backups.md @@ -7,16 +7,24 @@ To get up and running, first [install Borg](https://borgbackup.readthedocs.io/en/latest/installation.html), at least version 1.1. -Then, run the following command to download and install borgmatic: +Borgmatic consumes configurations in `/etc/borgmatic/` and `/etc/borgmatic.d/` +by default. Therefore, we show how to install borgmatic for the root user which +will have access permissions for these locations by default. + +Run the following commands to download and install borgmatic: ```bash -sudo pip3 install --upgrade borgmatic +sudo pip3 install --user --upgrade borgmatic ``` +This is a [recommended user site +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` so +that the borgmatic executable is available. + Note that your pip binary may have a different name than "pip3". Make sure you're using Python 3, as borgmatic does not support Python 2. - ### Other ways to install Along with the above process, you have several other options for installing diff --git a/docs/how-to/upgrade.md b/docs/how-to/upgrade.md index 8ba14e107..e0c1e7f27 100644 --- a/docs/how-to/upgrade.md +++ b/docs/how-to/upgrade.md @@ -7,7 +7,7 @@ In general, all you should need to do to upgrade borgmatic is run the following: ```bash -sudo pip3 install --upgrade borgmatic +sudo pip3 install --user --upgrade borgmatic ``` See below about special cases. @@ -25,14 +25,14 @@ already running borgmatic with Python 3, then you can upgrade borgmatic in-place: ```bash -sudo pip3 install --upgrade borgmatic +sudo pip3 install --user --upgrade borgmatic ``` But if you were running borgmatic with Python 2, uninstall and reinstall instead: ```bash sudo pip uninstall borgmatic -sudo pip3 install borgmatic +sudo pip3 install --user borgmatic ``` The pip binary names for different versions of Python can differ, so the above @@ -67,7 +67,7 @@ from atticmatic to borgmatic by running the following commands: ```bash sudo pip3 uninstall atticmatic -sudo pip3 install borgmatic +sudo pip3 install --user borgmatic ``` That's it! borgmatic will continue using your /etc/borgmatic configuration