Base de Conhecimento

Docmost na VPS: documentação da equipe no seu servidor

  • docmost, wiki, documentação da equipe, docker, vps
  • Usuários acharam útil: 0

Docmost 0.97.0: licença AGPL-3.0 e partes Enterprise, instalação com Docker Compose e Caddy, HTTPS, setup do workspace, e-mail, backup do banco e dos arquivos e atualização.

Por Redação Eleven Host · @robson.direitodigital · 14 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: Docmost na VPS: documentação da equipe no seu servidor

Capa da Redação Eleven Host para o tutorial: Docmost na VPS: documentação da equipe no seu servidor Arte: Eleven Host

Docmost na VPS é uma wiki de documentação colaborativa, com núcleo de código aberto, que a equipe mantém no próprio servidor: edição em tempo real e espaços para organizar as páginas.

Atualizado em 14/11/2026. Confira cada comando no seu servidor antes de usar. O artigo O que é servidor VPS: guia simples para iniciantes explica o que é uma VPS, e Vikunja na VPS: tarefas da equipe no seu servidor mostra outra ferramenta da equipe no mesmo estilo.

O que é o Docmost

O repositório oficial descreve o Docmost como um software de wiki e documentação colaborativa. A lista de recursos da edição open source traz colaboração em tempo real, espaços, gerenciamento de permissões, grupos, comentários, histórico de páginas, busca, anexos de arquivos, diagramas (Draw.io, Excalidraw e Mermaid) e conteúdo incorporado de serviços como Airtable, Loom e Miro.

Os serviços que sobem junto no compose oficial são o PostgreSQL e o Redis. A instalação oficial usa Docker com Docker Compose, que a documentação chama de modo de instalação recomendado.

Em 14/11/2026, a versão estável mais nova do Docmost é a 0.97.0, de 25/10/2026. Abaixo da 0.96.0 há falhas de segurança publicadas, então o exemplo abaixo fixa a tag 0.97.0, e a beta não entra.

Licença e o que é pago

O núcleo do Docmost está sob a licença AGPL-3.0. Os arquivos das pastas ee do repositório seguem a licença Enterprise do projeto, que só permite uso em produção a quem tem uma assinatura válida do Docmost Enterprise. Por isso, chamar o Docmost inteiro de código aberto seria impreciso.

A documentação lista três edições: Open Source, Business e Enterprise. As duas últimas são comerciais, partem da edição aberta e pedem uma chave de licença para ativar seus recursos. Se a licença Enterprise vence, os recursos pagos saem do ar, o workspace volta à edição open source e o conteúdo continua intacto.

A página de preços do projeto lista, como recursos da edição Business, o login único (SAML 2.0, OIDC e LDAP), a autenticação em dois fatores (MFA), permissões granulares por página, IA, o importador do Confluence, a busca dentro de anexos e as chaves de API. A Enterprise soma SCIM, logs de auditoria, verificação de página e integração com o Microsoft 365. Os valores e as condições ficam com o projeto.

Sobre versões: as notas das releases 0.80.1, 0.90.1, 0.95.0 e 0.96.0 falam em correções de segurança, e a 0.97.0 cita correções para falhas recentes do Node.js e recomenda atualizar. Entre as falhas publicadas em versões anteriores estão leitura de arquivos do servidor, vazamento de conteúdo entre espaços privados e desvio da autenticação em dois fatores. A tag latest do compose oficial não fixa a versão, e a tag beta 0.98.0-beta.1 também fica de fora.

Antes de começar: o servidor e o endereço

O passo a passo parte de uma VPS Ubuntu nova, acessada por SSH com um usuário que usa sudo. A página do Docker para Ubuntu lista as versões 22.04, 24.04 e 26.04 (LTS) e a 26.10, todas de 64 bits. O consumo depende do uso da equipe, então acompanhe-o depois da instalação; para pensar em espaço, veja Quanto de disco precisa uma VPS: como calcular.

Também vale ter um domínio e escolher um subdomínio para a wiki, como docs.seudominio.com.br.

Preço de entrada para comparar: VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Atualizar o sistema e instalar o Docker

Começamos atualizando o sistema. Um exemplo de comando:

sudo apt update && sudo apt upgrade -y

Depois, o repositório apt do Docker, conforme a página oficial do Docker para Ubuntu. Um exemplo de comandos:

sudo apt install ca-certificates curl

sudo install -m 0755 -d /etc/apt/keyrings

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

sudo chmod a+r /etc/apt/keyrings/docker.asc

O arquivo /etc/apt/sources.list.d/docker.sources é criado por um bloco de várias linhas. Copie esse bloco direto da página de instalação do Docker para Ubuntu (docs.docker.com/engine/install/ubuntu), em vez de digitá-lo de memória, e rode o sudo apt update em seguida. Então vêm os pacotes e o teste. Um exemplo:

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo docker run hello-world

Se a VPS usa o ufw, libere o SSH antes de ativá-lo, para não perder o acesso, e libere as portas 80 e 443, que o certificado HTTPS vai usar. Um exemplo:

sudo ufw allow OpenSSH

sudo ufw allow 80/tcp

sudo ufw allow 443/tcp

sudo ufw enable

O Docker passa por cima do ufw

A documentação do Docker avisa que as portas publicadas por contêineres ignoram as regras de firewall do ufw e do firewalld. O compose oficial do Docmost, sem proxy, publica a porta 3000 em todas as interfaces. Por isso o modelo com Caddy, usado aqui, deixa o serviço docmost sem ports. Quem preferir outro proxy no mesmo servidor pode, como alternativa a conferir no próprio servidor, prender a porta em 127.0.0.1:3000:3000, e precisa repassar os cabeçalhos Upgrade e Connection.

Domínio apontado e arquivos do compose

Antes de subir qualquer coisa, aponte o subdomínio para o IP da VPS, com um registro A no DNS do seu domínio, e confira se as portas 80 e 443 estão liberadas. O Caddy pede o certificado ao Let's Encrypt na primeira subida, e isso depende desses dois pontos. Em seguida, crie a pasta e baixe o compose oficial. Um exemplo de comandos:

mkdir docmost

cd docmost

curl -O https://raw.githubusercontent.com/docmost/docmost/main/docker-compose.yml

Gere os segredos. Um exemplo, rodado duas vezes: a primeira saída vai no APP_SECRET e a segunda, na senha do banco. A documentação pede um APP_SECRET longo e aleatório, com 32 caracteres no mínimo, e o aplicativo não sobe com o valor padrão. A saída em hexadecimal serve também para a senha do banco, porque só tem letras e números, e símbolos como @, : e / podem atrapalhar a URL de conexão:

openssl rand -hex 32

A página do Docmost com o Caddy traz o arquivo completo e atualizado. Abra essa página (docmost.com/docs/self-hosting/reverse-proxy/caddy), use o modelo com Caddy no lugar do arquivo baixado e confira estas trocas no docker-compose.yml:

  • A imagem do docmost vem como docmost/docmost:latest; troque por docmost/docmost:0.97.0.
  • O APP_URL deve ter https:// e o seu domínio real, por exemplo https://docs.seudominio.com.br. Os links dos e-mails usam essa URL.
  • O APP_SECRET recebe o primeiro valor gerado.
  • A senha do banco, que vem como STRONG_DB_PASSWORD, é trocada nas duas linhas: em POSTGRES_PASSWORD e dentro do DATABASE_URL. Os dois valores precisam ser iguais.
  • O serviço docmost fica sem ports, e o serviço caddy publica as portas 80 e 443.

Na mesma pasta, crie o arquivo Caddyfile com o conteúdo do exemplo da documentação, trocando o domínio:

docs.seudominio.com.br {

reverse_proxy docmost:3000

}

Segundo a documentação, o Caddy obtém e renova os certificados do Let's Encrypt sozinho e cuida das conexões WebSocket. O editor em tempo real precisa delas: sem o repasse dos cabeçalhos Upgrade e Connection, o editor fica só para leitura.

E-mail, Draw.io e telemetria

Para convidar pessoas por e-mail, o Docmost precisa de e-mail configurado. As variáveis oficiais são MAIL_DRIVER (smtp ou postmark), SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD, MAIL_FROM_ADDRESS e MAIL_FROM_NAME. Elas entram no bloco environment do serviço docmost. No compose, o formato CHAVE: 'valor' acompanha as demais linhas do bloco; vale conferir no seu arquivo. Um exemplo, com valores fictícios:

MAIL_DRIVER: 'smtp'

SMTP_HOST: 'smtp.exemplo.com'

SMTP_PORT: '587'

SMTP_USERNAME: 'usuario'

SMTP_PASSWORD: 'senha-do-e-mail'

MAIL_FROM_ADDRESS: 'docs@exemplo.com'

MAIL_FROM_NAME: 'Documentação'

Dois detalhes de privacidade. Por padrão, os diagramas do Draw.io abrem num servidor externo, o https://embed.diagrams.net, definido na variável DRAWIO_URL. E a telemetria anônima de uso pode ser desligada com DISABLE_TELEMETRY, por exemplo com o valor true.

Subir e criar o workspace

Com o DNS apontado, as portas liberadas e o compose conferido, suba os serviços. Um exemplo de comando:

sudo docker compose up -d

Abra https://docs.seudominio.com.br e faça o setup logo: segundo a documentação, quem conclui o setup vira o dono do workspace, e a página de setup cria o workspace e a conta. Depois, o dono pode convidar as outras pessoas.

Para conferir se o serviço responde, abra https://docs.seudominio.com.br/api/health no navegador.

Guarde o APP_SECRET e faça backup

A documentação de backup explica que o Docmost guarda os dados do workspace no PostgreSQL e os arquivos enviados em disco (ou em armazenamento de objetos), e que os arquivos são copiados à parte. Guarde o APP_SECRET original fora da VPS: ele é necessário para decifrar os segredos de MFA, então, sem ele, uma restauração não recupera esse recurso. Mantenha as cópias privadas.

Arquivos alterados durante a cópia podem não bater com o banco. Por isso a documentação sugere parar as instâncias do Docmost até que as duas cópias terminem. Um exemplo de comandos, na pasta do compose, com o usuário e o banco docmost do compose oficial:

mkdir -p ~/backup-docmost

sudo docker compose stop docmost

sudo docker compose exec -T db pg_dump -U docmost -d docmost -Fc > ~/backup-docmost/docmost-database.dump

sudo docker compose run --rm --no-deps -T --user root --entrypoint tar docmost -czf - -C /app/data/storage . > ~/backup-docmost/docmost-storage.tar.gz

cp docker-compose.yml Caddyfile ~/backup-docmost/

sudo docker compose start docmost

Depois, leve a pasta backup-docmost para fora da VPS. A página de backup traz também os comandos de restauração.

Atualização

A documentação recomenda copiar o banco antes de atualizar. Com a tag fixa, o procedimento oficial é trocar a tag da imagem do docmost no docker-compose.yml, por exemplo de 0.97.0 para a versão nova, e rodar os dois comandos abaixo na pasta do compose. A página de releases pede que se leiam as notas da versão antes de atualizar. Um exemplo:

sudo docker compose pull docmost

sudo docker compose up -d --force-recreate docmost

Endereço da wiki

O endereço da wiki é um subdomínio de um domínio que você já tem ou vai registrar.

A pesquisa de nome livre e o registro de domínio ficam na loja da Eleven Host, com centenas de extensões. Buscar domínio

Perguntas frequentes

O Docmost é de código aberto?

Em parte: o núcleo está sob a AGPL-3.0, e a edição open source tem os recursos listados acima. As edições Business e Enterprise são comerciais, e as pastas ee pedem assinatura para uso em produção.

Qual versão instalar?

Em 14/11/2026, a 0.97.0. Abaixo da 0.96.0 há falhas de segurança publicadas, e a tag beta não deve ser usada.

Preciso configurar e-mail?

Para convidar pessoas por e-mail, sim: a documentação diz que o e-mail precisa estar configurado, por SMTP ou Postmark.

Esta resposta lhe foi útil?

Artigos Relacionados