Uninstalling and moving

How to stop Tesria, move it, or remove it. Stopping keeps everything; moving takes the wiki with it; removing deletes it. Each is below, in that order, from the gentlest to the one that cannot be undone.

Stopping

docker compose down

Stops and removes the containers. Your data stays in its volumes, and docker compose up -d brings everything back as it was.

Moving one space

A wiki pack carries one space, with its pages, history, comments and attachments, to another Tesria. Export it with Export as a pack in the space’s settings, then import it on the other Tesria with Import a pack on the Spaces page. See Wiki packs.

Moving the whole Tesria

To a new computer, taking everything: every space, account and setting. It moves the newest backup across and restores it.

Step 1: Take a backup on the old computer

Choose Admin, Backups, Back up now, and wait until it finishes.

Step 2: Pack up the backups

In the Tesria folder on the old computer:

docker run --rm -v tesria_backups:/b -v "$PWD":/out alpine tar czf /out/tesria-backups.tgz -C /b .

That makes tesria-backups.tgz. Copy it to the new computer, into its Tesria folder.

Step 3: Install Tesria on the new computer

As in Quick start, with a new .env, and the same DOMAIN to keep the same address. Start it with docker compose up -d --build, wait until app is healthy, and skip the setup wizard.

Step 4: Restore the backup

docker compose cp tesria-backups.tgz backup:/tmp/
docker compose exec backup tar xzf /tmp/tesria-backups.tgz -C /backups
docker compose exec backup ls /backups

Then restore the newest dump by its name, and restart Tesria:

docker compose exec backup /scripts/restore.sh db-<time>.dump
docker compose restart app
docker compose restart collab

Step 5: Point people at the new computer

If you use a domain, point it at the new server. If people use the local certificate, each device trusts the new one: see Trusting the local certificate. Then set up the offsite copies again, as in Offsite copies.

Removing Tesria completely

docker compose down -v --rmi local

-v deletes the volumes, which hold the database, the attachments and the backups. --rmi local deletes the images built for Tesria. Offsite copies are not touched: delete those from your cloud storage, network drive or removable drive yourself. Then you can delete the Tesria folder.