Quick Start

This is the fastest way to see Trusted Servants Pro running on your own machine. If you're deploying to a public server with a domain and HTTPS, follow the full Installation guide instead.

Prerequisites

• Docker Engine and the Compose plugin. Verify with:

docker --version && docker compose version

1. Create the project

Make an empty directory and add a docker-compose.yml:

services:
  tsp:
    image: viibeware/trusted-servants-pro:latest
    container_name: tspro
    ports:
      - "8090:8000"
    volumes:
      - ./data:/data
    environment:
      - TSP_SECRET_KEY=${TSP_SECRET_KEY:?TSP_SECRET_KEY must be set in .env}
    restart: unless-stopped

2. Generate a secret key

The portal signs session cookies with TSP_SECRET_KEY. Write a random one into a .env file next to the compose file:

echo "TSP_SECRET_KEY=$(openssl rand -hex 32)" > .env

3. Start it

docker compose up -d

The image pulls and the container starts in the background. Your data lives in ./data and survives restarts and upgrades.

4. Sign in

Open the two entry points:

→ http://localhost:8090         # public site
→ http://localhost:8090/tspro   # admin backend

Sign in to the admin with the seeded account:

user: admin   ·   pass: admin

What next?

• Installation — the full production install with a domain, automatic HTTPS, and auto-updates.
• Configuration & Security — environment variables and how secrets are stored.
• Backup & Restore — keep your data safe.