openproject/docs/operations/backup/docker/backup.md

# Backup your OpenProject installation (Docker)

Note: this guide only applies if you've installed OpenProject with our Docker image.

If you've followed the steps described in the installation guide for Docker,
then you just need to make a backup of the exported volumes, at your
convenience. As a reminder, here is the recommended way to launch OpenProject
with Docker:

    sudo mkdir -p /var/lib/openproject/{pgdata,logs,static}

    docker run -d -p 8080:80 --name openproject -e SECRET_KEY_BASE=secret \
      -v /var/lib/openproject/pgdata:/var/lib/postgresql/9.6/main \
      -v /var/lib/openproject/logs:/var/log/supervisor \
      -v /var/lib/openproject/static:/var/db/openproject \
      openproject/community:8

If you're using the same local directories than the above command, then you
just need to backup your local `/var/lib/openproject` folder (for instance to
S3 or FTP).

If at any point you want to restore from a backup, just put your backup in
`/var/lib/openproject` on your local host, and re-launch the docker container.

## Dumping the database

**Note:** this only applies for the self-contained OpenProject container not using
an external database but instead a database right in the container.

If you need a SQL dump of your database straight from the container you can do the
following to dump it into the current directory:

```
docker exec $CONTAINER_ID bash -c \
  'export PGPASSWORD=openproject && pg_dump -U openproject -h 127.0.0.1' \
  > openproject.sql
```

If you don't know the container id (or name) you can find it out using `docker ps`.