Tesria
Tesria.com

Quick start

This page takes you from a computer with Docker to your own Tesria, open in your browser and ready for its guided setup. You type three commands; the rest is waiting while Tesria downloads. There are no passwords to invent: Tesria makes its own.

If you have not yet, read Prerequisites first: it explains Docker, and what to have ready.

Throughout this page, your-server stands for your server’s address: the name people will type to reach Tesria, such as studio.local or wiki.example.com. On the computer Tesria runs on, localhost works too.

Step 1: Download Tesria

Open a terminal (Terminal on a Mac, PowerShell on Windows) on the computer Tesria will run on, go to the folder you want Tesria in, and download the latest release. On a Mac or Linux:

Bash / Shell
curl -LO https://github.com/Tesria/Tesria/releases/latest/download/tesria-deploy.zip unzip tesria-deploy.zip -d tesria && cd tesria

On Windows, in PowerShell:

powershell
Invoke-WebRequest https://github.com/Tesria/Tesria/releases/latest/download/tesria-deploy.zip -OutFile tesria-deploy.zip Expand-Archive tesria-deploy.zip -DestinationPath tesria; cd tesria

That makes a folder called tesria with Tesria’s settings and scripts, about 100 KB, and moves into it. Tesria itself comes as ready-made images, downloaded in step 2. Run the rest of the commands on this page from that folder.

Already have a Tesria on this computer? A second one needs its own name, network and ports in its .env before it first starts, or it is the first Tesria again. See Installing with Docker Compose, under A second Tesria on the same computer.

Step 2: Start Tesria

Have a web address pointed at this computer, such as wiki.example.com? Tell Tesria before the first start, so it can get a certificate for it. Otherwise skip this. On a Mac or Linux:

Bash / Shell
echo DOMAIN=wiki.example.com > .env

On Windows: Set-Content .env 'DOMAIN=wiki.example.com'. Every other setting is optional; Configuration reference lists them.

Bash / Shell
docker compose up -d

This downloads Tesria’s images, the ready-made software for each of its parts, for Intel, AMD or ARM computers alike, and starts them. -d lets them carry on in the background, so you get your terminal back. The download is several hundred megabytes the first time; later starts take seconds.

While it starts, Tesria makes its passwords and keys, sets up its database, and starts backing itself up. There is nothing else to install.

Always start everything together. On a new install, starting only the database with docker compose up -d db makes it restart over and over, because its backups wait for the backup service that starts alongside it.

Step 3: Save Your Backup Key

Tesria has written the key that encrypts your backups to a file called backup-key.txt in the tesria folder. Open it, and copy the key into your password manager, or anywhere that is not this computer.

Without this key, the continuous backup cannot be restored, by anyone. That is the backup you can rewind to any moment. If this computer is lost before the key is saved somewhere else, that backup is lost with it. The nightly dumps and attachment archives do not need the key, but their copies off this computer need the passphrase set for each place they go, so save those too.

Once it is saved, you may delete the file. While the computer is running, this prints the key again:

Bash / Shell
docker compose run --rm init show-backup-key

The setup wizard asks about the key too, and Administration keeps reminding you until someone says it is saved.

Step 4: Open Tesria in your browser

Go to https://your-server, or https://localhost on the computer Tesria runs on.

  • With a web address of your own, you see a padlock and Tesria straight away.

  • With localhost or your computer’s name, the browser warns that the connection is not private the first time. Your server is fine: it has made its own certificate, which the browser does not know yet. Trusting the local certificate explains why and makes the warning go away for good, one device at a time.

To check that Tesria is up, open https://your-server/api/health. It answers with a short line of text that includes "status":"ok".

Step 5: Follow the setup wizard

Tesria opens its setup wizard, which creates your account as the owner and asks a few questions about who can join and how much backup history to keep. It takes a few minutes; First-run setup wizard goes through every step.

Do the setup straight away. Until it is done, the first person to open the address and create an account becomes the owner. Finish the wizard before you share the address with anyone.

Building from source instead

If you want to change Tesria, or would rather build it yourself than download its images, clone the repository instead of step 1, and build in step 2:

Bash / Shell
git clone https://github.com/Tesria/Tesria.git cd Tesria
Bash / Shell
docker compose up -d --build

Building takes several minutes the first time, and needs more memory than running (see System requirements). Contributing covers working on the code.

Next

Once the wizard is done, Your first space and page walks you through writing something. When other devices on your network need to reach Tesria, see Opening Tesria by name. And Installing with Docker Compose explains what each part of Tesria does and where it keeps your data.


Applies to

Tesria 0.5 and later

Updated

October 2, 2026

Changes

Revised.