Self-Hosted Deployment

Run Showpane on your own infrastructure. You control the data, the domain, and the uptime.

Prerequisites

  • Docker and Docker Compose (v2+)
  • Git
  • A PostgreSQL-compatible database (or use the bundled container)

Steps

1. Clone the repository

git clone https://github.com/showpane/showpane.git
cd showpane

2. Create your environment file

cp .env.example .env

3. Configure environment variables

Open .env and set the required values:

# PostgreSQL connection string
DATABASE_URL="postgresql://showpane:changeme@db:5432/showpane"

# Secret for signing sessions (generate with: openssl rand -base64 32)
AUTH_SECRET="your-random-secret-here"

4. Start the containers

docker compose up -d

5. Run migrations and seed data

docker compose exec app npx prisma migrate deploy
docker compose exec app npx prisma db seed

6. Open Showpane

Visit http://localhost:8080 in your browser. The default admin credentials are printed in the seed output.

SSL with Caddy

For production, point a domain at your server and use Caddy as a reverse proxy. Caddy provisions and renews TLS certificates automatically.

# Caddyfile
portal.yourcompany.com {
    reverse_proxy localhost:8080
}

Run caddy run and your instance is live with HTTPS — no certificate management needed.