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

Ejecuta Wikilayer en un equipo con Docker y Compose. El [repositorio público de Docker de Wikilayer](https://github.com/wikilayer/docker) contiene `compose.yaml` y los archivos con los que se construye la imagen de Docker. Compose arranca el binario de Wikilayer y PostgreSQL 16. La interfaz web y el punto de conexión MCP local escuchan en `localhost:38731`; la base de datos no expone ningún puerto en el equipo anfitrión.

<!-- block:70044 -->
## Iniciar con Compose

En un shell POSIX (WSL en Windows), prepara los archivos de Compose:

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

Si también ejecutas Wikilayer con [Homebrew](page:69720) en este equipo Mac, detén antes ese servicio; las dos instalaciones usan el puerto 38731:

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

Inicia los contenedores:

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

<!-- block:70045 -->
## Abrir y conectar

Abre la interfaz web local en `http://localhost:38731`, después [conecta un agente local](page:69722) y prueba los [primeros pasos](page:69701).

<!-- block:70046 -->
## Comprobar y detener

Desde el directorio `docker` clonado, comprueba que los dos servicios están en marcha y muestra la versión del servidor:

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

Para detener los contenedores sin borrar sus datos:

```sh
docker compose stop
```

Si también usas la instalación con Homebrew en este equipo Mac, puedes volver a iniciarla una vez detenido Docker:

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

<!-- block:70047 -->
## Actualizar y conservar tus datos

Para actualizar, asigna a `WIKILAYER_VERSION` en `.env` una etiqueta publicada, o déjala sin definir para usar `latest`, y ejecuta:

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

Compose guarda la base de datos y los archivos subidos en volúmenes con nombre. `docker compose down` los conserva; `docker compose down -v` los borra. Haz una copia de seguridad de los dos volúmenes antes de actualizar, y un volcado de PostgreSQL antes de cambiar de versión principal de PostgreSQL.

---

## Links here

- [Autoalojamiento](page:69690)
- [Homebrew](page:69720)
- [Migrar desde Wikilayer.org](page:69724)

---

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