Zum Inhalt springen
DE EN

Lokal ausprobieren

Mit dieser Seite läuft Lalabase auf deinem eigenen Rechner, ohne Domain, Zertifikat und Mailserver. Sie ist zum Ausprobieren gedacht. Für einen Server nimmst du stattdessen Docker Compose, für die Arbeit am Code DEVELOPMENT.md.

Du brauchst Docker Desktop (Docker 24 oder neuer mit Compose v2) und dafür etwa 4 GB Arbeitsspeicher. Apple Silicon und Intel gehen beide.

Installieren

Hol das neueste Release und schreib eine .env mit frischen Schlüsseln. Kopiere alles auf einmal:

git clone https://github.com/lalabase/lalabase.git
cd lalabase
git checkout "$(git tag --list '[0-9][0-9][0-9][0-9].[0-9]*.[0-9]*' --sort=-v:refname | head -1)"

cat > .env <<EOF
LALABASE_HOST=localhost:3000
LALABASE_PORT=3000
LALABASE_FORCE_SSL=false
SECRET_KEY_BASE=$(openssl rand -hex 64)
ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY=$(openssl rand -hex 32)
ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY=$(openssl rand -hex 32)
ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT=$(openssl rand -hex 32)
POSTGRES_PASSWORD=$(openssl rand -hex 24)
EOF

docker compose up -d

Ist Port 3000 schon belegt, etwa von einer anderen Rails-Anwendung? Dann ändere beide Zeilen, zum Beispiel auf LALABASE_HOST=localhost:3100 und LALABASE_PORT=3100. Lalabase antwortet nur auf die Adresse in LALABASE_HOST.

Warte, bis docker compose ps bei web den Zustand healthy zeigt.

Nur zum Ausprobieren

LALABASE_FORCE_SSL=false schaltet die Weiterleitung auf HTTPS und die sicheren Cookies ab. Auf einem Server, der aus dem Netz erreichbar ist, hat die Einstellung nichts zu suchen.

Admin und ersten Benutzer anlegen

Leg den Instanz-Admin an. Der Befehl fragt nach einer E-Mail-Adresse und einem Passwort mit mindestens 12 Zeichen:

docker compose exec web bin/rails lalabase:setup

Danach legst du deinen Benutzer ganz ohne Mail an:

  1. Melde dich unter http://localhost:3000/admin an.
  2. Öffne http://localhost:3000/admin/users/new, trag Name und E-Mail-Adresse ein und benenne eine neue Organisation.
  3. Notier dir das temporäre Passwort aus der Meldung oben auf der nächsten Seite. Es erscheint nur dieses eine Mal.
  4. Melde dich damit unter http://localhost:3000/users/sign_in an und ändere das Passwort.

Der Befehl selbst verweist auf die Registrierung unter /users/sign_up. Lass sie hier aus: Ohne Mail kommt die Bestätigung nie an, und das Konto ist nach drei Tagen gesperrt.

Anhalten und entfernen

docker compose stop        # anhalten, deine Daten bleiben
docker compose start       # wieder starten
docker compose down -v     # alles entfernen, auch alle Daten

Nächste Schritte