Kanboard na VPS: quadro kanban da equipe
Kanboard v1.2.57 em modo de manutenção: Docker com versão fixada, volumes, PostgreSQL, troca do login padrão, certificado autoassinado, backup e atualização.
Por Redação Eleven Host · @robson.direitodigital · 15 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia do Kanboard: Kanboard na VPS: quadro kanban da equipe Arte: Eleven Host
Kanboard na VPS é uma forma de manter um quadro kanban da equipe no seu próprio servidor: colunas, cartões e tarefas num painel simples, com licença MIT e instalação por Docker.
Atualizado em 15/11/2026. Para entender o que é uma VPS antes de instalar, veja O que é servidor VPS: guia simples para iniciantes. Aqui a ordem importa: primeiro os volumes e o banco, depois a versão fixada, a troca da senha padrão e só então o endereço.
O que é o Kanboard
O Kanboard é um software de gestão de projetos no estilo kanban: o trabalho vira cartões que andam por colunas, em etapas. O repositório oficial o descreve como software de gestão de projetos kanban, e a licença é MIT.
O login inicial do Kanboard é admin/admin, e a documentação oficial manda trocar usuário e senha no primeiro acesso. Até a troca, o login padrão continua valendo.
O projeto se declara em modo de manutenção. O README define o termo como o ponto em que o programa já atingiu seus objetivos, e o autor diz que não desenvolve funções grandes novas, apenas pequenas correções. Novas versões continuam saindo, conforme as contribuições da comunidade. Na prática, o repositório não está arquivado. Em 15/11/2026, a versão mais nova é a v1.2.57, publicada em 31/10/2026, depois das v1.2.56 e v1.2.55, ambas de 21/10/2026.
Servidores virtuais com mensalidade em reais aparecem na loja da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Para tarefas da equipe em outro formato, o artigo Vikunja na VPS: tarefas da equipe no seu servidor mostra outro caminho. Para gestão de projetos, há também OpenProject na VPS: gestão de projetos da equipe.
A segurança merece atenção por um motivo concreto. O Kanboard teve várias correções de segurança em 2025 e 2026, inclusive de gravidade alta e crítica, e cada uma saiu com versão corrigida. O exemplo de docker run da documentação oficial usa a tag v1.2.45, que é anterior a boa parte dessas correções. Os comandos abaixo usam a v1.2.57, e o ponto central é manter uma versão atual fixada.
Docker e Compose antes de começar
A instalação oficial é por Docker, e a instalação usa o Docker e, nos arquivos de exemplo, o Compose, que devem estar instalados antes; a instalação deles segue a documentação do próprio Docker. A imagem do Kanboard já traz o PHP e o servidor web (nginx), então não há PHP para instalar na VPS.
A imagem está em três registros: docker.io/kanboard/kanboard, ghcr.io/kanboard/kanboard e quay.io/kanboard/kanboard. As tags principais são latest (a última versão estável), nightly (build noturno, com as mudanças mais recentes de desenvolvimento) e v1.2.x (uma versão específica). A documentação pede fixar uma versão específica para evitar atualizações inesperadas, e é isso que os comandos abaixo fazem. Confira no Docker Hub se a tag v1.2.57 existe e ainda é a mais nova.
Volumes de dados e plugins
A imagem do Kanboard usa três pastas para dados, plugins e certificados. A pasta /var/www/app/data reúne os dados da aplicação, como o banco SQLite e os anexos. A pasta /var/www/app/plugins guarda os plugins. A pasta /etc/nginx/ssl recebe os certificados.
Sem volume nomeado, o quadro pode sumir com o container
Sem volume nomeado, os dados ficam presos ao container e podem se perder quando ele é recriado, como numa atualização. Recomendamos montar ao menos o volume de data antes de criar o primeiro cartão.
Os plugins têm duas regras próprias. Desde a versão 1.2.8, a instalação de plugins pela tela vem desligada por segurança. Para ligar, a configuração PLUGIN_INSTALLER precisa valer true; no Docker, isso vira -e PLUGIN_INSTALLER=true. Só administradores instalam, e a extensão Zip precisa estar presente. A documentação avisa que não existe revisão de código nem processo de aprovação para plugins enviados, e que cabe ao dono da instância validar se um plugin é legítimo. Recomendamos instalar só plugins conhecidos e manter o instalador desligado enquanto ele não for necessário.
Banco de dados: PostgreSQL para equipe
O Kanboard aceita SQLite (3.7 ou mais novo), MySQL (5.6 ou mais novo), MariaDB (10 ou mais novo) e PostgreSQL (9.4 ou mais novo). A documentação de requisitos recomenda o PostgreSQL, indica o SQLite para uso individual ou equipe pequena e desaconselha o SQLite com NFS ou com Docker.
Há uma tensão aqui: o repositório traz um arquivo de Compose para SQLite, mesmo com esse desaconselhamento. Para uma equipe, recomendamos o caminho do PostgreSQL. Para teste ou uso pessoal, o SQLite serve, com a ressalva de que o volume de data passa a ser a única cópia do banco.
A documentação de Docker traz exemplos de Compose para SQLite, MariaDB e PostgreSQL e diz que eles devem ser personalizados. Os exemplos de banco usam senhas de exemplo: MYSQL_ROOT_PASSWORD com o valor secret no exemplo de MySQL ou MariaDB e kanboard-secret dentro de DATABASE_URL no de PostgreSQL. Troque essas senhas antes de subir. O arquivo de SQLite do repositório lê a imagem da variável KANBOARD_IMAGE e, sem ela, usa latest; nos arquivos de exemplo, troque latest pela versão fixa.
Escolhido o arquivo, o Compose sobe com docker compose up; acrescentar -d deixa o serviço rodando em segundo plano. As opções de configuração do Kanboard aceitam variáveis de ambiente, segundo a documentação.
Subir o Kanboard com a versão fixada
Para testar ou para uso pessoal com SQLite, um exemplo de comando, que você deve conferir no próprio servidor antes de rodar:
docker run -d --name kanboard -p 80:80 -v kanboard_data:/var/www/app/data -v kanboard_plugins:/var/www/app/plugins -t kanboard/kanboard:v1.2.57
O comando parte do exemplo oficial, com a tag atual no lugar da antiga e dois volumes nomeados no lugar dos dados soltos dentro do container. A opção -p 80:80 publica a porta 80. A porta 443 só passa a atender se você também publicá-la.
Como o login admin/admin existe desde o primeiro início, uma sugestão adicional, não testada, é publicar a porta só dentro do servidor (-p 127.0.0.1:80:80), abrir o quadro por túnel SSH, trocar a senha e só depois liberar o endereço. Um exemplo de túnel, também não testado e a conferir, rodado no seu computador, com o IP de exemplo e o usuário trocados pelos seus:
ssh -L 8080:localhost:80 usuario@203.0.113.10
Com o túnel aberto, o endereço http://localhost:8080 no navegador do seu computador deve mostrar o Kanboard.
Primeiro login e troca de senha
Na primeira tela, entre com admin e admin. A documentação manda trocar o usuário e a senha padrão, e a troca deve vir antes de criar projetos ou convidar a equipe. Só depois divulgue o endereço.
O envio de e-mail pelo Kanboard também tem uma regra no Docker. Segundo a documentação, é preciso usar o método SMTP ou um plugin como Mailgun, Sendgrid ou Postmark; os transportes mail e sendmail não funcionam com a imagem oficial.
HTTPS e domínio
A imagem traz um nginx configurado para escutar na porta 443. Se nenhum certificado for fornecido, o script de entrada da imagem gera um certificado autoassinado na hora. Por isso, o navegador mostra um aviso de que o certificado não é confiável, e esse aviso decorre do certificado autoassinado.
Para usar um domínio com certificado válido, há duas saídas, ambas sugestões sem teste. A primeira é colocar um certificado próprio, com os nomes kanboard.crt e kanboard.key, no volume de certificados (/etc/nginx/ssl). A segunda é pôr um proxy reverso, como Caddy ou Nginx, na frente do Kanboard, publicando só a porta 80 do container em 127.0.0.1. A configuração do proxy segue a documentação da ferramenta escolhida.
Em 2026, o projeto corrigiu a falsificação de endereço IP em cabeçalhos de proxy confiável, que contornava o CAPTCHA e o bloqueio de login por IP (versão v1.2.55). A documentação também pede impedir o acesso público à pasta data pela URL e lembra que configurar o servidor corretamente é responsabilidade de quem o administra.
Backup do quadro
No SQLite, o banco é um arquivo único chamado db.sqlite, dentro da pasta data. A documentação mostra dois comandos de backup, que usam o programa sqlite3 e precisam rodar na pasta onde esse arquivo está (com volume do Docker, é preciso antes descobrir onde o volume fica no servidor, ponto a conferir):
sqlite3 db.sqlite .dump > kanboard.dump.sql
sqlite3 db.sqlite ".backup kanboard.backup.sqlite"
A cópia simples do arquivo só é segura com ninguém usando o quadro, e o download de backup pela tela vem compactado em gzip. No Docker, o volume de data reúne o banco SQLite e os anexos, e o de plugins guarda os plugins. Com PostgreSQL, o backup do banco segue o procedimento do próprio PostgreSQL, e o volume de data continua valendo para os anexos.
Recomendamos guardar uma cópia fora da VPS e tratá-la com cuidado, porque ela contém as tarefas e os anexos da equipe. Teste a restauração em outro lugar: a documentação de atualização manda verificar se o backup funciona.
Atualização
A documentação pede um backup antes de atualizar e pede ler o ChangeLog em vez de atualizar às cegas. A página geral de atualização cita ainda parar o worker, pôr o sistema em manutenção e limpar as sessões.
Para atualizar com Compose, uma sugestão não testada: trocar a tag no arquivo, ler o ChangeLog, fazer o backup e rodar os dois comandos abaixo. Quem usou docker run remove o container antigo e cria outro com a tag nova e os mesmos volumes.
docker compose pull
docker compose up -d
Um nome para o endereço do quadro
Para acessar o quadro por um nome de domínio, e não só pelo IP, o nome precisa apontar para a VPS.
A escolha da extensão do domínio fica entre centenas de opções na Eleven Host. Buscar domínio
Perguntas frequentes
Qual é a licença do Kanboard?
A licença é MIT, segundo o repositório oficial. Em 15/11/2026, a versão mais nova é a v1.2.57.
O Kanboard ainda recebe atualizações?
O projeto se declara em modo de manutenção: sem funções grandes novas, só correções pequenas. O repositório não está arquivado, e versões continuam sendo publicadas.
Qual é o login inicial?
É admin/admin. A documentação manda trocar o usuário e a senha no primeiro acesso.
Por que o navegador avisa que a conexão não é confiável?
Porque a imagem gera um certificado autoassinado quando não recebe outro. Use um certificado próprio no volume de certificados ou um proxy reverso na frente.
Posso usar SQLite?
Para uso pessoal ou equipe pequena, sim, mas a documentação desaconselha SQLite com Docker e recomenda PostgreSQL. Para uma equipe, o PostgreSQL é o caminho indicado.