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

Execute o Wikilayer em um computador com Docker e Compose. O [repositório Docker do Wikilayer](https://github.com/wikilayer/docker), que é público, contém o `compose.yaml` e os arquivos usados para gerar a imagem. O Compose inicia o binário do Wikilayer e o PostgreSQL 16. A interface web e o endpoint MCP local escutam em `localhost:38731`; o banco de dados não recebe porta no host.

<!-- block:70315 -->
## Iniciar com o Compose

Em um shell POSIX (WSL no Windows), prepare os arquivos do Compose:

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

Se você também usa o Wikilayer com [Homebrew](page:70116) neste Mac, pare esse serviço antes; as duas instalações usam a porta 38731:

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

Inicie os contêineres:

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

<!-- block:70316 -->
## Abrir e conectar

Abra a interface web local em `http://localhost:38731`, depois [conecte um agente local](page:70118) e experimente os [primeiros passos](page:70097).

<!-- block:70317 -->
## Verificar e parar

No diretório `docker` clonado, verifique se os dois serviços estão em execução e exiba a versão do servidor:

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

Para parar os contêineres sem apagar os dados deles:

```sh
docker compose stop
```

Se você também usa a instalação com Homebrew neste Mac, pode iniciá-la de novo depois que o Docker parar:

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

<!-- block:70318 -->
## Atualizar e preservar seus dados

Para atualizar, atribua a `WIKILAYER_VERSION`, no `.env`, uma tag publicada, ou deixe a variável não definida para usar `latest`; depois execute:

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

O Compose guarda o banco de dados e os arquivos enviados em volumes nomeados. O `docker compose down` mantém esses volumes; o `docker compose down -v` os apaga. Faça backup dos dois volumes antes de atualizar e gere um dump do PostgreSQL antes de mudar a versão principal dele.

---

## Links here

- [Homebrew](page:70116)
- [Hospedagem própria](page:70080)
- [Migrar do Wikilayer.org](page:70120)

---

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