Auto-Hospedagem com Docmost: Equipes, Espaços & Permissões (2026)

Implantar o Docmost no seu VPS é apenas o começo. O verdadeiro valor vem de como você estrutura a base de conhecimento da sua equipe. Este guia cobre o lado prático de usar o Docmost para uma equipe: organizar espaços, definir permissões, entender casos de uso e aproveitar ao máximo a auto-hospedagem.

Por que Equipes Escolhem o Docmost

O Docmost foi criado para substituir a fricção do Confluence e o lock-in de Notion. Para quem faz auto-hospedagem, ele resolve um problema real: equipes de empresas precisam de documentos colaborativos com controle de acesso, e o mercado open-source carecia de uma opção refinada até o surgimento do Docmost.

Razões principais pelas quais as equipes escolhem o Docmost:

• Sem preços por seat - seu custo é apenas o VPS (~$5-6/mês)
• Soberania de dados - todos os documentos ficam no seu servidor
• Colaboração em tempo real - cursores ao vivo, sem conflitos de salvamento
• Estrutura hierárquica - páginas aninhadas funcionam como no Notion
• Permissões granulares - controle de quem pode ver, comentar ou editar em cada nível

VPS Recomendado para Uso em Equipe

Para uma equipe de até 20 usuários, recomendamos:

Entendendo a Estrutura do Docmost

O Docmost organiza o conteúdo em três níveis:

Workspace
  └── Space (por exemplo, "Engenharia", "Produto", "RH")
        └── Page (por exemplo, "Referência API")
              └── Sub-page (por exemplo, "Autenticação")

Workspace: O container de nível superior para toda a sua organização. Todos os usuários dentro de um workspace podem se ver.

Espaços: Pense como departamentos ou projetos. Cada espaço tem seus próprios membros e permissões. Um usuário pode ser membro de alguns espaços, mas não de outros.

Páginas: Os documentos propriamente ditos. As páginas suportam sub-páginas aninhadas para hierarquias profundas de documentação.

Configurando Espaços para Sua Equipe

Uma boa estrutura de espaços separa interesses e reduz ruído. Exemplos de configurações:

Para uma empresa de software:

Engenharia/
  Decisões de Arquitetura
  Referência API
  Runbooks
Produto/
  Roadmap
  Especificações de Funcionalidades
  Pesquisa de Usuário
RH/
  Onboarding
  Políticas

Para uma agência:

Interno/
  Processos
  Modelos
Cliente-NomeProjeto/
  Briefings
  Entregas
  Notas de Reunião

Para criar um espaço no Docmost:

1. Clique em “Novo Espaço” na barra lateral
2. Nomeie o espaço e opcionalmente defina um ícone
3. Defina a visibilidade do espaço (público para workspace ou privado)
4. Adicione membros e atribua funções

Modelo de Permissões

O Docmost usa controle de acesso baseado em papéis em dois níveis:

Papéis no Workspace

• Proprietário: Administração total - gerencia cobrança, membros e todas as configurações
• Administrador: Pode gerenciar membros e espaços
• Membro: Usuário padrão com acesso aos espaços permitidos

Papéis em Espaço

• Administrador: Pode gerenciar configurações do espaço, membros e todas as páginas
• Editor: Pode criar e editar páginas
• Visualizador: Acesso somente leitura

Configure um espaço como privado e adicione apenas os membros relevantes. Isso é ideal para espaços sensíveis como RH ou Finanças.

Colaboração em Tempo Real na Prática

O Docmost usa transformação operacional (OT) para lidar com edições simultâneas. Na prática:

• Vários usuários veem os cursores uns dos outros enquanto editam
• As mudanças são sincronizadas imediatamente, sem necessidade de salvar manualmente
• O histórico da página permite reverter a qualquer versão anterior

Para que funcione bem, seu VPS precisa de uma conexão estável e suporte adequado a WebSocket na configuração do Nginx (veja os cabeçalhos Upgrade e Connection no nosso guia de instalação).

Integrações e Extensões

O Docmost suporta várias integrações nativamente:

• SMTP para e-mails: Para convites e notificações - configure em Configurações > Email
• OIDC/SSO: Conecte ao Keycloak, Authentik, ou qualquer provedor OIDC para autenticação centralizada
• Domínio personalizado: Hospede o Docmost no seu subdomínio usando Nginx
• Webhooks: Dispare ações externas quando páginas forem criadas ou atualizadas (verifique a versão atual para disponibilidade)

Casos de Uso

Wiki de Equipe de Engenharia

Armazene decisões arquitetônicas (ADRs), runbooks de implantação, post-mortems de incidentes e documentação da API. Os blocos de código e páginas aninhadas do Docmost tornam as documentações técnicas legíveis.

Base de Conhecimento Interna

Políticas de RH, checklists de onboarding, manual da empresa - tudo em um só lugar, com acesso somente leitura para funcionários e edição para o equipe de RH.

Documentação de Projetos

Use um espaço por cliente ou projeto. Compartilhe links de leitura apenas com stakeholders externos ou restrinja ao time interno.

Gestão de Conhecimento Pessoal

Uma única instância do Docmost também pode servir para uma pessoa que deseja uma alternativa auto-hospedada do Notion - mais barato e mais privativo do que qualquer SaaS.

Dicas de Manutenção

• Backups: Agende backups diários usando pg_dump e armazene fora do servidor (S3, Backblaze B2, etc.)
• Atualizações: Rode docker compose pull && docker compose up -d regularmente para aplicar patches de segurança
• Monitoramento: Use Uptime Kuma (também auto-hospedado) para alertar se o Docmost sair do ar
• Verificação de recursos: Rode docker stats periodicamente para monitorar uso de RAM conforme sua equipe cresce

Escalando Além de Um VPS

Se sua equipe crescer consideravelmente, o Docmost pode escalar horizontalmente - mas para a maioria das equipes com menos de 100 usuários, um único VPS como Hetzner ou Contabo dará conta confortavelmente. O gargalo costuma ser o PostgreSQL; atualizar para um servidor com mais RAM e armazenamento NVMe resolve a maior parte dos problemas de desempenho.

Para mais guias de auto-hospedagem, visite selfhostvps.com/en/best/.