Simplify install

[thomasboni]

Summary

• Replace the 8-step manual installation with a single interactive install.sh wizard that prompts for configuration, auto-generates secrets, and writes .env
• Consolidate 4 production compose files into one compose.yml using Docker Compose profiles (letsencrypt/custom-certs, internal-db)
• Extract image tags into a git-tracked versions.env so git pull updates them automatically
• Add scripts/update.sh with auto-detection of existing setup for transparent migration from the old format
• Add scripts/preflight.sh to validate system requirements and configuration before launch

Installation (new)

# One-liner
curl -fsSL https://raw.githubusercontent.com/getplumber/platform/main/install.sh | bash

# Or from cloned repo
git clone https://github.com/getplumber/platform.git && cd platform
./install.sh

Update (new)

./scripts/update.sh

Breaking changes

• compose.custom_certs.yml, compose.external_postgres.yml, compose.custom_certs_external_postgres.yml, and compose.with_postgres_migration.yml are removed
• compose.yml now requires COMPOSE_PROFILES in .env (set automatically by install.sh or scripts/update.sh)
• CERTIFICATE_EMAIL removed (no longer used by Let's Encrypt)
• Requires Docker Compose v2.20.2+ (for depends_on: required: false)

Migration for existing users

Run ./scripts/update.sh instead of the old manual update flow. On first run, it auto-detects the previous setup (TLS method + database type), shows the detected profile, and asks for confirmation before writing COMPOSE_PROFILES to .env.

Test plan

• Fresh install via ./install.sh with Let's Encrypt + internal DB + entire instance on self hosted GitLab
• Fresh install via ./install.sh with Let's Encrypt + internal DB + group organization on gitlab.com
• Fresh install via ./install.sh with custom certs + external DB
• Fresh localhost install
• ./scripts/preflight.sh catches missing Docker, wrong version, unavailable ports
• docker compose config validates with all 4 profile combinations
• compose.local.yml still works for local development
• Migration from old .env format via ./scripts/update.sh (verify auto-detection)

---

Note

Medium Risk
Changes the primary installation and deployment configuration (compose structure, required env vars, and update/migration flow), which can break existing self-managed setups if profiles/variables are misdetected or missing.

Overview
Simplifies self-managed installation by adding an interactive install.sh that runs preflight checks, prompts for GitLab/OIDC + deployment choices, generates secrets, writes .env, and optionally starts the stack.

Consolidates production Docker Compose into a single compose.yml using COMPOSE_PROFILES (letsencrypt vs custom-certs, optional internal-db), updates compose.local.yml to use defaults/explicit localhost URLs, and removes the old split compose files.

Adds scripts/preflight.sh and scripts/update.sh (including migration that auto-detects missing COMPOSE_PROFILES), introduces git-tracked versions.env for image tags, updates .env examples/README install instructions, and bumps Helm chart/app versions plus backend/worker image tags to v2.36.5.

^{Written by Cursor Bugbot for commit d05d641. Configure here.}

[thomasboni]

I need to update installation documentation accordingly to this before putting it in review.

[cursor]

Cursor Bugbot has reviewed your changes and found 3 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}