Microsoft To Do : importer ses tâches dans Vikunja
Les applis Microsoft To Do ferment le 30 juin 2027 et Planner exclut les comptes personnels. Installez Vikunja sur votre VPS et importez vos listes avec son outil intégré.
Ce qui change pour Microsoft To Do
Microsoft To Do ferme ses applications le 30 juin 2027, et Microsoft n'offre aucune solution de remplacement pour un compte personnel. Ce guide installe Vikunja, un gestionnaire de tâches libre, sur votre VPS. Il utilise ensuite l'outil d'import intégré de Vikunja pour y déplacer vos listes Microsoft To Do. Faites l'import tôt, parce que l'outil lit vos tâches par l'API de Microsoft, et cette API a aussi une date de fin, encore inconnue.
Voici ce que dit la page d'aide de Microsoft « Passage de Microsoft To Do à Microsoft Planificateur », lue le 22 novembre 2026 :
- Les applications To Do s'arrêtent le 30 juin 2027 sur le web, Windows, Mac, iOS et Android. Cela vaut pour les comptes professionnels ou scolaires et pour les comptes personnels.
- Les comptes personnels sont concernés, y compris Microsoft 365 Personnel et Famille. Planner n'est pas disponible pour ces comptes. Microsoft conseille seulement de choisir une autre application de gestion de tâches.
- Microsoft promet un moyen d'exporter vos données To Do avant la fermeture. Au 22 novembre 2026, la page ne donne encore aucune instruction. Elle annonce qu'elle sera mise à jour, donc relisez-la de temps en temps.
- Le service To Do, ses API et la synchronisation s'arrêteront plus tard, à des dates que Microsoft annoncera séparément. La fermeture des applications ne programme pas, à elle seule, la suppression de vos tâches.
- Les tâches de l'Outlook classique sont un produit distinct. Selon la même page, elles continuent de fonctionner et de se synchroniser avec Exchange.
Avec un compte Outlook.com, Hotmail ou Microsoft 365 Famille, il faut donc partir. Vikunja est un bon point d'arrivée pour deux raisons concrètes : il tourne dans un seul conteneur, et il a un import Microsoft To Do intégré. Il gère aussi CalDAV pour la synchronisation avec le téléphone. Si vous comparez encore les outils, notre tour d'horizon des alternatives à Trello auto-hébergées présente Vikunja à côté de Planka et des autres tableaux kanban.
Ce qu'il vous faut avant de commencer
- Un VPS Linux avec Docker et le plugin Compose. Si Compose est nouveau pour vous, lisez d'abord les bases de Docker Compose sur un VPS.
- Un nom de domaine. Ce guide utilise
taches.example.fr. Créez un enregistrement DNS A (et AAAA si vous avez de l'IPv6) qui pointe vers l'adresse IP du VPS. - Les ports 80 et 443 ouverts vers le VPS, dans le pare-feu du système et dans celui de votre hébergeur s'il en a un.
- Un compte Azure avec un abonnement actif, pour inscrire une application chez Microsoft. Le guide de démarrage de Microsoft le demande, et propose de créer un compte gratuit. L'annuaire par défaut (« Default Directory ») suffit.
Le HTTPS est obligatoire ici. Microsoft exige une adresse de redirection en https, sauf pour certaines adresses localhost. Une adresse comme http://203.0.113.10:3456 est donc refusée. C'est pour cela que Caddy fait partie du montage. Caddy est un serveur web qui obtient seul ses certificats TLS (transport layer security).
Installer Vikunja 2.8.0 derrière Caddy
Vikunja 2.8.0 est la dernière version au 22 novembre 2026. Elle est sortie le 5 novembre 2026 et corrige 19 problèmes de sécurité. Le logiciel est sous licence AGPL-3.0. Une seule image contient l'API et l'interface web. Elle écoute sur le port 3456 et tourne avec l'utilisateur 1000.
Les exemples officiels utilisent l'image sans numéro de version (vikunja/vikunja). Ici, la version est fixée à vikunja/vikunja:2.8.0. Une mise à jour reste alors une décision de votre part, prise au moment que vous choisissez.
Créez le dossier du projet. Le dossier files doit appartenir à l'utilisateur 1000, sinon Vikunja ne peut pas y écrire les pièces jointes.
mkdir -p ~/vikunja && cd ~/vikunja
mkdir files db
sudo chown 1000 filesGénérez deux secrets et placez-les dans un fichier .env lisible par vous seul :
(umask 077; printf 'DB_PASSWORD=%s\nVIKUNJA_SECRET=%s\n' "$(openssl rand -hex 24)" "$(openssl rand -hex 32)" > .env)
ls -l .env
cat .envls -l doit afficher -rw-------, et le fichier doit contenir deux lignes avec de longues valeurs hexadécimales. Compose lit ce fichier tout seul quand il se trouve dans le même dossier que compose.yaml. Notre guide sur les fichiers .env et les secrets dans Docker Compose explique les limites de cette méthode.
Créez le fichier Caddyfile. C'est la forme donnée dans la documentation de Vikunja, avec le nom du service Docker à la place de 127.0.0.1 :
taches.example.fr {
reverse_proxy vikunja:3456
}Créez ensuite le fichier compose.yaml. Il reprend l'exemple complet de la documentation de Vikunja (avec PostgreSQL 18), avec trois changements. La version de l'image est fixée. Caddy publie les ports. Vikunja ne publie plus le port 3456 sur l'hôte, parce que Caddy le joint par le réseau interne de Compose. Personne ne peut donc contourner le HTTPS.
services:
vikunja:
image: vikunja/vikunja:2.8.0
environment:
VIKUNJA_SERVICE_PUBLICURL: https://taches.example.fr/
VIKUNJA_DATABASE_HOST: db
VIKUNJA_DATABASE_TYPE: postgres
VIKUNJA_DATABASE_USER: vikunja
VIKUNJA_DATABASE_PASSWORD: ${DB_PASSWORD}
VIKUNJA_DATABASE_DATABASE: vikunja
VIKUNJA_SERVICE_SECRET: ${VIKUNJA_SECRET}
volumes:
- ./files:/app/vikunja/files
depends_on:
db:
condition: service_healthy
restart: unless-stopped
db:
image: postgres:18
environment:
POSTGRES_PASSWORD: ${DB_PASSWORD}
POSTGRES_USER: vikunja
volumes:
- ./db:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -h localhost -U $$POSTGRES_USER"]
interval: 30s
start_period: 15s
start_interval: 5s
restart: unless-stopped
caddy:
image: caddy:2.11.9
restart: unless-stopped
ports:
- "80:80"
- "443:443"
- "443:443/udp"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
- caddy_config:/config
depends_on:
- vikunja
volumes:
caddy_data:
caddy_config:Deux remarques sur ce fichier. Le volume PostgreSQL pointe vers /var/lib/postgresql, comme dans l'exemple officiel pour PostgreSQL 18. Et VIKUNJA_SERVICE_SECRET est le nom actuel du secret. Les anciens tutoriels écrivent VIKUNJA_SERVICE_JWTSECRET. Cette variable est obsolète : si elle est définie, Vikunja recopie sa valeur dans service.secret.
Démarrez la pile, puis vérifiez :
docker compose up -d
docker compose ps
docker compose logs caddy | grep -i certificate
curl -I https://taches.example.fr/docker compose ps doit montrer les trois services en cours d'exécution, et db doit passer à l'état healthy. Vikunja attend ce test avant de démarrer, à cause de condition: service_healthy. La commande curl doit répondre avec un code 200. Si curl échoue sur le certificat, lisez les journaux de Caddy. En général, l'enregistrement DNS ne pointe pas encore vers le VPS, ou un pare-feu bloque le port 443. Caddy obtient le certificat seul, mais seulement si le domaine pointe vers le serveur.
Créer votre compte, puis fermer les inscriptions
Après l'installation, Vikunja n'a ni utilisateur ni mot de passe par défaut. Ouvrez https://taches.example.fr/ et créez votre compte avec le lien d'inscription. Créez aussi les comptes de votre famille si vous en voulez.
Les inscriptions sont ouvertes par défaut (service.enableregistration vaut true). Sur un VPS public, n'importe qui peut donc créer un compte chez vous. La documentation conseille de les fermer après avoir créé vos utilisateurs. Ajoutez cette ligne dans le bloc environment du service vikunja :
VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"Lancez ensuite docker compose up -d. Compose voit que la configuration a changé et recrée le conteneur vikunja. Le lien d'inscription doit disparaître de la page de connexion.
Inscrire une application chez Microsoft
L'import de Vikunja se connecte à Microsoft Graph avec OAuth. Vikunja a donc besoin d'un identifiant client et d'un secret client. Vous les obtenez en inscrivant une application dans Microsoft Entra. La documentation de Vikunja ne décrit pas cette étape. Les réglages ci-dessous viennent de la documentation de Microsoft et du code source de Vikunja 2.8.0.
- Ouvrez le centre d'administration Microsoft Entra,
https://entra.microsoft.com, avec votre compte Azure. - Allez dans Entra ID, puis App registrations, puis New registration. Le portail peut afficher ces menus en français.
- Donnez un nom à l'application, par exemple
vikunja-import. - Dans Supported account types, choisissez l'option qui accepte les comptes Microsoft personnels. Le guide de Microsoft la nomme « Any Entra ID Tenant + Personal Microsoft accounts ». D'autres pages de Microsoft emploient un libellé plus long. Choisissez donc par le sens : tous les annuaires, plus les comptes personnels.
- Cliquez sur Register. Notez l'Application (client) ID affiché sur la page Overview.
- Dans Manage, puis Authentication, ajoutez une adresse de redirection de type Web :
https://taches.example.fr/migrate/microsoft-todo. - Dans Certificates & secrets, puis Client secrets, cliquez sur New client secret. Copiez la Value tout de suite : Microsoft ne l'affiche plus jamais une fois que vous quittez la page.
- Dans API permissions, ajoutez les permissions déléguées Microsoft Graph
Tasks.ReadetTasks.Read.Shared.
Pourquoi ces choix ? Le code de Vikunja 2.8.0 demande les portées tasks.read tasks.read.shared et utilise le point d'accès /common de Microsoft. Ce point d'accès accepte les comptes Microsoft personnels et les comptes professionnels ou scolaires. L'application doit donc accepter les comptes personnels, sinon votre compte Outlook.com ne peut pas s'y connecter. Tasks.Read donne seulement le droit de lire vos tâches et vos listes. L'outil ne peut rien créer, modifier ou supprimer chez Microsoft. Microsoft indique qu'un compte personnel peut accorder cette permission, sans consentement d'administrateur.
Microsoft limite la durée d'un secret client à 24 mois et recommande moins de 12 mois. Pour un import qui dure une soirée, choisissez la durée la plus courte. Quand le secret expire, l'import cesse de fonctionner.
Activer l'import Microsoft To Do dans Vikunja
Ajoutez deux valeurs au fichier .env, en remplaçant les exemples par vos vraies valeurs :
cat >> .env <<'EOF'
MS_CLIENT_ID=00000000-0000-0000-0000-000000000000
MS_CLIENT_SECRET=collez-ici-la-value-du-secret
EOFAjoutez ensuite ces lignes au bloc environment du service vikunja :
VIKUNJA_MIGRATION_MICROSOFTTODO_ENABLE: "true"
VIKUNJA_MIGRATION_MICROSOFTTODO_CLIENTID: ${MS_CLIENT_ID}
VIKUNJA_MIGRATION_MICROSOFTTODO_CLIENTSECRET: ${MS_CLIENT_SECRET}
VIKUNJA_MIGRATION_MICROSOFTTODO_REDIRECTURL: https://taches.example.fr/migrate/microsoft-todoL'import est désactivé par défaut (migration.microsofttodo.enable vaut false). Sans adresse de redirection, le code de Vikunja en construit une à partir de VIKUNJA_SERVICE_PUBLICURL, en ajoutant migrate/microsoft-todo. Ici, le résultat serait le même. Elle est écrite en clair pour une raison simple : cette valeur doit correspondre exactement à l'adresse inscrite chez Microsoft. Avec une seule lettre de différence, Microsoft refuse la connexion. N'ajoutez pas de paramètre de requête (?...), parce que Microsoft les interdit pour les applications qui acceptent les comptes personnels.
Appliquez avec docker compose up -d, puis vérifiez que Vikunja voit les variables :
docker compose exec vikunja env | grep MICROSOFTTODOLes quatre variables doivent apparaître avec vos valeurs. Une valeur vide après le signe égal signifie que Compose n'a pas trouvé la variable dans .env.
Lancer l'import de vos tâches To Do
Connectez-vous à Vikunja. Ouvrez la page d'import depuis d'autres services, à l'adresse https://taches.example.fr/migrate, et choisissez Microsoft Todo. Le navigateur part chez Microsoft. Connectez-vous avec votre compte Outlook.com ou Hotmail, puis acceptez la demande d'accès en lecture à vos tâches. Microsoft vous renvoie ensuite vers /migrate/microsoft-todo, et Vikunja lance l'import.
La documentation de Vikunja précise un point utile : l'instance n'a pas besoin d'être publique pour cet import. Elle doit seulement être joignable depuis le navigateur qui fait l'import, parce que c'est le navigateur qui suit la redirection. Le serveur Vikunja doit quand même pouvoir joindre Microsoft sur internet, puisqu'il lit vos tâches lui-même.
Une limite honnête avant de commencer. Nous n'avons pas testé cet import de bout en bout avec un vrai compte personnel. Ni la documentation de Vikunja ni celle de Microsoft ne décrivent ce cas précis. La section suivante vient de la lecture du code source de l'import dans Vikunja 2.8.0. Si un détail compte pour vous, vérifiez-le sur une liste d'essai avant de tout migrer.
Ce que l'import récupère, et ce qu'il perd
Selon le code de la version 2.8.0, l'import crée un projet parent nommé « Migrated from Microsoft Todo ». Chacune de vos listes y devient un sous-projet. Pour chaque tâche, il reprend :
- le titre ;
- l'état terminé, avec la date de fin ;
- la note de la tâche, seulement si elle est en texte simple (une note au format HTML est ignorée) ;
- l'importance, convertie en priorité 1, 2 ou 3 (faible, normale, haute) ;
- la date d'échéance ;
- un rappel, tiré de la date de rappel ;
- une répétition simplifiée.
La répétition mérite une explication. Vikunja la convertit en intervalle fixe : il multiplie l'intervalle de la règle To Do par la durée de l'unité. Avec un intervalle de 1, cela donne 1 jour pour quotidien, 7 jours pour hebdomadaire, 30 jours pour mensuel et 365 jours pour annuel. Une tâche « toutes les 2 semaines » devient donc un intervalle de 14 jours, et une tâche « tous les 3 jours » un intervalle de 3 jours. Le jour du mois, les jours de la semaine et la fin de la série sont ignorés. Les autres types de règle, comme absoluteMonthly ou relativeMonthly, ne sont pas reconnus : la tâche arrive sans aucune répétition. Vérifiez donc vos tâches répétées après l'import, et corrigez-les à la main.
D'après le code, l'import ne demande pas non plus à Microsoft les étapes d'une tâche (les sous-tâches de To Do), les liens, les pièces jointes ni les catégories. Si vous utilisez beaucoup les étapes, notez-les avant de quitter To Do. Ce point vient de la lecture du code, pas d'un essai.
Pour vérifier le résultat, comparez le nombre de tâches ouvertes de chaque liste dans To Do et dans Vikunja. Ouvrez aussi deux ou trois tâches qui ont une échéance et une répétition. Ne supprimez rien chez Microsoft tant que ce contrôle n'est pas fait.
Quand l'import est terminé, vous n'avez plus besoin de l'accès à Microsoft. Retirez les quatre variables MICROSOFTTODO du fichier compose.yaml, lancez docker compose up -d, puis supprimez le secret client dans Entra. Quand Microsoft publiera son outil d'export, téléchargez quand même vos données. Vous aurez ainsi une copie d'archive en plus de Vikunja.
Synchroniser Vikunja avec votre téléphone
Vikunja expose vos tâches en CalDAV, le protocole standard des agendas et des listes de tâches. La documentation prévient que cette fonction est en phase alpha précoce et qu'elle a des bugs. Elle marche bien avec certains clients et mal avec d'autres.
La documentation liste ces clients comme fonctionnels :
- Evolution ;
- OpenTasks avec DAVx⁵, sur Android ;
- Tasks, sur Android ;
- Korganizer ;
- Rappels d'Apple sur iOS, avec Vikunja 2.2.0 ou plus récent.
Thunderbird figure dans la liste des clients qui ne marchent pas, mais pour sa version 68, qui est ancienne. La documentation ne dit rien des versions récentes.
Pour vous connecter, copiez l'adresse CalDAV affichée dans les paramètres CalDAV de Vikunja. Pour iOS, la documentation donne la forme https://taches.example.fr/api/v1/dav/principals/votrenom/. L'identifiant est votre nom d'utilisateur Vikunja. Comme mot de passe, préférez un jeton CalDAV créé dans ces mêmes paramètres. Votre mot de passe normal ne marche pas si la double authentification est active. Depuis la version 2.6.0, Vikunja accepte par défaut 10 tentatives ratées par minute. Un téléphone mal configuré peut donc atteindre vite cette limite.
Si vous gérez déjà un serveur Nextcloud, l'application Nextcloud Tasks est l'autre voie. Elle est sous licence AGPL-3.0 et synchronise les tâches en CalDAV. Son README cite Rappels d'Apple, 2Do, DAVx5, OpenTasks, Thunderbird Lightning et vdirsyncer comme clients compatibles. Ce guide ne couvre pas l'import de To Do vers Nextcloud. Pour un agenda complet à côté des tâches, voyez notre guide sur les serveurs d'agenda CalDAV auto-hébergés.
Sauvegarder et mettre à jour Vikunja
Vos tâches vivent maintenant dans deux dossiers : db pour PostgreSQL et files pour les pièces jointes. Pour la base, faites un vidage propre plutôt qu'une copie des fichiers pendant que PostgreSQL tourne :
docker compose exec -T db pg_dump -U vikunja vikunja > vikunja-$(date +%F).sqlLe fichier obtenu doit commencer par des lignes de commentaire -- de PostgreSQL. Sauvegardez-le avec le dossier files, hors du VPS. Pour mettre à jour, changez le numéro de version de l'image dans compose.yaml, puis lancez docker compose pull et docker compose up -d. Lisez les notes de version avant chaque saut. Notre guide pour sauvegarder et mettre à jour une pile Docker Compose détaille la méthode. Si ce VPS vous donne envie d'héberger d'autres services, notre liste de ce qu'il vaut la peine d'auto-héberger en 2026 est un bon point de départ.
FAQ
Mes tâches Microsoft To Do seront-elles supprimées le 30 juin 2027 ?
Pas à cette date, selon Microsoft. Le 30 juin 2027 est la date de fin des applications. Microsoft écrit que cette fermeture ne programme pas, à elle seule, la suppression des tâches. Le service et les API s'arrêteront plus tard, à des dates pas encore publiées. L'import vers Vikunja dépend de ces API, donc faites-le avant leur fin.
Puis-je passer à Microsoft Planner avec un compte Outlook.com ou Microsoft 365 Famille ?
Non. Microsoft indique que Planner n'est pas disponible pour les comptes personnels, y compris Microsoft 365 Personnel et Famille. Même pour les comptes professionnels, les tâches To Do existantes ne sont pas migrées dans Planner. Pour un compte personnel, Microsoft conseille de choisir une autre application de gestion de tâches, comme Vikunja.
Pourquoi Microsoft refuse-t-il la connexion pendant l'import Vikunja ?
Le plus souvent, l'adresse de redirection envoyée par Vikunja ne correspond pas à celle inscrite dans Entra. Comparez VIKUNJA_MIGRATION_MICROSOFTTODO_REDIRECTURL avec l'adresse de type Web dans Authentication, lettre par lettre. Elle doit commencer par https. Vérifiez aussi que l'application accepte les comptes Microsoft personnels dans Supported account types, et que le secret client n'a pas expiré.
Les étapes (sous-tâches) de To Do sont-elles importées dans Vikunja ?
D'après le code source de Vikunja 2.8.0, non. L'import lit les listes et les tâches, mais pas les étapes, les pièces jointes ni les catégories. Nous ne l'avons pas vérifié avec un vrai compte. Faites un essai sur une petite liste, et notez vos étapes importantes avant de quitter To Do.
Quelle application mobile utiliser avec Vikunja ?
La documentation de Vikunja liste comme fonctionnels Tasks et OpenTasks avec DAVx⁵ sur Android, et Rappels d'Apple sur iOS avec Vikunja 2.2.0 ou plus récent. La synchronisation CalDAV de Vikunja est encore en alpha, donc testez-la avec une liste avant de compter dessus. Connectez-vous avec un jeton CalDAV plutôt qu'avec votre mot de passe.