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.
Par Simon Vasconcelos Lee
Publié le 19 novembre 2026Lecture : 14 minutes
vikunja/vikunja:2.8.0 et PostgreSQL, le port 3456 publié sur 127.0.0.1 derrière un proxy inverse en HTTPS.service.publicurl, l'adresse HTTPS de votre instance, et service.secret, qui signe les sessions.files, avant chaque mise à jour ; les migrations de la base se font seules au démarrage.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.
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.
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 :
| Base | Ce qu’en dit la documentation | Version testée en CI |
|---|---|---|
| SQLite | Incluse 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 |
| PostgreSQL | La base des exemples Docker de la documentation. Depuis la 2.8.0, la recherche ignore les accents avec l’extension unaccent. | 18 |
| MySQL, MariaDB | MySQL 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.
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 :
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 :
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 :
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.
127.0.0.1 : c'est l'écart avec les exemples de la documentation, qui publient le port sur toutes les adresses. Sa liste de durcissement demande que seul le proxy inverse puisse atteindre Vikunja : l'interface s'ouvre alors par lui, en HTTPS.VIKUNJA_SERVICE_PUBLICURL : l'adresse HTTPS qu'ouvrent vos utilisateurs, avec la barre oblique finale. Vikunja s'en sert pour construire ses liens, dans les e-mails par exemple, et comme origine autorisée par CORS, actif par défaut : ce réglage est donc obligatoire. Une adresse inexacte, un port oublié par exemple, se traduit par une erreur « unauthorized » à la création du premier compte.VIKUNJA_SERVICE_SECRET signe les jetons de session. Laissé vide, il est tiré au hasard à chaque démarrage, et chaque redémarrage déconnecte alors tous les utilisateurs.2.8.0 fixe la version, comme le recommande la documentation, pour que les mises à jour se fassent quand vous le décidez. latest suit la dernière version stable, et unstable les versions de développement.files et db gardent sur le serveur les pièces jointes et les données de PostgreSQL : ce sont eux qui se sauvegardent.scratch. docker exec vers un shell ne fonctionne pas, et les variables PUID et PGID d'autres images n'y ont aucun effet. Les erreurs se lisent avec docker compose logs vikunja.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 :
volumes:
- ./files:/app/vikunja/files
- ./db:/db
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 :
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.
service:
secret: "la valeur écrite par le paquet"
publicurl: "https://tasks.example.com/"
interface: "127.0.0.1:3456"
ipextractionmethod: "xff"
sudo systemctl start vikunja
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 :
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 :
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
user create demande le mot de passe s'il n'est pas donné par l'option -p, ce qui évite de le laisser dans l'historique du terminal.user reset-password envoie un lien par e-mail, ou remplace directement le mot de passe avec --direct, à partir de l'identifiant que donne user list.user change-status désactive ou réactive un compte, avec --disable ou --enable.doctor vérifie la configuration, l'adresse publique, le secret, la base, l'écriture dans files et, s'il est activé, le serveur SMTP.VIKUNJA_SERVICE_TIMEZONE vaut GMT par défaut et attend un nom de la base tz, Europe/Paris par exemple, jamais un décalage UTC. Il sert de fuseau par défaut aux utilisateurs, et donc à l'heure de leurs rappels.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.
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 :
tasks.example.com {
reverse_proxy 127.0.0.1:3456
}
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 :
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Puis ce bloc de site, sur le port 80 pour laisser Certbot poser HTTPS :
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;
}
}
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.
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.enablelinksharing | true | Empêcher le partage de projets par lien public |
service.enablecaldav | true | Retirer l’accès CalDAV, qui accepte l’authentification HTTP basique |
webhooks.enabled | true | Empêcher Vikunja d’envoyer des requêtes vers des adresses choisies par les utilisateurs |
service.enabletaskattachments | true | Empêcher l’envoi de fichiers sur les tâches |
service.enableuserdeletion | true | Empêcher les utilisateurs de supprimer eux-mêmes leur compte |
plugins.enabled | false | Déjà désactivé : garder le code tiers hors de Vikunja |
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.
docker compose exec db psql -U vikunja -d vikunja -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
docker compose restart vikunja
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 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é.
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 :
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
VIKUNJA_MAILER_FORCESSL: "true", qui impose une connexion TLS dès l'ouverture et refuse les connexions non chiffrées.plain par défaut, login ou cram-md5 avec VIKUNJA_MAILER_AUTHTYPE, selon votre serveur.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.
docker compose exec vikunja /app/vikunja/vikunja testmail vous@example.com
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ément | Ce qu’il garde | Comment le copier |
|---|---|---|
| La base PostgreSQL | Les comptes, les projets, les tâches, les commentaires et les réglages | pg_dump, sans arrêter Vikunja |
files | Les pièces jointes, les avatars et les images de fond | Une copie du dossier |
Avec SQLite, db/vikunja.db | Toute la base | Une copie du fichier, Vikunja arrêté |
docker-compose.yml | Le secret, l’adresse publique et les mots de passe | À garder à part, comme un secret |
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.
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 :
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
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.
files.docker-compose.yml, par exemple de 2.8.0 à la version suivante.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.
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.
| Sujet | Nos équipes | Vous |
|---|---|---|
| Le serveur | Mises à jour du système et de la sécurité, interventions sur le serveur comprises | Le moment qui convient à votre activité |
| La supervision | Serveur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appel | La lecture des journaux de votre instance |
| Vikunja | Suivi proactif : erreurs, lenteurs et espace disque repérés, correction recommandée | Son installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA |
| Les comptes et les projets | Le serveur qui les porte, surveillé et sauvegardé | Les comptes, les inscriptions, les partages et les droits de votre équipe |
| L’e-mail | Un serveur qui joint votre serveur SMTP sur le port 587 ou 465 | Votre service d’envoi et ses identifiants |
| Les sauvegardes | Chaque nuit, chiffrées et gardées hors de la machine ; restauration comprise | Vos exports de la base et du dossier files, et la demande de restauration, quand vous en avez besoin |
| La migration | Votre serveur actuel migré, offert | Le 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.
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.
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.
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.
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.
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.
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.
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.
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 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.
Simafri
Parlons de votre projet
Dites-nous en deux mots ce qu'il vous faut : on revient vers vous rapidement.
Merci ! Votre demande a bien été envoyée. Nous vous répondrons rapidement.
Vous préférez l'email ? Écrivez-nous à support@simafri.com.