Tesria

Building from source

Tesria is developed the same way it is run: with Docker. You change the code on your computer, rebuild the part you changed, and look at it in the browser.

What you need

  • Docker with Compose v2: Docker Desktop on a Mac or Windows, or Docker Engine on Linux.

  • Git.

  • For the tests: the .NET 10 SDK, and Node.js 22 with npm.

Step 1: Get the code

Bash / Shell
git clone https://github.com/Tesria/Tesria.git
cd Tesria

Step 2: Make your settings file

Copy .env.example to .env and fill in the passwords and keys it asks for. Installing with Docker Compose explains each one. For development, DOMAIN=localhost is right.

Step 3: Build and start everything

Bash / Shell
docker compose up -d --build

The first build takes several minutes: it compiles the .NET app and the web app, and downloads the other images. Then open https://localhost and the setup wizard makes your account.

Step 4: After a change, rebuild what you changed

The web app and the API are built into one image, app, so a change to either is:

Bash / Shell
docker compose up -d --build app

A change to the collaboration service or the PDF service rebuilds collab or pdf the same way. Reload the browser to see it.

Start the whole stack, not the database alone. On a new database, PostgreSQL stops every few seconds until the pgbackrest service has set up its backups, because it cannot archive its changes yet. docker compose up -d starts both.

Applies to

Tesria 0.6 and later

Updated

September 24, 2026

Changes

Revised.