Base de Conhecimento

Vikunja na VPS: tarefas da equipe no seu servidor

  • vikunja, gerenciador de tarefas, docker, vps, lgpd
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Vikunja na VPS: tarefas da equipe no seu servidor

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.

Esta resposta lhe foi útil?

Artigos Relacionados