Quick Start

Prerequisites

• Docker 24.0+ with Compose v2
• Two (sub)domains: one for the app (e.g. reports.acme.com) and one for Keycloak (e.g. auth-reports.acme.com)

Install

curl -fsSL https://presswerk.app/install.sh | bash

The installer will:

1. Check that Docker is installed and running
2. Ask for your domain name
3. Generate secure passwords automatically
4. Pull and start all containers

What’s Running

After installation, three containers are running:

Container	Port	Description
presswerk-app	8080	Application (API + Frontend)
presswerk-keycloak	8081	Identity Provider (Keycloak 26)
presswerk-postgres	5432	Database (PostgreSQL 16)

First Login

1. Open http://localhost:8080 and sign in with the admin email and temporary password shown during installation
2. You will be prompted to set a new password on first login

After signing in, you can invite additional users from Settings → Users. See User Management for details.

Next Steps

• Configure a reverse proxy for TLS (HTTPS)
• Set up DNS for your domain
• Configure email for invite emails and scheduled reports
• Activate a license to unlock more features
• Manage users — invite users, assign roles, set up groups