# 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](https://lalabase.com/docs/de/self-hosting/installation/docker-compose), für die Arbeit am Code
[`DEVELOPMENT.md`](https://github.com/lalabase/lalabase/blob/main/DEVELOPMENT.md).

Du brauchst [Docker Desktop](https://www.docker.com/products/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:

```bash
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.

<div class="docs-callout docs-callout--danger">
  <div class="docs-callout__title">Nur zum Ausprobieren</div>
  <p><code>LALABASE_FORCE_SSL=false</code> 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.</p>
</div>

## 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:

```bash
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

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

## Nächste Schritte

- [Erstes Projekt anlegen](https://lalabase.com/docs/de/guides/basics/first-project).
- Das [CLI-Tool](https://lalabase.com/docs/de/cli/getting-started/overview) mit `url = "http://localhost:3000"`
  verbinden oder einen Agenten über [MCP](https://lalabase.com/docs/de/mcp/introduction/overview).
- Die KI mit deinem eigenen [Schlüssel](https://lalabase.com/docs/de/self-hosting/configuration/ai-byok) einschalten.