Outline na VPS: wiki e base de conhecimento da equipe
Wiki colaborativa no servidor da empresa: licença BSL 1.1 para uso interno, provedor de login antes do primeiro acesso, Docker Compose, HTTPS e backup do banco.
Por Redação Eleven Host · @robson.direitodigital · 22 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: Outline na VPS: wiki e base de conhecimento da equipe Arte: Eleven Host
Outline na VPS é manter a wiki e a base de conhecimento da equipe num servidor da própria empresa: documentos colaborativos em tempo real, compatíveis com markdown, com login pelo provedor que a equipe já usa.
Atualizado em 22/11/2026. Confira cada comando no seu servidor antes de usar.
Em 22/11/2026, a versão estável mais recente do Outline era a 1.13.0, de 15/11/2026. A licença BSL 1.1 permite usar a wiki em produção para a própria equipe, mas não oferecer o Outline como serviço a terceiros. Não há login por senha local: o provedor de login vem antes do primeiro acesso.
O que é o Outline
O Outline é uma base de conhecimento para equipes, e a licenciante do código é a General Outline, Inc. O repositório oficial, outline/outline no GitHub, descreve o programa como uma base de conhecimento rápida para equipes em crescimento, colaborativa em tempo real e compatível com markdown. O mesmo código roda o serviço hospedado em getoutline.com; a instalação própria segue a documentação em docs.getoutline.com. Em 22/11/2026, o repositório estava ativo, com alterações no mesmo dia.
As notas da versão 1.13.0 citam, entre as novidades, data de expiração em links públicos de compartilhamento e cartões de prévia de link.
Para quem o Outline faz sentido
O Outline atende pequenas empresas e agências que querem manuais, processos e anotações de projeto num só lugar, com o servidor sob o próprio controle. Uma VPS é um servidor virtual em que você instala e administra os programas; o que é e como escolher uma está em O que é servidor VPS: guia simples para iniciantes.
Ele combina com equipes que já usam Slack, Google Workspace, Microsoft Entra ou outro login compatível com OIDC. Quem preferir outra wiki encontra, na nossa base, os artigos "BookStack na VPS" e "Docmost na VPS: documentação da equipe no seu servidor".
Um lugar para a wiki da equipe
A wiki precisa de uma máquina ligada e com endereço próprio na internet.
Como base da wiki, a VPS da Eleven Host é um servidor virtual privado. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS
Licença: o que a BSL 1.1 permite
O Outline usa a Business Source License 1.1, que o próprio texto diz não ser de código aberto; cada versão passa para Apache 2.0 em até quatro anos. O código pode ser copiado, modificado e redistribuído. O uso em produção é liberado por uma concessão adicional, com uma exceção: não é permitido usar o Outline para um "Document Service".
A licença define esse serviço como uma oferta comercial em que terceiros, que não sejam os seus funcionários e prestadores de serviço, usam as funções do programa criando equipes e documentos sob o controle deles. Pela página de restrições, vender ou hospedar o Outline como serviço encerra os direitos da licença.
Pela própria definição, uma empresa pode instalar o Outline para a sua equipe, incluindo prestadores. Para montar wikis para clientes, recomendamos ler a licença inteira e falar com o licenciante antes.
Requisitos do Outline
A página de requisitos da documentação lista:
- sistema compatível com Unix (não roda em servidor Windows);
- PostgreSQL 14 ou mais novo;
- Redis 4 ou mais novo;
- memória mínima de 512 MB, com 1 GB ou mais recomendado; a CPU depende de quantos usuários e quanto eles usam;
- um domínio ou subdomínio dedicado, como wiki.suaempresa.com.br;
- um provedor de autenticação compatível.
Anexos e imagens ficam numa pasta local ou num serviço compatível com S3, conforme a variável FILE_STORAGE. A documentação recomenda instalar com Docker e Docker Compose.
Antes de instalar: escolha o login
O Outline não tem login nativo por e-mail e senha, e o arquivo de exemplo do projeto avisa que pelo menos um provedor de autenticação é obrigatório. Como o aplicativo de login pede o endereço de retorno no domínio final, recomendamos criá-lo antes de subir a wiki. As opções do arquivo .env.sample são:
- Slack: variáveis
SLACK_CLIENT_IDeSLACK_CLIENT_SECRET; - Google:
GOOGLE_CLIENT_IDeGOOGLE_CLIENT_SECRET; pela documentação, só funciona com Google Workspace; - Microsoft Entra (Azure):
AZURE_CLIENT_ID,AZURE_CLIENT_SECRETeAZURE_RESOURCE_APP_ID; - OIDC genérico: para provedores que sigam o padrão OpenID Connect.
No Google, o endereço de retorno é o domínio da wiki seguido de /auth/google.callback. No OIDC, a forma automática pede OIDC_ISSUER_URL, OIDC_CLIENT_ID e OIDC_CLIENT_SECRET, e o Outline busca o resto no endereço /.well-known/openid-configuration do emissor.
Existe também a entrada por e-mail com link mágico: a pessoa digita o endereço e recebe um link de uso único e com prazo de validade. Ela exige um servidor SMTP configurado e precisa ser ativada em Settings, Authentication, uma tela que só abre para quem já entrou. Por isso, recomendamos que o primeiro acesso saia por um dos provedores acima.
Como instalar o Outline com Docker Compose
O passo a passo pressupõe Docker e Docker Compose instalados. Crie uma pasta para a wiki e, dentro dela, o arquivo docker.env a partir do .env.sample do repositório. Pela documentação, o mínimo é URL, DATABASE_URL, REDIS_URL e SECRET_KEY; a saída do primeiro início aponta outras que faltarem.
As chaves SECRET_KEY e UTILS_SECRET são valores aleatórios. O arquivo de exemplo indica gerá-las com o comando abaixo, uma vez para cada:
openssl rand -hex 32
Um exemplo do trecho principal do docker.env, trocando domínio, senha do banco, chaves e dados do provedor pelos seus:
NODE_ENV=production
URL=https://wiki.suaempresa.com.br
SECRET_KEY=cole-aqui-a-primeira-chave
UTILS_SECRET=cole-aqui-a-segunda-chave
DATABASE_URL=postgres://usuario:senha-forte@postgres:5432/outline
PGSSLMODE=disable
REDIS_URL=redis://redis:6379
FILE_STORAGE=local
FILE_STORAGE_LOCAL_ROOT_DIR=/var/lib/outline/data
OIDC_ISSUER_URL=https://login.suaempresa.com.br
OIDC_CLIENT_ID=id-do-aplicativo
OIDC_CLIENT_SECRET=segredo-do-aplicativo
O PGSSLMODE=disable só vale com o banco na mesma máquina. Se o login for pelo Google ou pelo Slack, troque as linhas do OIDC pelas variáveis daquele provedor. Se usar o login da Microsoft, recomendamos incluir já neste arquivo a AZURE_TENANT_ID com o tenant da empresa: o alerta crítico de outubro de 2026 afetava versões anteriores à 1.11.0 com login Microsoft sem essa variável.
O arquivo docker-compose.yml de exemplo da documentação traz quatro serviços: o outline (porta 3000, com o volume de arquivos em /var/lib/outline/data), o postgres (imagem postgres:18), o redis e o https-portal, que cuida do HTTPS nas portas 80 e 443. Copie o exemplo da documentação e ajuste três pontos:
- troque o usuário, a senha e o nome do banco do serviço postgres pelos mesmos da
DATABASE_URL; - troque o domínio de exemplo do https-portal pelo da sua wiki;
- o serviço redis chama
redis-server /redis.conf, mas a montagem desse arquivo vem comentada: crie o arquivo e descomente a linha, ou ajuste o comando.
A documentação recomenda fixar a versão da imagem para controlar as atualizações. Em 22/11/2026, um exemplo da linha da imagem:
image: docker.getoutline.com/outlinewiki/outline:1.13.0
Recomendamos não usar as tags nightly diárias na wiki em uso. Com o DNS do domínio já apontando para a VPS, um exemplo de comando para subir tudo, na pasta do arquivo:
docker compose up -d
As migrações rodam sozinhas no início do contêiner; confira na saída se há erro de conexão com o banco ou o Redis.
HTTPS e proxy reverso
A documentação de SSL pede que o Outline seja servido por HTTPS em qualquer caso, na internet ou numa rede interna. Entre as opções estão a imagem https-portal do exemplo, que obtém o certificado do Let's Encrypt sozinha, e um proxy reverso próprio, como o Nginx, desde que repasse as conexões WebSocket.
Quem preferir o Nginx encontra na documentação um bloco de exemplo com os cabeçalhos de WebSocket (Upgrade e Connection), apontando para a porta 3000, sem a parte do certificado.
A variável FORCE_HTTPS já vem ligada e redireciona os acessos sem HTTPS. Para wiki só da equipe, recomendamos estudar também acesso por rede privada, como em Tailscale na VPS: acesso privado ao servidor e painéis.
Primeiro acesso e ajustes
Abra o endereço da wiki e entre pelo provedor configurado. Depois, em Settings, Authentication, dá para ativar o link mágico por e-mail, se houver SMTP.
Para o SMTP, a documentação lista SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD e SMTP_FROM_EMAIL, com os dados do seu provedor de e-mail.
Atualizar e fazer backup
A página de backups pede cópia diária do banco, guardada por cerca de um mês, e outra antes de cada atualização, porque as migrações nem sempre voltam atrás. Ela também manda guardar o arquivo de ambiente num cofre de senhas ou lugar criptografado: sem a SECRET_KEY, os dados criptografados do banco ficam ilegíveis.
Um exemplo de comando para copiar o banco, trocando usuário e nome do banco pelos seus:
docker compose exec -T postgres pg_dump -U usuario outline > outline-backup.sql
Para atualizar, a documentação indica: backup, nova versão no docker-compose.yml e docker compose up -d de novo. Para copiar também a pasta de anexos e o restante do servidor, uma opção está em Duplicati na VPS: backup do servidor com painel web.
Checklist do Outline na VPS
- uso interno da equipe, dentro da licença BSL 1.1;
- aplicativo do provedor de login criado com o endereço de retorno da wiki;
- versão 1.13.0 ou mais nova, fixada no compose;
- SECRET_KEY e UTILS_SECRET gerados e guardados em lugar seguro;
- HTTPS ativo no domínio dedicado;
- backup diário do banco e antes de cada atualização.
Versões e alertas de segurança
Em 24/10/2026, a página de alertas do repositório publicou um lote de avisos, entre eles um crítico, ligado ao login da Microsoft sem tenant definido, e três altos. Esses quatro foram corrigidos na 1.11.0 ou na 1.12.0, e as notas da 1.13.0 citam correções de segurança. Recomendamos acompanhar a página de alertas e atualizar a cada lançamento estável.
Um índice das páginas da wiki
Recomendamos manter uma página inicial com a lista dos assuntos e o responsável por cada um.
Wiki com o endereço da empresa começa por um domínio, que pode ser registrado na Eleven Host. Buscar domínio
Perguntas frequentes
O Outline pode ser usado na empresa?
A licença BSL 1.1 da edição comunitária permite o uso em produção pela própria equipe, incluindo prestadores. Oferecer o Outline como serviço a terceiros exige licença comercial do licenciante. Há também edições pagas Business e Enterprise.
O Outline roda em servidor Windows?
Não. A página de requisitos pede um sistema compatível com Unix.
Dá para entrar no Outline com usuário e senha?
Não há login nativo por senha. A entrada é por um provedor, como Slack, Google Workspace, Microsoft Entra ou OIDC, ou por link mágico enviado por e-mail, que depende de SMTP.