Skip to main content
Updating keeps your settings and data. Backing up means copying Emplio’s Docker volumes and your .env.

Update

Run the installer again:
Or, from the folder you installed to:
It keeps your .env, downloads the newest images, restarts Emplio and checks it’s up. The installer replaces the other files in ~/emplio, so keep your own changes in .env.

What to back up

Keep a copy of .env too. Without the same ENCRYPTION_KEY, saved passwords and keys can’t be read.

Back up with Docker

Docker names the volumes after the install folder, so in ~/emplio they are emplio_postgres-data and so on. Check yours with docker volume ls. This stops Emplio for a moment, writes one archive per volume to ~/emplio/backups, and starts it again:
Copy the backups folder somewhere off the machine.
Never run docker compose down -v. The -v deletes the volumes, and with them all of Emplio’s data.

Restore

On the new machine, put your .env in the install folder first, so the installer keeps it. Unpack each archive into the volume of the same name before Emplio starts, then run ./setup.sh.

Configuration

What each setting in .env does.

Troubleshooting

If something doesn’t come back up.