Quickstart SetupΒΆ

Deploy Trustpoint with Docker Compose on a Linux server. You need Docker Engine, Docker Compose v2.32.4 or newer, Git, Python 3, and administrator access.

git clone https://github.com/Trustpoint-Project/trustpoint.git
cd trustpoint
cp .env.example .env
chmod 600 .env
# Set a strong database password and the server's TLS names/IP addresses.
sudo python3 docker/init_secret.py --type all
docker compose up -d --build --wait --wait-timeout 300

The one-time initializer creates an installation-specific Django signing key and an independent software database KEK on the host. It never replaces an existing key. Compose mounts both read-only in all Django containers. Keep both keys, .env, and named volumes for future updates.

Open https://<your-server>/ and complete the web setup wizard. Obtain the initial bootstrap credentials from docker compose logs trustpoint. Startup handles database initialization, migrations, and HTTPS configuration.

For automated setup, set these values in .env before starting:

TP_AUTO_SETUP=true
TP_ADMIN_USERNAME=admin
TP_ADMIN_PASSWORD=<a-strong-password>
TP_INJECT_DEMO_DATA=false

Configure TP_TLS_DNS_NAMES, TP_TLS_IPV4_ADDRESSES, and TP_TLS_IPV6_ADDRESSES for the server. These values also configure allowed hosts and trusted origins. TP_HTTP_PORT and TP_HTTPS_PORT select published ports.

docker compose ps
docker compose logs --tail 100 trustpoint
docker compose stop

Stop with stop or down to keep persistent data. Do not use down -v for routine maintenance. Existing 1.0 installations must preserve both keys and all runtime state before container replacement. Trustpoint 1.0.0 is the first stable version and the baseline for subsequent updates.

See Docker Compose Deployment for published images, workers, SoftHSM, demo mail/SFTP services, external PostgreSQL, upgrades, and secret recovery. Continue with Quickstart Operation Guide after setup.