Guia de Solução de Problemas do Ghost CMS: WSL, Docker e ActivityPub

Lucas Moraes (CEO Toolzz AI)
20 de março de 2026

Configurar o Ghost CMS (Sistema de Gerenciamento de Conteúdo) localmente é uma ótima maneira de desenvolver temas e testar novos recursos. No entanto, ao usar o Windows ou Docker, você pode encontrar erros que interrompem seu progresso. A depuração consome tempo valioso, desviando o foco do seu trabalho principal.

Este guia oferece as causas e soluções para três erros comuns do Ghost CMS:

• Erro 1: Falhas na instalação do SQLite no Windows.
• Erro 2: Contêineres Docker travando com o código 137 (limites de memória).
• Erro 3: Erros de "Carregamento Interrompido" na guia ActivityPub Network.

Ao final deste artigo, você terá uma configuração local do Ghost estável e funcional. Saberá como usar corretamente o WSL para aplicativos Node.js, gerenciar recursos do Docker e configurar com sucesso os novos recursos sociais do Ghost.

Erro 1: Falhas na Instalação do SQLite no Windows

O Sintoma

Ao executar o comando ghost install local em uma máquina Windows, a instalação falha, exibindo uma longa lista de texto vermelho no terminal, semelhante a:

plaintext Error: Cannot find module 'sqlite3' ... node-pre-gyp ERR! stack Error: Failed to execute... ... MSB4019: The imported project "C:\Microsoft.Cpp.Default.props" was not found.

O erro geralmente menciona "sqlite3" e indica que "falhou ao executar" ou está "ausente".

A Causa

O Ghost usa o SQLite para armazenar os dados do seu blog. O SQLite é um "módulo nativo", o que significa que precisa de um pequeno código compilado especificamente para o seu sistema.

Como o Ghost foi projetado para rodar em servidores Linux, ele espera encontrar ferramentas de compilação Linux para criar esses arquivos. O Windows usa ferramentas diferentes e uma organização de arquivos distinta. Quando o Ghost CLI tenta compilar os arquivos SQLite no Windows, não encontra as ferramentas necessárias, interrompendo a instalação. Usar o WSL fornece ao Ghost o ambiente Linux esperado.

Como Corrigir:

Você pode usar o Subsistema Windows para Linux (WSL) para criar uma configuração funcional.

1. Abra seu terminal WSL (como Ubuntu).
2. Verifique suas ferramentas executando node --version, npm --version e python3 --version.
3. Instale o Ghost CLI globalmente dentro do WSL:

plaintext npm install -g ghost-cli@latest

4. Execute o comando de instalação local:

plaintext ghost install local

5. Inicie o servidor:

plaintext ghost start

Como Verificar:

Abra seu navegador e acesse http://localhost:2368. A página de boas-vindas padrão do Ghost deve carregar sem erros.

Erro 2: Contêiner Docker Sair com Código 137

O Sintoma:

Ao executar o Ghost usando o Docker Compose, os contêineres travam. Os logs do terminal mostram Ghost admin container exiting with code 137 ou Admin service killed due to memory constraints.

A Causa:

O código de erro 137 indica que seu computador ficou sem memória (RAM) e interrompeu o contêiner. Isso geralmente ocorre ao tentar executar a configuração completa do Ghost (que inclui mais de 15 ferramentas adicionais) em um computador comum.

Como Corrigir:

Para corrigir este erro, altere a configuração complexa para uma configuração simples usando a imagem oficial do Docker do Ghost.

Primeiro, pare e remova os contêineres com falha:

plaintext docker-compose down -v docker system prune -a

Em seguida, crie um novo arquivo docker-compose.yml com apenas as ferramentas básicas (Ghost e um banco de dados):

plaintext services: ghost: image: ghost:latest restart: always ports: - "2368:2368" environment: database__client: mysql database__connection__host: mysql database__connection__user: root database__connection__password: yourpassword database__connection__database: ghost url: http://localhost:2368 volumes: - ghost_content:/var/lib/ghost/content

mysql: image: mysql:8.0 restart: always environment: MYSQL_ROOT_PASSWORD: yourpassword MYSQL_DATABASE: ghost volumes: - mysql_data:/var/lib/mysql

volumes: ghost_content: mysql_data:

Em seguida, inicie a configuração simples:

plaintext docker-compose up -d

Como Verificar:

Digite docker-compose ps no terminal. Você deve ver os contêineres ghost e mysql listados com o status "Up".

Erro 3: "Carregamento Interrompido" na Análise de Rede

O Sintoma:

Ao clicar na guia Análise → Rede no painel de administração local do Ghost, a página exibe um erro de "Carregamento Interrompido". Os logs do terminal mostram erros 404 e falhas de webhook:

plaintext INFO "GET /.ghost/activitypub/v1/feed/reader/" 404 52ms ERROR No webhook secret found - cannot initialise

A Causa:

A guia Rede atua como um leitor ActivityPub, não como um painel de análise normal. Esse erro ocorre porque o ActivityPub não está configurado para uso local. Ele precisa de ferramentas adicionais (Caddy, Redis) e de um endereço da web limpo sem números de porta para funcionar.

Como Corrigir:

Para corrigir este erro, execute o Ghost com suas ferramentas Docker necessárias e atualize seu arquivo de configuração local para ativar os recursos sociais da web.

Primeiro, inicie as ferramentas necessárias (Caddy, MySQL, Redis) da sua pasta Ghost:

plaintext SSH_AUTH_SOCK=/dev/null docker compose up -d caddy mysql redis

Em seguida, abra seu arquivo config.local.json. Defina a URL para um endereço localhost limpo (remova a porta :2368) e ative os recursos de desenvolvedor:

plaintext { "url": "http://localhost", "social_web_enabled": true, "enableDeveloperExperiments": true }

Pare seu processo Ghost atual:

plaintext pkill -f "yarn dev:ghost"

E reinicie o Ghost com as novas configurações:

plaintext yarn dev:ghost

Como Verificar:

Faça login novamente no painel de administração do Ghost e clique em Análise → Rede. A mensagem de erro desaparecerá e você verá o feed ActivityPub em vez dela.

Conclusão

Configurações locais podem ser desafiadoras, especialmente ao combinar Windows, Docker e novos recursos como ActivityPub.

Ao corrigir esses três erros, você fez mais do que apenas obter o Ghost funcionando. Você aprendeu como contornar as limitações do Windows usando o WSL, como gerenciar a memória do Docker e como o Ghost encaminha o tráfego da web social.

Agora você tem um espaço de trabalho do Ghost CMS estável, rápido e totalmente funcional, pronto para o seu conteúdo. Com a Toolzz LXP, você pode escalar o aprendizado e o desenvolvimento da sua equipe de forma eficiente e centralizada.