mirror of
https://github.com/borgmatic-collective/borgmatic.git
synced 2026-08-07 00:23:20 +02:00
add docs for database restore params and config bootstrap
This commit is contained in:
@@ -338,6 +338,29 @@ within the database dump:
|
||||
borgmatic restore --archive latest --database users --schema tentant1
|
||||
```
|
||||
|
||||
### Restore to an alternate host
|
||||
<span class="minilink minilink-addedin">New in version 1.7.15</span> You
|
||||
can restore a database dump to a host other than the one from which it was
|
||||
originally dumped. You can also change other connection parameters like the
|
||||
username, password, and port. This can be done from the command line:
|
||||
|
||||
```bash
|
||||
borgmatic restore --archive latest --database users --hostname database2.example.org --port 5433 --username postgres --password trustsome1
|
||||
```
|
||||
|
||||
Or from the configuration file:
|
||||
|
||||
```yaml
|
||||
hooks:
|
||||
postgresql_databases:
|
||||
- name: users
|
||||
hostname: database1.example.org
|
||||
restore_hostname: database1.example.org
|
||||
restore_port: 5433
|
||||
restore_username: postgres
|
||||
restore_password: trustsome1
|
||||
```
|
||||
|
||||
|
||||
### Limitations
|
||||
|
||||
|
||||
@@ -45,6 +45,22 @@ in the right place before running the command—or see below about the
|
||||
`--destination` flag.
|
||||
|
||||
|
||||
## Extract the configuration file used to create an archive
|
||||
|
||||
<span class="minilink minilink-addedin">New in version 1.7.15</span> Borgmatic
|
||||
also stores the configuration file used to create an archive, inside the
|
||||
archive itself. This is useful in cases where you've lost your configuration
|
||||
file, or you want to see what configuration was used to create a particular
|
||||
archive.
|
||||
|
||||
To extract the configuration file from an archive, use the `config bootstrap` action:
|
||||
|
||||
```bash
|
||||
borgmatic config bootstrap --repository repo.borg --destination /tmp
|
||||
```
|
||||
|
||||
This extracts the configuration file from the latest archive in the repository `repo.borg` to `/tmp/config.yaml`.
|
||||
|
||||
## Repository selection
|
||||
|
||||
If you have a single repository in your borgmatic configuration file(s), no
|
||||
|
||||
Reference in New Issue
Block a user