teamplanner21/team-planner-backend repository overview

⁠Team Planner — Backend

FastAPI backend for Team Planner, a self-hosted team availability, capacity-planning, and on-call/alerting platform. Runs entirely inside your own infrastructure — no data leaves your cluster.

This image is one half of a two-container app. It needs a PostgreSQL database and, for the UI, the companion teamplanner21/team-planner-frontend⁠ image — it isn't meant to run standalone.

📖 Full step-by-step installation guide⁠ — Docker Compose trial and production Kubernetes/Helm, plus the first-login setup wizard walkthrough. The quick start below is the short version.

⁠Quick start (Docker Compose)

services:
  db:
    image: postgres:16
    environment:
      POSTGRES_DB: planner
      POSTGRES_USER: planner
      POSTGRES_PASSWORD: planner

  backend:
    image: teamplanner21/team-planner-backend:latest
    environment:
      DATABASE_URL: postgresql://planner:planner@db:5432/planner
      APP_SESSION_SECRET: change-me-to-a-long-random-string
      LOCAL_ADMIN_PASSWORD: change-me
      APP_BASE_URL: http://localhost:8080/team-planner/
    ports:
      - "8000:8000"
    depends_on:
      - db

  frontend:
    image: teamplanner21/team-planner-frontend:latest
    ports:
      - "8080:8080"
    depends_on:
      - backend

Then open http://localhost:8080/team-planner/⁠ — log in as admin with whatever you set LOCAL_ADMIN_PASSWORD to.

⁠Kubernetes (production)

Use the official Helm chart — installs this image, the frontend, and PostgreSQL together with sane defaults, ingress/Istio support, auto-generated secrets, and horizontal scaling:

https://github.com/alpyanar82/team-planner-helm⁠

git clone https://github.com/alpyanar82/team-planner-helm
cd team-planner-helm
cp values.example.yaml my-values.yaml   # edit: hostname, company name
helm install team-planner . -f my-values.yaml --namespace team-planner --create-namespace

⁠Full source & docs

Application source, environment variable reference, and architecture docs: https://github.com/alpyanar82/team-planner⁠

⁠Tags

• latest, 1.0.0 — current stable release.

⁠License

FREE tier runs immediately after install (up to 20 users / 2 teams, no signup required). Upload a license from Admin > License to unlock TRIAL/PAID limits and additional integrations (SSO, Personio, Workday, Outlook, Microsoft Teams).