Héberger Vikunja sur un VPS infogéré : vos tâches et projets sur votre serveur

Héberger Vikunja sur un VPS infogéré, c'est garder les tâches et les projets de votre équipe sur une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Vikunja est un logiciel libre sous licence AGPL-3.0. Ce guide suit sa documentation officielle : la base de données à choisir, l'installation avec Docker Compose, l'adresse publique et le secret, les comptes, HTTPS, les réglages propres à Vikunja, l'e-mail, les sauvegardes et les mises à jour.

Simon Vasconcelos Lee Par Publié le 19 novembre 2026Lecture : 14 minutes

Tous les guides

L'essentiel

  1. La licence AGPL-3.0 permet d'utiliser Vikunja en entreprise sans licence à acheter ; si vous le modifiez, vos utilisateurs à distance doivent pouvoir obtenir le code source de votre version.
  2. Installez-le avec Docker Compose : l'image vikunja/vikunja:2.8.0 et PostgreSQL, le port 3456 publié sur 127.0.0.1 derrière un proxy inverse en HTTPS.
  3. Deux réglages sont à poser dès le départ : service.publicurl, l'adresse HTTPS de votre instance, et service.secret, qui signe les sessions.
  4. Vikunja n'a aucun compte par défaut : créez le vôtre, puis fermez les inscriptions et ajoutez les comptes suivants en ligne de commande.
  5. Sauvegardez ensemble la base de données et le dossier files, avant chaque mise à jour ; les migrations de la base se font seules au démarrage.

Ce que fait Vikunja

Vikunja est un gestionnaire de tâches et de projets open source, auto-hébergé, que son dépôt présente comme « le gestionnaire de tâches que vous possédez vraiment ». L'API, écrite en Go, et l'interface web sont livrées dans un seul binaire, ou une seule image Docker : il n'y a qu'une chose à installer.

Ce que permet la licence AGPL-3.0

Vikunja est publié sous licence GNU AGPL version 3 ou ultérieure, à l'exception du dossier desktop/ de son dépôt, l'application de bureau, sous GPL version 3 ou ultérieure. Vous pouvez l'utiliser, y compris en entreprise, pour votre équipe comme pour vos clients, sans licence à acheter. Reste le coût du serveur qui le fait tourner.

L'article 13 ajoute une condition propre à l'AGPL : si vous modifiez le programme, votre version doit proposer clairement à tous ceux qui s'en servent à distance, par le réseau, d'obtenir son code source, gratuitement. Si vous distribuez des copies, les obligations de partage du code de la licence s'appliquent aussi. Faire tourner Vikunja sans le modifier ne déclenche pas cet article.

Ce guide installe cette édition open source, que la documentation décrit comme complète à elle seule. Vikunja Pro, une licence en option, y ajoute pour les organisations un panneau d'administration, le suivi du temps et des journaux d'audit.

Ressources et base de données

Vikunja fonctionne avec SQLite, PostgreSQL, MySQL ou MariaDB. La documentation ne chiffre ni la mémoire ni le processeur ; elle oriente le choix de la base par le nombre d'utilisateurs :

BaseCe qu’en dit la documentationVersion testée en CI
SQLiteIncluse dans le binaire et l’image Docker, rien à installer. Au-delà d’une poignée d’utilisateurs, la documentation recommande MySQL ou PostgreSQL.Celle qui est incluse
PostgreSQLLa base des exemples Docker de la documentation. Depuis la 2.8.0, la recherche ignore les accents avec l’extension unaccent.18
MySQL, MariaDBMySQL 8.0 au minimum, la 5.7 n’étant pas prise en charge. Pour les caractères non latins, la base doit être en utf8mb4.MySQL 8, MariaDB 12

La documentation recommande une version de base de données encore maintenue. Redis peut servir de cache, mais elle précise qu'on n'en a probablement pas besoin tant que l'instance ne compte qu'une poignée d'utilisateurs : ce guide s'en passe.

Le disque suit surtout vos pièces jointes et les images de fond des projets, rangées dans le dossier files, à 20 Mo au plus par fichier par défaut. Sur un VPS infogéré, décrivez-nous votre équipe, son nombre d'utilisateurs et l'usage des pièces jointes, et nous vous recommandons la taille qui convient.

L'installation avec Docker Compose

La documentation installe Vikunja et PostgreSQL avec Docker Compose. Sur un serveur où Docker est installé, créez un dossier et générez d'abord le secret de l'instance, une valeur aléatoire que vous collerez dans le fichier :

Terminal
openssl rand -hex 32

Placez ensuite dans ce dossier ce docker-compose.yml, tiré de l'exemple PostgreSQL de la documentation. Remplacez tasks.example.com par votre nom de domaine, collez-ici-le-secret par la valeur obtenue, et changeme par un mot de passe solide, le même aux deux endroits :

docker-compose.yml
services:
  vikunja:
    image: vikunja/vikunja:2.8.0
    environment:
      VIKUNJA_SERVICE_PUBLICURL: https://tasks.example.com/
      VIKUNJA_SERVICE_SECRET: collez-ici-le-secret
      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 tourne sous l'utilisateur 1000 : créez le dossier files et donnez-le-lui avant le premier démarrage, comme le demande la documentation, puis lancez les services :

Terminal, dans le dossier du docker-compose.yml
mkdir files
sudo chown 1000 files
docker compose up -d
docker compose logs vikunja

Au premier démarrage, Vikunja crée sa base et y joue toutes ses migrations. La ligne http server started on [::]:3456 dans les journaux signale qu'il est prêt, et curl http://127.0.0.1:3456/api/v1/info, lancé sur le serveur, rend sa version et ses réglages publics.

Avec SQLite

Pour une poignée d'utilisateurs, la documentation propose SQLite : retirez le service db, le bloc depends_on et les variables VIKUNJA_DATABASE_*, et montez un dossier sur /db, où l'image range déjà vikunja.db. Créez-le et donnez-le à l'utilisateur 1000, comme files :

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

Sans Docker : le paquet Debian

Depuis la version 2.4.0, Vikunja publie un dépôt de paquets pour Debian et Ubuntu, en amd64, arm64 et armhf, signé par sa clé 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

Le paquet installe Vikunja dans /opt/vikunja, avec SQLite par défaut, et un service systemd activé mais pas encore démarré. Il écrit aussi un secret aléatoire dans une section service de /etc/vikunja/config.yml : complétez cette même section, puis démarrez le service.

/etc/vikunja/config.yml
service:
  secret: "la valeur écrite par le paquet"
  publicurl: "https://tasks.example.com/"
  interface: "127.0.0.1:3456"
  ipextractionmethod: "xff"
Terminal
sudo systemctl start vikunja

Le premier compte et les inscriptions

Vikunja ne crée aucun compte par défaut. Une fois HTTPS en place, ouvrez https://tasks.example.com/ et inscrivez-vous : c'est votre premier compte. Les inscriptions sont ouvertes par défaut, à toute personne qui atteint l'adresse ; une fois les comptes de votre équipe créés, la documentation suggère de les fermer. Ajoutez cette ligne aux variables du service vikunja, puis relancez docker compose up -d :

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

Les comptes suivants se gèrent en ligne de commande. L'image n'ayant pas de shell, on appelle directement son binaire :

Terminal, dans le dossier du 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 sécurité des comptes

HTTPS : le proxy inverse

Vikunja sert du HTTP en clair. La documentation termine HTTPS sur un proxy inverse, pour que les mots de passe et les jetons ne circulent jamais en clair : il écoute sur les ports 80 et 443, obtient le certificat et transmet à Vikunja sur 127.0.0.1:3456.

Derrière un proxy, Vikunja voit par défaut l'adresse du proxy pour chaque requête : journaux et limites de débit visent alors tout le monde à la fois. Le réglage VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff, posé dans le fichier Compose, lui fait lire l'en-tête X-Forwarded-For. Il ne s'y fie que pour les requêtes venues des adresses de bouclage et des réseaux privés, dont celui de Docker : avec le port publié sur 127.0.0.1, seul votre proxy y parvient.

Avec Caddy

Voici le Caddyfile de la documentation. Caddy obtient seul un certificat Let's Encrypt pour le nom indiqué, transmet l'en-tête X-Forwarded-For et laisse passer les connexions WebSocket :

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

Avec Nginx

Le bloc de la documentation tient en une ligne proxy_pass et une taille d'envoi. Ce bloc le reprend, avec deux ajouts : l'en-tête X-Forwarded-For, que Vikunja lit, et les en-têtes WebSocket. L'interface de la version 2.8.0 ouvre en effet une connexion WebSocket sur /api/v2/ws pour ses mises à jour en direct ; quand elle échoue, ses notifications se rabattent sur une interrogation toutes les 10 secondes. Ajoutez d'abord ce bloc map dans la section http de /etc/nginx/nginx.conf :

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

Puis ce bloc de site, sur le port 80 pour laisser Certbot poser HTTPS :

Bloc 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 suit la taille maximale d'un fichier dans Vikunja, 20 Mo par défaut. Si vous la relevez avec VIKUNJA_FILES_MAXSIZE, la documentation demande de relever aussi cette ligne.

Les réglages propres à Vikunja

Presque chaque clé du fichier config.yml a sa variable d'environnement : service.enablecaldav devient VIKUNJA_SERVICE_ENABLECALDAV. Si une option est posée aux deux endroits, la variable l'emporte. La liste de durcissement de la documentation passe en revue les fonctions à désactiver si vous n'en avez pas l'usage :

CléPar défautÀ désactiver pour
service.enablelinksharingtrueEmpêcher le partage de projets par lien public
service.enablecaldavtrueRetirer l’accès CalDAV, qui accepte l’authentification HTTP basique
webhooks.enabledtrueEmpêcher Vikunja d’envoyer des requêtes vers des adresses choisies par les utilisateurs
service.enabletaskattachmentstrueEmpêcher l’envoi de fichiers sur les tâches
service.enableuserdeletiontrueEmpêcher les utilisateurs de supprimer eux-mêmes leur compte
plugins.enabledfalseDéjà désactivé : garder le code tiers hors de Vikunja

La recherche sans accents sur PostgreSQL

Depuis la 2.8.0, la recherche ignore les accents sur PostgreSQL quand l'extension unaccent est active : « cafe » trouve aussi « café ». L'image officielle de PostgreSQL la fournit ; activez-la dans la base de Vikunja, puis redémarrez-le. Le journal affiche alors unaccent extension detected, search is accent-insensitive.

Terminal, dans le dossier du docker-compose.yml
docker compose exec db psql -U vikunja -d vikunja -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
docker compose restart vikunja

Importer vos tâches

Chaque utilisateur importe ses tâches depuis l'onglet « Import » de ses paramètres, et y exporte aussi toutes ses données dans une archive zip. Les imports par fichier, archive Vikunja, CSV, TickTick et WeKan, ainsi que l'import depuis une instance Planka, sont toujours disponibles. Todoist, Trello et Microsoft To Do passent par OAuth : ils sont désactivés par défaut et s'activent dans la section migration de la configuration, avec les identifiants de l'application créée chez chaque service. La redirection OAuth se fait dans le navigateur : l'instance n'a pas besoin d'être joignable par ces services, mais service.publicurl doit être exacte.

CalDAV

CalDAV synchronise les tâches avec vos applications, à partir des informations de connexion de l'onglet CalDAV des paramètres. La documentation présente cette intégration comme une alpha, qui fonctionne bien avec certains clients : essayez le vôtre avant d'en faire l'outil de toute l'équipe. Sur iPhone et iPad, chaque projet devient une liste de l'app Rappels. Un compte avec double authentification se connecte avec un jeton CalDAV dédié.

L'e-mail : rappels, confirmations et mots de passe

Vikunja envoie des e-mails pour les rappels de tâches, la confirmation des nouveaux comptes et la réinitialisation des mots de passe. Son envoi est désactivé par défaut : les comptes sont alors actifs dès leur création, et la réinitialisation par e-mail est impossible. Une fois l'envoi activé, chaque nouveau compte local confirme son adresse avant de servir.

Depuis un VPS Simafri, configurez un serveur SMTP authentifié, sur le port 587 ou 465 : celui de votre service d'envoi ou de votre messagerie. Ajoutez ces variables au service vikunja :

docker-compose.yml, dans environment
      VIKUNJA_MAILER_ENABLED: "true"
      VIKUNJA_MAILER_HOST: smtp.example.com
      VIKUNJA_MAILER_PORT: 587
      VIKUNJA_MAILER_USERNAME: tasks@example.com
      VIKUNJA_MAILER_PASSWORD: le-mot-de-passe-smtp
      VIKUNJA_MAILER_FROMEMAIL: tasks@example.com

Relancez docker compose up -d, puis envoyez un message d'essai. La commande vérifie la connexion par une commande SMTP NOOP, que certains relais minimaux ne connaissent pas : préférez un serveur SMTP complet.

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

Les sauvegardes

La documentation compte deux éléments à sauvegarder, ensemble : la base de données et le dossier des pièces jointes. Depuis la 2.8.0, les tâches et les projets supprimés passent d'abord 30 jours dans la corbeille ; une fois ce délai passé ou la corbeille vidée, seule une sauvegarde les ramène.

ÉlémentCe qu’il gardeComment le copier
La base PostgreSQLLes comptes, les projets, les tâches, les commentaires et les réglagespg_dump, sans arrêter Vikunja
filesLes pièces jointes, les avatars et les images de fondUne copie du dossier
Avec SQLite, db/vikunja.dbToute la baseUne copie du fichier, Vikunja arrêté
docker-compose.ymlLe secret, l’adresse publique et les mots de passeÀ garder à part, comme un secret
Terminal, dans le dossier du 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 documentation demande des sauvegardes chiffrées, gardées hors du serveur, et des restaurations testées régulièrement : sur une instance à part, connectez-vous et ouvrez une tâche avec une pièce jointe. Posées sur le disque du serveur, ces archives entrent aussi dans ses sauvegardes de nuit.

La commande vikunja dump réunit dans une archive zip la configuration, la base et tous les fichiers, et vikunja restore la recharge. L'archive contient en clair le fichier de configuration et toutes les variables VIKUNJA_* : chiffrez-la et protégez-la comme la base elle-même.

Restaurer

Sur une installation neuve, avec le même docker-compose.yml, rechargez l'export dans la base encore vide avant le premier démarrage de Vikunja, puis remettez le dossier files en place :

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

Les mises à jour

Vikunja joue seul les migrations de sa base au démarrage d'une nouvelle version. La documentation demande donc une sauvegarde avant chaque mise à jour, pour pouvoir revenir à l'état précédent, et la lecture des notes de version, qui signalent les gestes manuels éventuels.

  1. Lisez les notes de la nouvelle version.
  2. Exportez la base et copiez le dossier files.
  3. Changez l’étiquette de l’image dans docker-compose.yml, par exemple de 2.8.0 à la version suivante.
  4. Tirez la nouvelle image et relancez le service.
Terminal
docker compose pull
docker compose up -d

Avec le paquet Debian, sudo apt update && sudo apt upgrade remplace le binaire et redémarre le service. Passer d'une version stable aux versions unstable fonctionne, mais la documentation déconseille le retour : attendez plutôt la version stable suivante.

Les correctifs de sécurité sont publiés comme avis de sécurité sur GitHub et annoncés dans les notes de version. La 2.8.0 du 5 novembre 2026 en corrige dix-neuf, et son annonce demande de mettre à jour au plus vite. Pour être prévenu, suivez les versions du dépôt GitHub ou le flux RSS du journal des changements.

Qui fait quoi sur un VPS infogéré

L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS infogéré, nos équipes prennent le serveur en main et suivent votre instance de manière proactive ; Vikunja reste votre logiciel, avec ses réglages, vos projets et vos tâches.

SujetNos équipesVous
Le serveurMises à jour du système et de la sécurité, interventions sur le serveur comprisesLe moment qui convient à votre activité
La supervisionServeur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appelLa lecture des journaux de votre instance
VikunjaSuivi proactif : erreurs, lenteurs et espace disque repérés, correction recommandéeSon installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA
Les comptes et les projetsLe serveur qui les porte, surveillé et sauvegardéLes comptes, les inscriptions, les partages et les droits de votre équipe
L’e-mailUn serveur qui joint votre serveur SMTP sur le port 587 ou 465Votre service d’envoi et ses identifiants
Les sauvegardesChaque nuit, chiffrées et gardées hors de la machine ; restauration compriseVos exports de la base et du dossier files, et la demande de restauration, quand vous en avez besoin
La migrationVotre serveur actuel migré, offertLe moment de la bascule

Si vous préférez que nos équipes interviennent dans l'application elle-même, cette prestation se facture à l'heure ou au forfait, avec un chiffrage communiqué avant l'intervention.

Vikunja, sur un serveur tenu pour vous

Avec un VPS infogéré Simafri, nos équipes tiennent à jour le serveur de votre instance Vikunja, le surveillent jour et nuit et interviennent sans attendre votre appel ; elles suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez, vous ou votre assistant IA. Les sauvegardes sont chiffrées chaque nuit et gardées hors de la machine, leur restauration est comprise, et la migration de votre serveur actuel est offerte.

Découvrir les VPS infogérés

Questions fréquentes

Vikunja est-il gratuit pour une entreprise ?

Oui. Vikunja est sous licence AGPL-3.0 : vous pouvez l'utiliser en entreprise sans licence à acheter. Si vous le modifiez, vos utilisateurs à distance doivent pouvoir obtenir le code source de votre version. Reste le coût du serveur qui le fait tourner.

Quelle base de données choisir pour Vikunja ?

SQLite, incluse dans l'image, suffit pour une poignée d'utilisateurs. Au-delà, la documentation recommande PostgreSQL ou MySQL. PostgreSQL est la base de ses exemples Docker, et depuis la 2.8.0 sa recherche ignore les accents avec l'extension unaccent.

Comment installer Vikunja avec Docker Compose ?

Créez un docker-compose.yml avec l'image vikunja/vikunja:2.8.0 et postgres:18, le port 3456 publié sur 127.0.0.1, un dossier files donné à l'utilisateur 1000, l'adresse publique et le secret, puis lancez docker compose up -d. Placez ensuite un proxy inverse en HTTPS devant le port 3456.

À quoi servent service.publicurl et service.secret ?

service.publicurl est l'adresse HTTPS de votre instance : Vikunja en tire ses liens et son origine CORS, d'où une erreur unauthorized si elle est inexacte. service.secret signe les sessions ; laissé vide, il change à chaque démarrage et déconnecte tous les utilisateurs.

Comment créer le premier compte de Vikunja ?

Vikunja n'a aucun compte par défaut : inscrivez-vous sur votre instance. Fermez ensuite les inscriptions avec VIKUNJA_SERVICE_ENABLEREGISTRATION à false, et créez les comptes suivants avec la commande vikunja user create, lancée dans le conteneur.

Comment configurer l’e-mail de Vikunja ?

Activez l'envoi avec VIKUNJA_MAILER_ENABLED, puis donnez l'hôte, le port 587 ou 465, l'identifiant, le mot de passe et l'adresse d'expédition de votre serveur SMTP. Sans e-mail, les comptes sont actifs dès leur création et les mots de passe se réinitialisent en ligne de commande.

Comment sauvegarder Vikunja ?

Sauvegardez ensemble la base de données, avec pg_dump pour PostgreSQL, et le dossier files des pièces jointes. Gardez les copies chiffrées hors du serveur, faites-en une avant chaque mise à jour et testez régulièrement leur restauration.

Un VPS infogéré couvre-t-il Vikunja ?

Un VPS infogéré couvre le serveur : système, sécurité, supervision et sauvegardes. Nos équipes suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez. Une intervention dans l'application se facture à l'heure ou au forfait.

Sources et documentation officielle

Contactez-nous