Buscar

Ferramentas

Wiki.js

Wiki open source em Node.js para documentação interna e bases de conhecimento, com editor Markdown, controle de acesso e sincronização com Git.

  • Produtividade
  • Sites e CMS
  • Open Source
  • Self-hosted
Wiki.js

O Wiki.js é um wiki em Node.js que você instala no próprio servidor para guardar documentação interna em páginas com histórico, busca e permissões. Assim o conhecimento sai de pastas soltas e conversas de chat. Hoje o projeto tem duas linhas: a 2.5, estável, e a 3.0, ainda em teste.

Para que serve

  • Escrever manuais e procedimentos em Markdown com pré-visualização ao vivo, num editor visual ou em HTML puro.
  • Controlar quem lê e quem edita por grupos e regras baseadas no caminho da página.
  • Entrar com contas locais, login social ou provedores corporativos como LDAP, SAML e OpenID Connect.
  • Sincronizar o conteúdo com um repositório Git no GitHub, GitLab, Bitbucket ou Azure DevOps.
  • Recuperar versões antigas de uma página e comparar mudanças.

Como começar

Para uso em produção, a versão indicada é a 2.5: a página de releases marca a v2.5.314 como a mais recente estável. As versões 3.0 aparecem como pré-lançamento, e as notas delas dizem que não servem para produção. O site cadastrado nesta ficha, beta.js.wiki, apresenta justamente a 3.0 em beta.

A documentação da 2.x lista Docker, Kubernetes, Linux, macOS e Windows Server como plataformas. Os requisitos são Node.js 22 ou mais recente, pelo menos 1 GB de RAM no Linux e um banco de dados. PostgreSQL é o recomendado. MySQL, MariaDB, SQL Server e SQLite também funcionam na 2.x, mas a própria documentação avisa que a próxima versão principal só vai aceitar PostgreSQL.

Licença e custo

A licença é AGPL-3.0. Você pode usar e modificar de graça, inclusive dentro da empresa. Se oferecer uma versão modificada para outras pessoas usarem pela rede, precisa disponibilizar o código dessas mudanças. O site não vende plano pago e aceita doações e patrocínios.

Quando vale a pena

Para documentação interna sob controle próprio, com login corporativo e cópia em Git, o Wiki.js é um candidato forte. O post sobre alternativas open source a SaaS pago discute esse tipo de troca. Para quem não quer manter servidor, um wiki em nuvem como o Confluence dá menos trabalho. BookStack é outra opção self-hosted conhecida.