Execute o Wikilayer em um computador com Docker e Compose. O repositório Docker do Wikilayer, 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.
Iniciar com o Compose
Em um shell POSIX (WSL no Windows), prepare os arquivos do Compose:
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 neste Mac, pare esse serviço antes; as duas instalações usam a porta 38731:
brew services stop wikilayer/tap/wikilayer
Inicie os contêineres:
docker compose up -d
Abrir e conectar
Abra a interface web local em http://localhost:38731, depois conecte um agente local e experimente os primeiros passos.
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:
docker compose ps
docker compose exec -T wikilayer wikilayer version
Para parar os contêineres sem apagar os dados deles:
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:
brew services start wikilayer/tap/wikilayer
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:
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.