Vikunja na VPS: tarefas da equipe no seu servidor
Vikunja 2.8.0: licença AGPL-3.0, correções de segurança, instalação com Docker Compose e PostgreSQL, contas, HTTPS com Nginx, e-mail, backup e atualização.
Por Redação Eleven Host · @robson.direitodigital · 13 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Vikunja na VPS: tarefas da equipe no seu servidor Arte: Eleven Host
Vikunja na VPS é uma forma de manter as tarefas da equipe num servidor seu, com listas, Kanban, Gantt e tabela. Veja a licença, a instalação com Docker Compose e PostgreSQL, o HTTPS, o e-mail, o backup e a atualização.
Atualizado em 13/11/2026. Os blocos de exemplo não foram executados: confira cada um no seu servidor antes de usar.
O que é o Vikunja e qual é a licença
O Vikunja é um gerenciador de tarefas que você hospeda por conta própria. As tarefas aparecem em quatro visualizações: lista, Gantt, Kanban e tabela. Também há etiquetas, lembretes de prazo e tarefas repetidas. Os projetos podem ser compartilhados com usuários ou com equipes inteiras, e os links de compartilhamento deixam ver ou editar sem conta.
O Vikunja é código aberto sob a licença AGPL-3.0-or-later. Na data de hoje, a versão estável é a 2.8.0, de 05/11/2026, que corrige duas falhas de gravidade alta: recomendamos usar essa versão ou uma mais nova e fixar a tag no compose.
Existe também uma versão hospedada pelo projeto, o Vikunja Cloud, com planos pagos e teste grátis de 14 dias, e o Vikunja Pro, pago, para instância própria, que está em beta privado.
A integração com CalDAV existe, mas a documentação a descreve como em fase alfa, com bugs.
Para quem serve
São exemplos de uso, sem promessa de resultado: uma equipe pequena que quer dividir tarefas em quadros e listas, ou uma empresa que prefere guardar o planejamento num servidor sob o seu controle. O foco do Vikunja são as tarefas e as quatro visualizações descritas acima; quem precisa de recursos de uma suíte de gestão de projetos, como orçamento, deve conferir a lista de recursos do projeto antes. O guia completo de servidor VPS explica o que é uma VPS.
Versão e segurança
Em 05/11/2026, o projeto publicou avisos de segurança. Entre eles, dois são de gravidade alta e foram corrigidos na 2.8.0. Um deixava um usuário autenticado comum ler arquivos armazenados pela API, e o outro permitia tomada de conta via OIDC com emailfallback. As versões afetadas vão até a 2.7.1.
A página da versão 2.8.0 fala em 19 problemas de segurança corrigidos e pede a atualização. Por isso o compose abaixo fixa a tag 2.8.0, e em produção convém evitar a tag unstable.
Antes de começar
O exemplo usa Docker, Docker Compose e o PostgreSQL, uma das opções de banco que a documentação mostra. A documentação aceita também MySQL, MariaDB e SQLite, este indicado só para instalações pequenas. Para o Docker, siga a documentação do próprio Docker para a sua distribuição Linux, com o plugin do Compose.
Para comparar a mensalidade, a loja lista os planos. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Instalação com Docker Compose, na ordem
Primeiro, a pasta do projeto e as pastas de dados. O contêiner do Vikunja roda com o usuário de número 1000, sem grupo. Se a pasta files não existir ou tiver outro dono antes do primeiro início, o Vikunja não consegue gravar e responde com permissão negada. Por isso crie e ajuste o dono antes do up:
mkdir -p ~/vikunja/files ~/vikunja/db
cd ~/vikunja
sudo chown 1000 files
A pasta db guarda o PostgreSQL. O chown 1000 da documentação vale para files e, no caso do SQLite, também para db. Se o seu usuário não estiver no grupo docker, use sudo antes dos comandos docker.
Segundo, os segredos, antes do primeiro início. Sem VIKUNJA_SERVICE_SECRET fixo, o valor é aleatório e regenerado a cada inicialização, e as sessões provavelmente caem a cada reinício. Um exemplo de comando, que mostra um valor na tela; rode duas vezes, uma para a senha do banco e outra para o segredo do Vikunja:
openssl rand -hex 32
Terceiro, o arquivo docker-compose.yml da pasta, montado a partir do exemplo oficial com PostgreSQL. Troque os valores de exemplo: a senha do banco aparece nos dois serviços e precisa ser a mesma, no lugar do changeme do exemplo; o segredo vai em VIKUNJA_SERVICE_SECRET, a variável atual, e não na VIKUNJA_SERVICE_JWTSECRET, que está obsoleta; o endereço público é o que as pessoas vão digitar, em HTTPS. O fuso padrão é GMT, e o exemplo já traz o de São Paulo para os lembretes saírem no horário certo.
No YAML, o recuo de cada linha faz parte do arquivo: ao copiar, mantenha 2 espaços por nível, como no exemplo oficial do Vikunja.
services:
vikunja:
image: vikunja/vikunja:2.8.0
ports:
- 127.0.0.1:3456:3456
environment:
VIKUNJA_SERVICE_PUBLICURL: https://tarefas.exemplo.com
VIKUNJA_SERVICE_TIMEZONE: America/Sao_Paulo
VIKUNJA_SERVICE_SECRET: SEGREDO_DO_VIKUNJA
VIKUNJA_DATABASE_HOST: db
VIKUNJA_DATABASE_TYPE: postgres
VIKUNJA_DATABASE_USER: vikunja
VIKUNJA_DATABASE_PASSWORD: SENHA_DO_BANCO
VIKUNJA_DATABASE_DATABASE: vikunja
volumes:
- ./files:/app/vikunja/files
depends_on:
db:
condition: service_healthy
db:
image: postgres:18
environment:
POSTGRES_USER: vikunja
POSTGRES_DB: vikunja
POSTGRES_PASSWORD: SENHA_DO_BANCO
volumes:
- ./db:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U vikunja -d vikunja"]
A linha 127.0.0.1:3456:3456 publica a porta só dentro do servidor: o acesso de fora passa pelo proxy com HTTPS, mais abaixo.
Quarto, o primeiro início e a conferência:
docker compose up -d
docker compose ps
docker compose logs -n 50 vikunja
Contas e registro aberto
Não existe usuário nem senha padrão no Vikunja. A documentação descreve criar a primeira conta pelo registro, que vem ligado (VIKUNJA_SERVICE_ENABLEREGISTRATION é true por padrão), e também há o caminho pela linha de comando, logo abaixo. Num servidor com IP público, deixe o registro ligado só pelo tempo de cadastrar a equipe.
Criar as contas e fechar o registro
Como a porta ainda está só local, uma saída é criar as contas pela linha de comando do Vikunja, dentro do contêiner. Primeiro, descubra o nome do contêiner do Vikunja (o outro é o do banco):
docker ps --format '{{.Names}}'
Depois, um exemplo de criação de usuário; sem a opção -p, o comando pede a senha, por isso o -it:
docker exec -it NOME_DO_CONTEINER /app/vikunja/vikunja user create -u ana -e ana@exemplo.com
Com a equipe cadastrada, a documentação manda desativar o registro. Acrescente esta linha em environment do serviço vikunja e recrie o contêiner:
VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"
docker compose up -d
Para novas pessoas depois disso, repita o user create pela linha de comando.
Domínio e HTTPS com Nginx
O endereço, como tarefas.exemplo.com, precisa apontar para o IP da VPS antes do certificado. A Eleven Host oferece DNS gerenciado grátis na rede da Cloudflare para domínios registrados conosco, com painel na área do cliente. O caminho abaixo usa o Nginx no próprio servidor com o Let's Encrypt, como mostra o artigo Certbot na VPS: SSL grátis do Let's Encrypt no Nginx.
O client_max_body_size acompanha o limite de upload do Vikunja, que é de 20 MB por padrão: se mudar um dos dois, mude o outro, ou os anexos deixam de subir. Um exemplo de bloco do Nginx:
server {
server_name tarefas.exemplo.com;
client_max_body_size 20M;
location / {
proxy_pass http://127.0.0.1:3456;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Depois de ativar o bloco e emitir o certificado pelo Certbot, abra o endereço HTTPS no navegador e entre com uma das contas criadas. O VIKUNJA_SERVICE_PUBLICURL deve ser exatamente a URL que a pessoa digita.
Atrás do proxy, o Vikunja enxerga o endereço do proxy, e não o de cada pessoa, o que afeta os logs, o limite de taxa e o Fail2Ban. A documentação manda ligar a extração do IP por xff e listar em trustedproxies só o endereço do proxy: uma faixa larga como 10.0.0.0/8 permite forjar o cabeçalho X-Forwarded-For. Confira no seu servidor de qual endereço a conexão do Nginx chega ao contêiner, e coloque esse valor no lugar do exemplo. As duas linhas vão no environment do serviço vikunja, e depois vale rodar docker compose up -d:
VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff
VIKUNJA_SERVICE_TRUSTEDPROXIES: ENDERECO_DO_PROXY
E-mail para os lembretes
O envio de e-mail vem desligado (VIKUNJA_MAILER_ENABLED é false), e sem SMTP não há lembrete por e-mail. Os lembretes de prazo por e-mail estão ativos no servidor, mas a opção do usuário vem desligada para contas novas. Um exemplo de variáveis para o environment, com servidor fictício; depois, docker compose up -d:
VIKUNJA_MAILER_ENABLED: "true"
VIKUNJA_MAILER_HOST: smtp.exemplo.com
VIKUNJA_MAILER_PORT: "587"
VIKUNJA_MAILER_USERNAME: tarefas@exemplo.com
VIKUNJA_MAILER_PASSWORD: SENHA_DO_SMTP
VIKUNJA_MAILER_FROMEMAIL: tarefas@exemplo.com
Backup e atualização
O que vale copiar são duas partes: o banco de dados e a pasta files, onde ficam os anexos. A lixeira da versão 2.8.0 guarda tarefas e projetos apagados por 30 dias; depois disso, só um backup traz de volta. Um exemplo de cópia do PostgreSQL pelo contêiner do banco, e da pasta de anexos:
docker compose exec -T db pg_dump -U vikunja vikunja > vikunja-backup.sql
sudo tar czf vikunja-files.tar.gz files
O sudo no tar vale se o seu usuário não for o dono da pasta files, que o chown 1000 deixou com o usuário de número 1000; o arquivo gerado fica com o dono root.
Recomendamos guardar as cópias fora da VPS, e o artigo Backup da VPS: como fazer cópia automática trata de cópias da VPS.
Para atualizar, faça o backup antes e leia o changelog da versão nova, para não perder um passo manual. Depois troque a tag no compose, por exemplo de 2.8.0 para a versão seguinte, e suba de novo. As migrações do banco rodam sozinhas ao iniciar, e sem backup não há volta fácil:
docker compose pull
docker compose up -d
Dados da equipe e LGPD
Um gerenciador de tarefas guarda nomes e e-mails das pessoas da equipe, além das tarefas e dos anexos. A LGPD, a lei brasileira de proteção de dados, trata esse tipo de informação, e um software não garante conformidade sozinho. Recomendamos limitar quem tem conta, manter o HTTPS ligado, guardar a cópia fora do servidor e tratar o assunto com o jurídico da empresa.
Servidor e endereço da equipe
Antes de escolher um servidor, o artigo Como saber se preciso de VPS: sinais e como decidir ajuda a avaliar a necessidade.
Um endereço como tarefas.exemplo.com sai de um domínio registrado, e a Eleven Host registra domínios com centenas de extensões. Buscar domínio
Perguntas frequentes
O Vikunja é gratuito?
O código é aberto, sob a licença AGPL-3.0-or-later, e dá para hospedar por conta própria. O projeto também oferece o Vikunja Cloud e o Vikunja Pro, que são pagos, com preços definidos pelo fabricante.
Qual versão usar na data de hoje?
A 2.8.0, de 05/11/2026, ou uma mais nova. Ela corrige duas falhas de gravidade alta, e recomendamos fixar a tag no compose.
Como evito que estranhos criem conta?
Crie as contas da equipe e desligue o registro com VIKUNJA_SERVICE_ENABLEREGISTRATION em false, ou use o user create pela linha de comando.