Zum Hauptinhalt springen

Schnellstart mit Docker Compose

Diese Seite startet ein selbst gehostetes sol2flow mit Docker Compose: die App und eine PostgreSQL-Datenbank. Damit können Sie sol2flow auf Ihrer eigenen Hardware ausprobieren. Für einen Produktivserver folgen Sie anschließend der Installation; sie ergänzt HTTPS, E-Mail und Backups.

Kein Server nötig

Wenn Sie sol2flow nutzen möchten, ohne einen Server zu betreiben, erstellen Sie stattdessen ein Cloud-Konto.

Was Sie brauchen​

  • Einen Rechner mit Docker und dem Docker Compose-Plugin (Linux, macOS oder Windows mit WSL 2).
  • Etwa 1 GB freien Arbeitsspeicher und einige GB Speicherplatz für die Datenbank und hochgeladene Dateien.
  • openssl (oder eine andere Möglichkeit, zufällige Secrets zu erzeugen).

1. Einen Ordner mit zwei Dateien anlegen​

mkdir sol2flow && cd sol2flow

Legen Sie compose.yml an:

name: sol2flow
services:
  app:
    image: ghcr.io/sol2flow/sol2flow:${SOL2FLOW_VERSION:-latest}
    restart: unless-stopped
    env_file: .env
    environment:
      DATABASE_URL: postgresql://sol2flow:${POSTGRES_PASSWORD:-sol2flow}@db:5432/sol2flow?schema=public
    ports: ["3000:3000"]
    volumes: [uploads:/data/uploads]
    depends_on: { db: { condition: service_healthy } }
  db:
    image: postgres:18-alpine
    restart: unless-stopped
    environment: { POSTGRES_USER: sol2flow, POSTGRES_PASSWORD: "${POSTGRES_PASSWORD:-sol2flow}", POSTGRES_DB: sol2flow }
    volumes: [pgdata:/var/lib/postgresql] # from PostgreSQL 18 not …/data (data: …/18/docker)
    healthcheck: { test: ["CMD-SHELL", "pg_isready -U sol2flow"], interval: 5s, retries: 20 }
volumes: { pgdata: {}, uploads: {} }

Legen Sie .env mit Ihren eigenen Secrets und dem ersten Administrator an:

cat > .env <<ENV
APP_URL=http://localhost:3000
AUTH_SECRET=$(openssl rand -base64 32)
APP_ENCRYPTION_KEY=$(openssl rand -base64 32)
POSTGRES_PASSWORD=$(openssl rand -hex 16)
[email protected]
BOOTSTRAP_ADMIN_USERNAME=admin
BOOTSTRAP_ADMIN_PASSWORD=choose-a-long-password
ENV

2. Starten​

docker compose up -d
docker compose logs -f app     # wait for "applying migrations", then the server start; Ctrl+C stops following

Das Datenbankschema wird beim ersten Start automatisch angelegt.

3. Anmelden​

Öffnen Sie http://localhost:3000 und melden Sie sich mit BOOTSTRAP_ADMIN_USERNAME und BOOTSTRAP_ADMIN_PASSWORD aus Ihrer .env an. Dieses Konto ist der Owner der Instanz. Die Instanz startet leer: Es gibt keine weiteren Konten und keine Demodaten. Danach:

  1. Erstellen Sie Ihren ersten Workspace und Ihr erstes Board.
  2. Öffnen Sie Admin, um sich die Instanz-Einstellungen anzusehen (Administration).
  3. Entfernen Sie BOOTSTRAP_ADMIN_PASSWORD aus .env. Der Wert wird nur gelesen, solange die Instanz keine Benutzer hat.
E-Mails

Standardmäßig werden E-Mails (Einladungen, Passwort-Zurücksetzungen) ins Log der App geschrieben, statt verschickt zu werden. Richten Sie SMTP ein, bevor Sie jemanden einladen.

Nächste Schritte​