Clarify documentation about restoring a database: borgmatic does not create the database upon restore.

2024-02-09 15:35:29 -08:00 · 2024-02-09 15:35:29 -08:00 · 5586aab967
parent 6fa5dff79b
commit 5586aab967
3 changed files with 9 additions and 1 deletions
--- a/4
+++ b/4
@ -1,3 +1,7 @@
+1.8.9.dev0
+ * Clarify documentation about restoring a database: borgmatic does not create the database upon
+   restore.
+
 1.8.8
 * #370: For the PostgreSQL hook, pass the "PGSSLMODE" environment variable through to Borg when the
   database's configuration omits the "ssl_mode" option.
--- a/docs/how-to/backup-your-databases.md
+++ b/docs/how-to/backup-your-databases.md
@ -262,6 +262,10 @@ systems that you'd like supported.

 ## Database restoration

+When you want to replace an existing database with its backed-up contents, you
+can restore it with borgmatic. Note that the database must already exist;
+borgmatic does not currently create a database upon restore.
+
 To restore a database dump from an archive, use the `borgmatic restore`
 action. But the first step is to figure out which archive to restore from. A
 good way to do that is to use the `rlist` action:
--- a/setup.py
+++ b/setup.py
@ -1,6 +1,6 @@
 from setuptools import find_packages, setup

-VERSION = '1.8.8'
+VERSION = '1.8.9.dev0'


 setup(