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

Exécutez Wikilayer sur un ordinateur doté de Docker et de Compose. Le [dépôt Docker de Wikilayer](https://github.com/wikilayer/docker), public, contient les fichiers de construction de l’image et `compose.yaml`. Compose démarre le binaire Wikilayer et PostgreSQL 16. L’interface web et le point de terminaison MCP local écoutent sur `localhost:38731` ; la base de données n’expose aucun port sur l’hôte.

<!-- block:69673 -->
## Démarrer avec Compose

Dans un shell POSIX (WSL sous Windows), préparez les fichiers Compose :

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

Si vous exécutez aussi Wikilayer avec [Homebrew](page:69501) sur ce Mac, arrêtez d’abord ce service ; les deux installations utilisent le port 38731 :

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

Démarrez les conteneurs :

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

<!-- block:69674 -->
## Ouvrir et connecter

Ouvrez l’interface web locale à l’adresse `http://localhost:38731`, puis [connectez un agent local](page:69503) et essayez les [premiers pas](page:69482).

<!-- block:69675 -->
## Vérifier et arrêter

Depuis le répertoire `docker` cloné, vérifiez que les deux services sont démarrés et affichez la version du serveur :

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

Pour arrêter les conteneurs sans supprimer leurs données :

```sh
docker compose stop
```

Si vous utilisez aussi l’installation Homebrew sur ce Mac, vous pouvez la redémarrer une fois Docker arrêté :

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

<!-- block:69676 -->
## Mettre à jour et garder vos données

Pour mettre à jour, attribuez à `WIKILAYER_VERSION`, dans `.env`, la valeur d’un tag publié, ou laissez-la non définie pour `latest`, puis exécutez :

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

Compose conserve la base de données et les fichiers téléversés dans des volumes nommés. `docker compose down` les garde ; `docker compose down -v` les supprime. Sauvegardez les deux volumes avant une mise à jour, et faites un dump PostgreSQL avant de changer de version majeure de PostgreSQL.

---

## Links here

- [Auto-hébergement](page:69471)
- [Homebrew](page:69501)
- [Migrer depuis Wikilayer.org](page:69505)

---

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