Alojar Vikunja en un VPS administrado: sus tareas y proyectos en su servidor

Alojar Vikunja en un VPS administrado significa guardar las tareas y los proyectos de su equipo en una máquina propia, que nuestros equipos mantienen actualizada y supervisan día y noche. Vikunja es software libre con licencia AGPL-3.0. Esta guía sigue su documentación oficial: la elección de la base de datos, la instalación con Docker Compose, la URL pública y el secreto, las cuentas, HTTPS, los ajustes propios de Vikunja, el correo, las copias de seguridad y las actualizaciones.

Simon Vasconcelos Lee Por Publicado el 19 de noviembre de 202613 minutos de lectura

Todas las guías

Lo esencial

  1. La licencia AGPL-3.0 permite usar Vikunja en una empresa sin ninguna licencia que comprar; si lo modifica, sus usuarios a distancia deben poder obtener el código fuente de su versión.
  2. Instálelo con Docker Compose: la imagen vikunja/vikunja:2.8.0 y PostgreSQL, con el puerto 3456 publicado en 127.0.0.1 detrás de un proxy inverso en HTTPS.
  3. Dos ajustes deben estar en su sitio desde el principio: service.publicurl, la dirección HTTPS de su instancia, y service.secret, que firma las sesiones.
  4. Vikunja no tiene ninguna cuenta por defecto: cree la suya, cierre después el registro y añada las cuentas siguientes desde la línea de comandos.
  5. Haga copia de la base de datos y de la carpeta files a la vez, antes de cada actualización; las migraciones de la base se ejecutan solas al arrancar.

Qué hace Vikunja

Vikunja es un gestor de tareas y de proyectos de código abierto y autoalojado, que su repositorio describe como «el gestor de tareas que realmente le pertenece». La API, escrita en Go, y la interfaz web van en un solo binario, o en una sola imagen Docker: solo hay una cosa que instalar.

Lo que permite la licencia AGPL-3.0

Vikunja se publica bajo la GNU AGPL versión 3 o posterior, salvo la carpeta desktop/ de su repositorio, la aplicación de escritorio, que está bajo la GPL versión 3 o posterior. Puede usarlo, también en una empresa, para su equipo y para sus clientes, sin ninguna licencia que comprar. Queda el coste del servidor que lo ejecuta.

La sección 13 añade una condición propia de la AGPL: si modifica el programa, su versión debe ofrecer de forma visible a todas las personas que interactúan con ella a distancia, a través de una red, la posibilidad de obtener su código fuente, de forma gratuita. Si distribuye copias, se aplican también las obligaciones de la licencia sobre el código fuente. Ejecutar Vikunja sin modificarlo no activa esta sección.

Esta guía instala esa edición de código abierto, que la documentación presenta como plenamente funcional por sí sola. Vikunja Pro, una licencia opcional, añade para las organizaciones un panel de administración, el registro del tiempo dedicado y registros de auditoría.

Los recursos y la base de datos

Vikunja funciona con SQLite, PostgreSQL, MySQL o MariaDB. La documentación no da ninguna cifra de memoria ni de procesador; orienta la elección de la base de datos según el número de usuarios:

Base de datosLo que dice la documentaciónVersión probada en la integración continua
SQLiteIncluida en el binario y en la imagen Docker, sin nada que instalar. Más allá de unos pocos usuarios, la documentación recomienda MySQL o PostgreSQL.La incluida
PostgreSQLLa base de los ejemplos Docker de la documentación. Desde la 2.8.0, la búsqueda ignora los acentos con la extensión unaccent.18
MySQL, MariaDBMySQL 8.0 como mínimo, ya que la 5.7 no es compatible. Para los caracteres no latinos, la base debe usar utf8mb4.MySQL 8, MariaDB 12

La documentación recomienda una versión de la base de datos que siga teniendo mantenimiento. Redis puede servir de caché, pero señala que probablemente no lo necesitará mientras la instancia tenga solo unos pocos usuarios: esta guía prescinde de él.

El espacio en disco depende sobre todo de sus archivos adjuntos y de los fondos de proyecto, guardados en la carpeta files, con 20 MB por archivo como máximo por defecto. En un VPS administrado, cuéntenos cómo es su equipo, su número de usuarios y cuánto recurre a los archivos adjuntos, y le recomendamos el tamaño adecuado.

La instalación con Docker Compose

La documentación instala Vikunja y PostgreSQL con Docker Compose. En un servidor con Docker instalado, cree una carpeta y genere primero el secreto de la instancia, un valor aleatorio que pegará en el archivo:

Terminal
openssl rand -hex 32

Coloque después en la carpeta este docker-compose.yml, tomado del ejemplo PostgreSQL de la documentación. Sustituya tasks.example.com por su nombre de dominio, paste-your-secret-here por el valor generado y changeme por una contraseña robusta, la misma en los dos sitios:

docker-compose.yml
services:
  vikunja:
    image: vikunja/vikunja:2.8.0
    environment:
      VIKUNJA_SERVICE_PUBLICURL: https://tasks.example.com/
      VIKUNJA_SERVICE_SECRET: paste-your-secret-here
      VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff
      VIKUNJA_DATABASE_TYPE: postgres
      VIKUNJA_DATABASE_HOST: db
      VIKUNJA_DATABASE_USER: vikunja
      VIKUNJA_DATABASE_PASSWORD: changeme
      VIKUNJA_DATABASE_DATABASE: vikunja
    ports:
      - "127.0.0.1:3456:3456"
    volumes:
      - ./files:/app/vikunja/files
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped
  db:
    image: postgres:18
    environment:
      POSTGRES_USER: vikunja
      POSTGRES_PASSWORD: changeme
    volumes:
      - ./db:/var/lib/postgresql
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -h localhost -U $$POSTGRES_USER"]
      interval: 30s
      start_period: 15s
      start_interval: 5s

Vikunja se ejecuta con el usuario 1000: cree la carpeta files y entréguesela antes del primer arranque, como pide la documentación, y arranque después los servicios:

Terminal, en la carpeta del docker-compose.yml
mkdir files
sudo chown 1000 files
docker compose up -d
docker compose logs vikunja

En el primer arranque, Vikunja crea su base de datos y ejecuta todas sus migraciones. La línea http server started on [::]:3456 en los registros indica que está listo, y curl http://127.0.0.1:3456/api/v1/info, ejecutado en el servidor, devuelve su versión y sus ajustes públicos.

Con SQLite

Para unos pocos usuarios, la documentación propone SQLite: elimine el servicio db, el bloque depends_on y las variables VIKUNJA_DATABASE_*, y monte una carpeta en /db, donde la imagen ya guarda vikunja.db. Créela y entréguesela al usuario 1000, como files:

docker-compose.yml, servicio vikunja
    volumes:
      - ./files:/app/vikunja/files
      - ./db:/db

Sin Docker: el paquete Debian

Desde la versión 2.4.0, Vikunja publica un repositorio de paquetes para Debian y Ubuntu, para amd64, arm64 y armhf, firmado con su clave GPG:

Terminal
curl -fsSL https://dl.vikunja.io/repos/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/vikunja.gpg
echo "deb [signed-by=/usr/share/keyrings/vikunja.gpg] https://dl.vikunja.io/repos/apt stable main" | sudo tee /etc/apt/sources.list.d/vikunja.list
sudo apt update && sudo apt install vikunja

El paquete instala Vikunja en /opt/vikunja, con SQLite por defecto, y un servicio systemd habilitado pero aún sin arrancar. Escribe también un secreto aleatorio en una sección service de /etc/vikunja/config.yml: complete esa misma sección y arranque después el servicio.

/etc/vikunja/config.yml
service:
  secret: "the value written by the package"
  publicurl: "https://tasks.example.com/"
  interface: "127.0.0.1:3456"
  ipextractionmethod: "xff"
Terminal
sudo systemctl start vikunja

La primera cuenta y el registro

Vikunja no crea ninguna cuenta por defecto. Una vez instalado HTTPS, abra https://tasks.example.com/ y regístrese: es su primera cuenta. El registro está abierto por defecto a cualquiera que llegue a la dirección; cuando existan las cuentas de su equipo, la documentación sugiere cerrarlo. Añada esta línea a las variables del servicio vikunja y vuelva a ejecutar docker compose up -d:

docker-compose.yml, en environment
      VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"

Las cuentas siguientes se gestionan desde la línea de comandos. Como la imagen no tiene shell, se llama directamente a su binario:

Terminal, en la carpeta del docker-compose.yml
docker compose exec vikunja /app/vikunja/vikunja user create -u marie -e marie@example.com
docker compose exec vikunja /app/vikunja/vikunja user list
docker compose exec vikunja /app/vikunja/vikunja user reset-password 2 --direct

La seguridad de las cuentas

HTTPS: el proxy inverso

Vikunja sirve HTTP sin cifrar. La documentación termina HTTPS en un proxy inverso, para que las contraseñas y los tokens nunca circulen sin cifrar: escucha en los puertos 80 y 443, obtiene el certificado y transmite a Vikunja en 127.0.0.1:3456.

Detrás de un proxy, Vikunja ve por defecto la dirección del proxy en cada petición: los registros y los límites de frecuencia afectan entonces a todo el mundo a la vez. El ajuste VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff, ya presente en el archivo Compose, le hace leer la cabecera X-Forwarded-For. Solo se fía de esa cabecera en las peticiones que llegan desde las direcciones de bucle local y de red privada, la red de Docker incluida: con el puerto publicado en 127.0.0.1, solo su proxy llega hasta ahí.

Con Caddy

Este es el Caddyfile de la documentación. Caddy obtiene por sí mismo un certificado de Let’s Encrypt para el nombre indicado, transmite la cabecera X-Forwarded-For y deja pasar las conexiones WebSocket:

Caddyfile
tasks.example.com {
    reverse_proxy 127.0.0.1:3456
}

Con Nginx

El bloque de la documentación se reduce a una línea proxy_pass y un tamaño de subida. Este bloque parte de él y añade dos cosas: la cabecera X-Forwarded-For, que Vikunja lee, y las cabeceras WebSocket. La interfaz de la versión 2.8.0 abre una conexión WebSocket en /api/v2/ws para sus actualizaciones en directo; si falla, sus notificaciones pasan a consultarse cada 10 segundos. Añada primero este bloque map a la sección http de /etc/nginx/nginx.conf:

nginx.conf, dentro de http
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

Después, este bloque de sitio, en el puerto 80 para que Certbot pueda instalar HTTPS:

Bloque Nginx
server {
    listen 80;
    listen [::]:80;
    server_name tasks.example.com;

    location / {
        proxy_pass http://127.0.0.1:3456;
        client_max_body_size 20M;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
    }
}
Terminal
sudo nginx -t
sudo certbot --nginx

client_max_body_size 20M corresponde al tamaño máximo de archivo en Vikunja, 20 MB por defecto. Si lo aumenta con VIKUNJA_FILES_MAXSIZE, la documentación pide aumentar también esta línea.

Los ajustes propios de Vikunja

Casi todas las claves del archivo config.yml tienen su variable de entorno: service.enablecaldav se convierte en VIKUNJA_SERVICE_ENABLECALDAV. Cuando una opción se define en los dos sitios, prevalece la variable. La lista de refuerzo de la seguridad de la documentación repasa las funciones que conviene desactivar si no las usa:

ClavePor defectoDesactivarla para
service.enablelinksharingtrueImpedir que se compartan proyectos mediante enlaces públicos
service.enablecaldavtrueRetirar el punto de acceso CalDAV, que acepta la autenticación HTTP básica
webhooks.enabledtrueEvitar que Vikunja envíe peticiones a direcciones que eligen los usuarios
service.enabletaskattachmentstrueImpedir la subida de archivos a las tareas
service.enableuserdeletiontrueImpedir que los usuarios eliminen su propia cuenta
plugins.enabledfalseYa desactivada: mantener el código de terceros fuera de Vikunja

La búsqueda sin acentos en PostgreSQL

Desde la 2.8.0, la búsqueda ignora los acentos en PostgreSQL cuando la extensión unaccent está activa: «cafe» encuentra también «café». La imagen oficial de PostgreSQL la incluye; actívela en la base de Vikunja y reinicie después Vikunja. El registro muestra entonces unaccent extension detected, search is accent-insensitive.

Terminal, en la carpeta del docker-compose.yml
docker compose exec db psql -U vikunja -d vikunja -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
docker compose restart vikunja

Importar sus tareas

Cada usuario importa sus tareas desde la pestaña «Import» de sus ajustes, donde también puede exportar todos sus datos en un archivo zip. Las importaciones de archivos, archivo de Vikunja, CSV, TickTick y WeKan, así como la importación desde una instancia de Planka, están siempre disponibles. Todoist, Trello y Microsoft To Do pasan por OAuth: están desactivados por defecto y se activan en la sección migration de la configuración, con los datos de acceso de la aplicación creada en cada servicio. La redirección OAuth se hace en el navegador: la instancia no necesita ser accesible para esos servicios, pero service.publicurl debe ser correcta.

CalDAV

CalDAV sincroniza las tareas con sus aplicaciones, con los datos de conexión de la pestaña CalDAV de los ajustes. La documentación presenta esta integración como una versión alfa que funciona bien con algunos clientes: pruebe el suyo antes de convertirlo en la herramienta de todo el equipo. En iPhone y iPad, cada proyecto se convierte en una lista de la aplicación Recordatorios. Una cuenta con autenticación en dos pasos se conecta con un token CalDAV dedicado.

El correo: recordatorios, confirmaciones y contraseñas

Vikunja envía correos para los recordatorios de tareas, la confirmación de una cuenta nueva y el restablecimiento de contraseñas. El envío está desactivado por defecto: las cuentas quedan entonces activas en cuanto se crean, y el restablecimiento de la contraseña por correo no es posible. Una vez activado el envío, cada nueva cuenta local confirma su dirección antes de usarse.

Desde un VPS de Simafri, configure un servidor SMTP autenticado, en el puerto 587 o 465: el de su servicio de envío o el de su proveedor de correo. Añada estas variables al servicio vikunja:

docker-compose.yml, en environment
      VIKUNJA_MAILER_ENABLED: "true"
      VIKUNJA_MAILER_HOST: smtp.example.com
      VIKUNJA_MAILER_PORT: 587
      VIKUNJA_MAILER_USERNAME: tasks@example.com
      VIKUNJA_MAILER_PASSWORD: your-smtp-password
      VIKUNJA_MAILER_FROMEMAIL: tasks@example.com

Vuelva a ejecutar docker compose up -d y envíe después un mensaje de prueba. El comando comprueba la conexión con un comando SMTP NOOP, que algunos relés mínimos no admiten: prefiera un servidor SMTP completo.

Terminal
docker compose exec vikunja /app/vikunja/vikunja testmail you@example.com

Las copias de seguridad

La documentación cuenta dos partes que copiar, a la vez: la base de datos y la carpeta de archivos adjuntos. Desde la 2.8.0, las tareas y los proyectos eliminados pasan primero 30 días en la papelera; pasado ese plazo o vaciada la papelera, solo una copia de seguridad los recupera.

ElementoLo que guardaCómo copiarlo
La base de datos PostgreSQLLas cuentas, los proyectos, las tareas, los comentarios y los ajustespg_dump, sin detener Vikunja
filesLos archivos adjuntos, los avatares y los fondos de proyectoUna copia de la carpeta
Con SQLite, db/vikunja.dbToda la base de datosUna copia del archivo, con Vikunja detenido
docker-compose.ymlEl secreto, la URL pública y las contraseñasGuardado aparte, como un secreto
Terminal, en la carpeta del docker-compose.yml
docker compose exec -T db pg_dump -U vikunja vikunja > vikunja-$(date +%F).sql
tar -czf vikunja-files-$(date +%F).tar.gz files

La documentación pide copias cifradas y guardadas fuera del servidor, y restauraciones probadas con regularidad: en una instancia aparte, inicie sesión y abra una tarea con un archivo adjunto. Colocados en el disco del servidor, estos archivos entran también en sus copias de seguridad nocturnas.

El comando vikunja dump reúne la configuración, la base de datos y todos los archivos en un archivo zip, y vikunja restore lo vuelve a cargar. El archivo contiene el archivo de configuración y todas las variables VIKUNJA_* en claro: cífrelo y protéjalo como la propia base de datos.

Restaurar

En una instalación nueva, con el mismo docker-compose.yml, cargue la exportación en la base aún vacía antes del primer arranque de Vikunja y vuelva a colocar después la carpeta files:

Terminal
docker compose up -d db
docker compose exec -T db psql -U vikunja vikunja < vikunja-2026-11-19.sql
tar -xzf vikunja-files-2026-11-19.tar.gz
docker compose up -d

Las actualizaciones

Vikunja ejecuta por sí solo las migraciones de su base de datos cuando arranca una nueva versión. Por eso la documentación pide una copia de seguridad antes de cada actualización, para poder volver al estado anterior, y una lectura de las notas de la versión, que señalan los posibles pasos manuales.

  1. Lea las notas de la nueva versión.
  2. Exporte la base de datos y copie la carpeta files.
  3. Cambie la etiqueta de la imagen en docker-compose.yml, por ejemplo de 2.8.0 a la versión siguiente.
  4. Descargue la nueva imagen y reinicie el servicio.
Terminal
docker compose pull
docker compose up -d

Con el paquete Debian, sudo apt update && sudo apt upgrade sustituye el binario y reinicia el servicio. Pasar de una versión estable a las compilaciones unstable funciona, pero la documentación desaconseja volver atrás: espere mejor a la siguiente versión estable.

Las correcciones de seguridad se publican como avisos de seguridad de GitHub y se anuncian en las notas de la versión. La versión 2.8.0 del 5 de noviembre de 2026 corrige diecinueve, y su anuncio pide actualizar en cuanto pueda. Para recibir los avisos, siga las versiones del repositorio de GitHub o el canal RSS del registro de cambios.

Quién hace qué en un VPS administrado

El autoalojamiento exige mantener el servidor además de la aplicación. En un VPS administrado, nuestros equipos se encargan del servidor y siguen su instancia de forma proactiva; Vikunja sigue siendo su software, con sus ajustes, sus proyectos y sus tareas.

TemaNuestros equiposUsted
El servidorActualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidasEl momento que mejor convenga a su actividad
La supervisiónServidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamadaLa lectura de los registros de su instancia
VikunjaSeguimiento proactivo: errores, lentitud y espacio en disco detectados, corrección recomendadaSu instalación, sus actualizaciones y sus ajustes, que aplica usted o su asistente de IA
Las cuentas y los proyectosEl servidor que los soporta, vigilado y con copias de seguridadLas cuentas de su equipo, el registro, los proyectos compartidos y los permisos
El correoUn servidor que llega a su servidor SMTP en el puerto 587 o 465Su servicio de envío y sus datos de acceso
Las copias de seguridadCada noche, cifradas y guardadas fuera de la máquina; restauración incluidaSus exportaciones de la base de datos y de la carpeta files, y la petición de restauración, cuando la necesite
La migraciónSu servidor actual migrado, gratisEl momento del cambio

Si prefiere que nuestros equipos intervengan en la propia aplicación, ese servicio se factura por horas o a precio cerrado, con un presupuesto comunicado antes de la intervención.

Vikunja, en un servidor que cuidamos por usted

Con un VPS administrado de Simafri, nuestros equipos mantienen actualizado el servidor de su instancia de Vikunja, lo vigilan día y noche e intervienen sin esperar su llamada; también siguen su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted o su asistente de IA. Las copias de seguridad se cifran cada noche y se guardan fuera de la máquina, su restauración está incluida, y la migración de su servidor actual es gratuita.

Descubrir los VPS administrados

Preguntas frecuentes

¿Vikunja es gratuito para una empresa?

Sí. Vikunja tiene licencia AGPL-3.0: puede usarlo en su empresa sin ninguna licencia que comprar. Si lo modifica, sus usuarios a distancia deben poder obtener el código fuente de su versión. Queda el coste del servidor que lo ejecuta.

¿Qué base de datos elegir para Vikunja?

SQLite, incluida en la imagen, basta para unos pocos usuarios. Más allá, la documentación recomienda PostgreSQL o MySQL. PostgreSQL es la base de sus ejemplos Docker, y desde la 2.8.0 su búsqueda ignora los acentos con la extensión unaccent.

¿Cómo instalar Vikunja con Docker Compose?

Cree un docker-compose.yml con las imágenes vikunja/vikunja:2.8.0 y postgres:18, el puerto 3456 publicado en 127.0.0.1, una carpeta files entregada al usuario 1000, la URL pública y el secreto, y ejecute docker compose up -d. Coloque después delante del puerto 3456 un proxy inverso en HTTPS.

¿Para qué sirven service.publicurl y service.secret?

service.publicurl es la dirección HTTPS de su instancia: Vikunja construye a partir de ella sus enlaces y su origen CORS, de ahí un error unauthorized cuando es errónea. service.secret firma las sesiones; si se deja vacío, cambia en cada arranque y cierra la sesión de todos los usuarios.

¿Cómo crear la primera cuenta de Vikunja?

Vikunja no tiene ninguna cuenta por defecto: regístrese en su instancia. Cierre después el registro poniendo VIKUNJA_SERVICE_ENABLEREGISTRATION en false, y cree las cuentas siguientes con el comando vikunja user create, ejecutado dentro del contenedor.

¿Cómo configurar el correo en Vikunja?

Active el envío con VIKUNJA_MAILER_ENABLED e indique después el host, el puerto 587 o 465, el usuario, la contraseña y la dirección del remitente de su servidor SMTP. Sin correo, las cuentas quedan activas en cuanto se crean y las contraseñas se restablecen desde la línea de comandos.

¿Cómo hacer copia de seguridad de Vikunja?

Copie a la vez la base de datos, con pg_dump para PostgreSQL, y la carpeta files de los archivos adjuntos. Guarde las copias cifradas y fuera del servidor, haga una antes de cada actualización y pruebe su restauración con regularidad.

¿Un VPS administrado cubre Vikunja?

Un VPS administrado cubre el servidor: sistema, seguridad, supervisión y copias de seguridad. Nuestros equipos siguen también su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted. Una intervención en la aplicación se factura por horas o a precio cerrado.

Fuentes y documentación oficial

Contáctenos