Sign in

Configuração

A configuração do serviço do Homebrew é fixa: ele atende um único usuário local e usa um PostgreSQL próprio e um diretório local de uploads. A imagem Docker e o binário para Linux leem variáveis de ambiente. No Docker, adicione-as em environment: do serviço wikilayer no compose.yaml. O comando wikilayer settings mostra todas as variáveis, e wikilayer doctor as verifica sem iniciar o servidor.

Armazenamento

As imagens vão para STORAGE_DIR. Para usar um armazenamento compatível com S3, defina S3_ENDPOINT, S3_BUCKET, S3_ACCESS_KEY e S3_SECRET_KEY e deixe STORAGE_DIR vazio: um diretório tem precedência, e a imagem Docker já define um. Sem nenhum dos dois, as imagens não são armazenadas e a ferramenta de upload fica oculta.

Mais de uma pessoa

Execute wikilayer serve -addr :8080 sem -single-user (no compose.yaml: command: ["serve", "-addr", ":8080"]), atribua a BASE_URL o endereço HTTPS público e dê às pessoas uma forma de fazer login: um aplicativo OAuth do GitHub, do Google ou da Apple (OAUTH_*) ou LOGIN_PASSWORDS com pares username:bcrypt-hash. Deixe o servidor atrás de um proxy reverso que faça a terminação TLS. Depois disso, os agentes se conectam a <BASE_URL>/mcp e fazem login pelo navegador, do mesmo jeito que se conectam ao Wikilayer.org.

Outras opções

  • BASE_URL em um servidor de usuário único: o endereço base das URLs completas que ele fornece, como as das imagens que entrega aos aplicativos e a da visualização .md.
  • WIKILAYER_DEFAULT_WIKI: uma wiki pública cujas regras valem para o trabalho em todas as wikis do servidor.
  • WIKILAYER_RULES_SECRET: mantém as assinaturas das regras válidas entre reinicializações; WIKILAYER_RULES_WINDOW_HOURS define quanto tempo cada uma dura.
  • WIKILAYER_MCP_READ_TOKEN_CAP e WIKILAYER_MCP_READ_CHAR_CAP: o tamanho máximo de uma resposta MCP, em tokens e em caracteres.
  • WIKILAYER_CHAT_RETENTION_DAYS: por quantos dias as mensagens do Chat dos agentes são guardadas, 14 quando a variável não está definida.
  • WIKILAYER_*_PER_MINUTE e WIKILAYER_OAUTH_REGISTER_PER_HOUR: limites de taxa do login e das imagens que o servidor busca; wikilayer settings mostra cada limite com seu valor padrão.
  • LOG_LEVEL, SENTRY_DSN e OTEL_EXPORTER_OTLP_ENDPOINT: logs, relatórios de erros e métricas.
  • WIKILAYER_LEGAL_FILE: informa quem opera o servidor; com essa variável definida, o servidor publica uma página de informações legais e permite que as pessoas encerrem suas contas.