Runzos

BookStack, Outline ou Docmost: qual wiki privada subir na VPS?

Por Maicon Ramos · · 12 min de leitura

Servidor VPS conectado a três sistemas abstratos de wiki privada, com biblioteca, colaboração e integrações.
Navegue por tópicos
  1. Resposta curta: qual escolher por perfil
  2. Qual wiki puxa qual pilha?
  3. A wiki custa a pilha que ela puxa
  4. BookStack: quando a estrutura ganha da flexibilidade
  5. Outline: quando a equipe justifica Postgres, Redis e identidade
  6. Docmost: o meio-termo moderno, com ressalvas
  7. Custos ocultos que não aparecem na licença
  8. O que uma wiki não resolve
  9. Checklist antes de colocar em produção
  10. FAQ
  11. Conclusão: escolha a responsabilidade que você aceita operar

BookStack é a escolha mais direta para solo builders e agências pequenas que priorizam uma wiki estruturada. Outline faz mais sentido para equipes que valorizam colaboração e integrações. Na avaliação editorial do Runzos, Docmost ocupa um meio-termo moderno, com API e MCP, mas com PostgreSQL, Redis e a maturidade de um projeto mais novo para acompanhar. Em todos os casos, a licença não elimina a operação.

Uma wiki privada em VPS pode organizar processos, clientes e decisões sem espalhar conhecimento por conversas e arquivos soltos. Mas a decisão não é só sobre o editor. Ela inclui banco, autenticação, arquivos, cópias externas, atualização e capacidade de recuperar o ambiente.

A resposta curta é simples: escolha a responsabilidade que sua equipe consegue manter. O software pode ser aberto. A operação nunca é automática.

Resposta curta: qual escolher por perfil

Se o seu cenário é...

Escolha preliminar

Por quê

Solo builder ou agência pequena que quer documentação organizada e menos serviços para administrar

BookStack

A instalação pede PHP e MySQL ou MariaDB. A documentação não coloca Redis ou OAuth como requisito central.

Equipe com colaboração intensa, integrações e capacidade de operar identidade, PostgreSQL e Redis

Outline

O ambiente de referência prevê PostgreSQL, Redis, storage e ao menos um provedor de login.

Equipe que quer uma wiki moderna, API e MCP, aceitando uma pilha com PostgreSQL e Redis

Docmost

O Compose oficial reúne aplicação, PostgreSQL e Redis. Docker é o modo recomendado de instalação.

BookStack para estrutura e menor atrito

Onde ganha, na avaliação editorial: BookStack é a recomendação padrão quando a prioridade é previsibilidade. A aplicação requer PHP 8.2 ou superior e usa MySQL 8.0+ ou MariaDB 10.6+ para conteúdo e dados, conforme os requisitos oficiais do BookStack.

Casos práticos adequados: manuais internos, processos recorrentes e documentação de clientes para uma agência pequena são cenários em que essa estrutura pode ser mais fácil de manter. Isso não transforma a instalação em algo sem trabalho. A própria documentação pressupõe familiaridade com hospedagem de aplicações PHP e banco de dados. Ainda assim, a ausência de Redis e de um login externo como exigências centrais reduz as peças obrigatórias da pilha.

Ativo visual verificável: esta é uma comparação documental, não um relato de uso pessoal. A referência verificável para BookStack é a página oficial de instalação.

Outline para colaboração e integrações

Onde ganha, na avaliação editorial: Outline é indicado quando a experiência colaborativa justifica mais serviços. O arquivo de ambiente oficial configura PostgreSQL e Redis, aceita armazenamento local ou compatível com S3 e exige pelo menos um provedor de login de terceiros. Sem ele, a instalação fica sem opção de login.

Casos práticos adequados: equipes que já mantêm identidade e precisam conectar colaboração, login e notificações podem justificar essa pilha. Também existe e-mail transacional no escopo. O mesmo ambiente documenta SMTP para login por e-mail e notificações de atualização. Não é um defeito: é o custo técnico de uma ferramenta pensada para equipes conectadas a uma camada de identidade e integrações.

Ativo visual verificável: sem screenshot de uso real do Runzos, a comparação permanece documental. O arquivo .env.sample oficial do Outline é a referência visual e técnica para PostgreSQL, Redis, storage e provedores de login.

Docmost para uma wiki moderna com ressalvas

Onde ganha, na avaliação editorial: Docmost atende quem procura uma experiência moderna de documentação com API e MCP. A instalação oficial recomenda Docker e oferece um Compose com Docmost, PostgreSQL e Redis. Para colaboração em tempo real, o proxy reverso precisa encaminhar WebSockets corretamente.

Casos práticos adequados: equipes que pretendem integrar automações pela API ou MCP e já aceitam operar PostgreSQL e Redis podem considerar essa opção. O projeto aceita armazenamento local, S3 compatível e Azure Blob. Também documenta e-mail por SMTP ou Postmark para convidar usuários. O núcleo aberto usa AGPL-3.0, enquanto recursos Enterprise têm licença separada. Portanto, vale analisar a licença aplicável antes de modificar ou redistribuir a solução.

Ativo visual verificável: não há screenshot de uso pessoal do Runzos. A página oficial de instalação do Docmost mostra o Compose de referência com os três serviços e sustenta esta comparação documental.

Veja uma VPS para subir sua wiki e os serviços ao redor dela.

Qual wiki puxa qual pilha?

Camada

BookStack

Outline

Docmost

Banco

MySQL 8.0+ ou MariaDB 10.6+

PostgreSQL

PostgreSQL no Compose oficial

Redis

Não é requisito central da instalação

Configurado no ambiente de referência

Incluído no Compose oficial

Autenticação

Pode usar opções como OpenID Connect, LDAP e SAML

Pelo menos um provedor de login de terceiros no ambiente oficial

Configuração de acesso da aplicação

Arquivos

Local por padrão; S3 ou compatível é opção

Local ou S3 compatível

Local por padrão; S3 compatível ou Azure Blob

E-mail

Avaliar conforme seu fluxo de uso

SMTP para login e notificações

SMTP ou Postmark para convites

Proxy e colaboração

Proxy/TLS conforme a arquitetura escolhida

Avaliar conforme a implantação

WebSockets devem passar pelo proxy

Licença

MIT

Licença própria do repositório

AGPL-3.0 no núcleo aberto; Enterprise separada

Perfil indicado

Estrutura e menor atrito

Colaboração e integrações

Modernidade, API e MCP

Três arquiteturas de wiki em VPS, da pilha mais simples à estrutura com banco, cache, identidade e colaboração.

A quantidade de serviços obrigatórios altera o esforço de operação de cada wiki privada.

A tabela não mede desempenho, consumo de RAM ou quantidade de usuários. As fontes verificadas não trazem um mínimo universal comparável para os três produtos. Qualquer promessa desse tipo exigiria teste com versão, carga e ambiente definidos.

A wiki custa a pilha que ela puxa

Chamamos isso de Custo de Pilha: o custo real de auto-hospedar é a soma da aplicação com todos os serviços persistentes e rotinas que ela exige. A licença é apenas uma parte da decisão.

Banco, Redis, arquivos e proxy

O BookStack usa filesystem local por padrão para sessões, cache e arquivos enviados. A documentação prevê alternativas como banco, Memcached ou Redis para sessão e cache, além de S3 ou compatível para arquivos. Isso permite evoluir a arquitetura, mas exige decidir onde os dados vão sobreviver e como serão copiados.

Outline e Docmost já começam com PostgreSQL e Redis na referência de implantação. No Docmost, a colaboração em tempo real também depende de WebSockets no proxy reverso. Docker Compose ajuda a repetir a instalação. Não substitui versionamento de configuração, volumes identificados ou um plano de recuperação.

Autenticação, e-mail e WebSockets

Uma wiki que será usada por mais pessoas precisa de acesso controlado e fluxo de convite. No Outline, o provedor de login de terceiros não é detalhe: o ambiente oficial pede pelo menos um. No Docmost, os convites por e-mail dependem de driver de e-mail configurado.

A leitura do Runzos é objetiva: coloque identidade e e-mail no desenho antes de convidar a equipe. Descobrir essas dependências depois da publicação cria atalhos de acesso e configurações improvisadas.

Wiki self-hosted ligada a banco, cache, storage, proxy, identidade, e-mail, backup e monitoramento.

O custo real inclui os serviços persistentes e as rotinas que mantêm a wiki disponível e recuperável.

Por que Docker não elimina a operação

A documentação do Docmost diz que Docker é o modo recomendado de instalação. Isso descreve como empacotar e subir a aplicação. Não garante backup, segurança ou alta disponibilidade.

A reconciliação prática do Runzos é tratar o Compose como unidade de operação: arquivo versionado sem segredos, banco e arquivos com cópia externa, health check, atualização documentada e restauração ensaiada. Quem não quer assumir essa unidade deve reduzir dependências ou considerar hospedagem gerenciada.

BookStack: quando a estrutura ganha da flexibilidade

BookStack organiza conteúdo em prateleiras, livros, capítulos e páginas. Essa estrutura favorece processos repetíveis, manuais internos e documentação que precisa de uma navegação previsível.

Para uma agência pequena, o ganho não é “custo zero”. É começar com uma pilha que depende de PHP e MySQL ou MariaDB, sem transformar Redis, OAuth e integrações em pré-requisito. Antes de padronizar processos extensos, avalie também a exportação e a migração de conteúdo.

Backup e filesystem local

BookStack não traz mecanismo embutido de backup e restauração. A orientação oficial de backup do BookStack aponta para procedimentos por linha de comando.

Volume persistente não equivale a backup. Uma cópia útil precisa estar fora da VPS e deve ser restaurada em um ambiente de teste. Sem esse teste, você só sabe que criou arquivos de backup; não sabe se consegue recuperar a wiki.

Outline: quando a equipe justifica Postgres, Redis e identidade

Outline é a opção para uma equipe que precisa de colaboração e integrações e aceita operar mais camadas. PostgreSQL, Redis, storage e provedor de login aparecem no ambiente de referência do projeto. A aplicação não deve ser tratada como um único container isolado.

Login de terceiros não é detalhe

A exigência de um provedor de login muda a conversa. A equipe precisa decidir qual identidade vai autorizar o acesso e quem administra esse provedor. O ganho é um fluxo mais conectado à operação. O custo é adicionar uma dependência que também precisa ser mantida.

Storage local ou S3 e e-mail transacional

Outline aceita arquivos locais ou S3 compatível. S3 não é obrigatório pela fonte, mas pode ser uma escolha de arquitetura quando a equipe deseja separar arquivos da VPS. O SMTP também precisa entrar na lista quando login por e-mail ou notificações fizerem parte do fluxo.

Docmost: o meio-termo moderno, com ressalvas

Docmost combina interface colaborativa, API e um servidor MCP documentado. Esse servidor permite que clientes de IA pesquisem, leiam, criem e atualizem páginas com a API key existente. É um recurso útil para automação, não uma razão para ignorar controle de acesso.

Compose com Postgres e Redis

O Compose oficial traz aplicação, PostgreSQL e Redis. O segredo da aplicação deve ser aleatório e ter pelo menos 32 caracteres; o valor padrão faz a aplicação falhar ao iniciar. O domínio, as senhas e o proxy fazem parte da implantação, não são detalhes de acabamento.

Licença, API, MCP e WebSockets

A licença exige atenção. O núcleo aberto é AGPL-3.0, enquanto recursos Enterprise usam licença Enterprise separada. Não misture os dois modelos nem suponha que um recurso Enterprise esteja livre para qualquer cenário.

Para equipes que já automatizam processos, a API e o MCP podem ser atraentes. Se essa automação fizer parte da sua rotina, vale também ver nosso comparativo de automação com n8n e Make. A wiki continua sendo documentação; ela não substitui a ferramenta que orquestra processos.

Custos ocultos que não aparecem na licença

Uma aplicação aberta pode evitar uma assinatura de SaaS. Ela não elimina a VPS, domínio, TLS, e-mail, backup externo, monitoramento, atualização e o tempo de quem opera a stack.

Também há um custo de suporte interno. Alguém precisa criar contas, revisar permissões, orientar uso e decidir como o conhecimento será organizado. Se ninguém tem essa responsabilidade, o problema não é qual wiki escolher.

Atualização e restauração

Atualizar é parte da operação porque versões, imagens Docker e dependências mudam. O caminho prudente é registrar a configuração, fazer cópia antes da mudança e saber como voltar atrás.

Restauração é a prova. Faça backup do banco e dos arquivos, recupere em ambiente separado e confirme que páginas, anexos e acessos voltaram. Sem esse passo, “temos backup” é apenas uma hipótese.

Wiki em VPS enviando cópias protegidas a um cofre remoto e restaurando os dados em um ambiente de teste.

Backup só se torna confiável quando a restauração é testada fora do servidor de produção.

O que uma wiki não resolve

Uma wiki concentra conhecimento. Ela não substitui helpdesk, CRM ou gestão de projetos. Atendimento por ticket e e-mail pede fluxo de suporte. Relacionamento comercial pede dados e processos de CRM. Entrega e acompanhamento de trabalho pedem uma ferramenta de projetos.

Misturar tudo em uma wiki parece simples no início. Depois, a equipe perde rastreabilidade de pedidos, responsáveis e prazos. Use a wiki para documentar como a operação funciona, não como substituta de toda a operação.

Checklist antes de colocar em produção

Item

O que confirmar

Domínio e TLS

O endereço público e o certificado estão definidos.

Segredos

Senhas e chaves não estão em arquivos versionados.

Banco e volumes

Os dados persistentes foram identificados.

Cópia externa

Banco e arquivos têm destino fora da VPS.

Restauração

Uma recuperação foi testada em ambiente separado.

Atualização

Existe um procedimento para atualizar e reverter.

Monitoramento

A equipe sabe como verificar se a aplicação responde.

E-mail

Convites, login e notificações têm driver configurado quando necessário.

Acesso

Pessoas e permissões foram revisadas antes de abrir a wiki.

Para stacks com Docker, compare também a opção de VPS da Hostinger. A escolha deve considerar a capacidade de operar a pilha, não só o primeiro deploy.

Como alternativa contextual para avaliar onde rodar uma stack com Docker, veja também a opção de VPS da Servla. A decisão continua sendo operacional: confirme a compatibilidade da sua arquitetura antes do deploy.

FAQ

BookStack, Outline ou Docmost: qual usa menos infraestrutura?

BookStack tende a exigir menos serviços obrigatórios na instalação de referência. Ele requer PHP e MySQL ou MariaDB. Outline e Docmost trabalham com PostgreSQL e Redis nas configurações oficiais analisadas. Isso não prova que BookStack será melhor em qualquer cenário, mas faz dele a escolha mais direta para quem quer uma wiki estruturada e menor atrito operacional.

Preciso de Redis para hospedar uma wiki privada?

Não como regra universal. Redis aparece no ambiente de referência do Outline e no Compose oficial do Docmost. No BookStack, a documentação o apresenta como opção para sessão e cache, junto de outras alternativas. Escolha a ferramenta primeiro e implemente a arquitetura documentada para ela, em vez de adicionar serviços por hábito.

Posso usar armazenamento local em vez de S3?

Sim, nas três ferramentas há cenário documentado de armazenamento local. BookStack usa filesystem local por padrão para itens como arquivos enviados. Outline permite local ou S3 compatível. Docmost também usa local por padrão e aceita S3 compatível ou Azure Blob. Armazenamento local exige uma estratégia clara de backup externo.

Uma wiki open source é realmente sem custo?

Não. A licença pode não cobrar assinatura, mas ainda existem VPS, domínio, TLS, backup, monitoramento, e-mail e tempo de operação. O Custo de Pilha também cresce quando entram PostgreSQL, Redis, identidade, proxy e automações. Compare o total de responsabilidade, não só o preço da licença.

Qual delas é melhor para uma agência pequena?

BookStack é o ponto de partida mais sensato quando a agência quer processos bem organizados e prefere uma pilha menor. Outline serve melhor quando colaboração e integrações justificam PostgreSQL, Redis e identidade externa. Docmost é uma alternativa para quem valoriza API e MCP, aceita sua pilha e fará a avaliação de licença necessária.

Conclusão: escolha a responsabilidade que você aceita operar

BookStack vence para uma estrutura de documentação com menos camadas obrigatórias. Outline vence quando colaboração, integrações e identidade são centrais. Docmost é uma opção moderna para equipes que querem API e MCP, sem ignorar PostgreSQL, Redis, WebSockets e licença.

A síntese do Runzos não é escolher a ferramenta com mais recursos. É escolher a pilha que sua equipe consegue atualizar, copiar e restaurar. Se essa responsabilidade cabe na operação, veja uma VPS para hospedar sua wiki e os serviços associados.

BookStackOutlineDocmostWiki privadaVPSDocker Compose

Compartilhe:

Leia também