<!-- page:69171 -->
# Docker

Führen Sie Wikilayer auf einem Computer mit Docker und Compose aus. Das öffentliche [Docker-Repository von Wikilayer](https://github.com/wikilayer/docker) enthält die Bauanleitung für das Image und `compose.yaml`. Compose startet die Wikilayer-Binärdatei und PostgreSQL 16. Die Weboberfläche und der lokale MCP-Endpunkt lauschen auf `localhost:38731`; die Datenbank erhält keinen Port auf dem Host.

<!-- block:69449 -->
## Mit Compose starten

Bereiten Sie in einer POSIX-Shell (unter Windows WSL) die Compose-Dateien vor:

```sh
git clone https://github.com/wikilayer/docker.git
cd docker
printf 'POSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 24)" > .env
```

Wenn Sie Wikilayer auf diesem Mac auch mit [Homebrew](page:69170) betreiben, beenden Sie zuerst diesen Dienst; beide Installationen verwenden Port 38731:

```sh
brew services stop wikilayer/tap/wikilayer
```

Starten Sie die Container:

```sh
docker compose up -d
```

<!-- block:69450 -->
## Öffnen und verbinden

Öffnen Sie die lokale Weboberfläche unter `http://localhost:38731`, [verbinden Sie dann einen lokalen Agenten](page:69172) und probieren Sie die [ersten Schritte](page:69151) aus.

<!-- block:69451 -->
## Überprüfen und beenden

Prüfen Sie im geklonten Verzeichnis `docker`, ob beide Dienste laufen, und geben Sie die Serverversion aus:

```sh
docker compose ps
docker compose exec -T wikilayer wikilayer version
```

Um die Container zu beenden, ohne ihre Daten zu löschen:

```sh
docker compose stop
```

Wenn Sie auf diesem Mac auch die Homebrew-Installation verwenden, können Sie sie wieder starten, sobald Docker beendet ist:

```sh
brew services start wikilayer/tap/wikilayer
```

<!-- block:69452 -->
## Aktualisieren und Ihre Daten behalten

Setzen Sie zum Aktualisieren `WIKILAYER_VERSION` in `.env` auf ein veröffentlichtes Tag oder lassen Sie die Variable für `latest` ungesetzt, und führen Sie dann Folgendes aus:

```sh
docker compose pull
docker compose up -d
```

Compose legt die Datenbank und die hochgeladenen Dateien in benannten Volumes ab. `docker compose down` behält sie; `docker compose down -v` löscht sie. Sichern Sie vor Aktualisierungen beide Volumes und erstellen Sie einen PostgreSQL-Dump, bevor Sie die Hauptversion von PostgreSQL wechseln.

---

## Links here

- [Homebrew](page:69170)
- [Selbst hosten](page:69140)
- [Umzug von Wikilayer.org](page:69174)

---

[All pages](https://wikilayer.org/smee-again/wikilayer-howto/de/index.md)
