Update Backups-Guide.md with more detailed backup/restore instructions (#683)
I think this guide could use a bit more detail on how exactly to take a Mastodon dump and restore it. I found it very non-obvious (as a Postgres noob myself).
This commit is contained in:
parent
34d9b15b74
commit
c2f1715019
|
@ -50,14 +50,31 @@ What this example looks like as a cron job:
|
||||||
[pg_dump](https://www.postgresql.org/docs/9.5/static/app-pgdump.html) is an utility that comes with PostgreSQL that can be used extract the contents of a
|
[pg_dump](https://www.postgresql.org/docs/9.5/static/app-pgdump.html) is an utility that comes with PostgreSQL that can be used extract the contents of a
|
||||||
PostgreSQL database.
|
PostgreSQL database.
|
||||||
|
|
||||||
Please read the documentation page linked above for all relevant usage details.
|
Here is how to use `pg_dump` to back up and restore a Mastodon PostgresSQL database:
|
||||||
|
|
||||||
|
As the `mastodon` user, create a `backup.dump` file:
|
||||||
|
|
||||||
Here is an example:
|
|
||||||
```sh
|
```sh
|
||||||
# Dump Mastodon's PostgreSQL database into a SQL-script file
|
pg_dump -Fc mastodon_production > backup.dump
|
||||||
pg_dump mastodon_production > mastodon_production.sql
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
To restore, first delete the database **(make sure it is backed up first!)**:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
dropdb mastodon_production
|
||||||
|
```
|
||||||
|
|
||||||
|
Then restore using `createdb` and `pg_restore`:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
createdb -T template0 mastodon_production
|
||||||
|
pg_restore -Fc -n public -d mastodon_production backup.dump
|
||||||
|
```
|
||||||
|
|
||||||
|
You will want to make sure that Mastodon is not running during the backup/restore process.
|
||||||
|
|
||||||
|
#### pg_dump maintenance scripts
|
||||||
|
|
||||||
If you are looking for a pre-written set of scripts to maintain PostgreSQL backups using pg_dump, you can find them [here](https://wiki.postgresql.org/wiki/Automated_Backup_on_Linux).
|
If you are looking for a pre-written set of scripts to maintain PostgreSQL backups using pg_dump, you can find them [here](https://wiki.postgresql.org/wiki/Automated_Backup_on_Linux).
|
||||||
|
|
||||||
## User generated content (images, avatars, headers)
|
## User generated content (images, avatars, headers)
|
||||||
|
|
Loading…
Reference in New Issue