Déploiement de Habitica RPG IRL

🗓️ Historique & Contexte

  • Mise en service : 26 janvier 2026
  • Objectif : auto héberger habitica et ne pas dépendre des serveur d’origine.

C’est Quoi habitica

Habitica est une application / un site web qui permet de gamifier sa vie.
Certains ont des blocs-notes, des agendas, mais souvent c’est compliqué de s’y tenir :
garder une rigueur et autres peut être compliqué parfois suivant les gens.

Habitica est un système où on peut paramétrer des habitudes, des tâches quotidiennes ou à faire.
On peut aussi paramétrer des rappels, des dates d’échéance, c’est assez complet.
Sauf qu’en plus, il apporte une dynamique de RPG mais IRL :
votre personnage a une barre de vie, une barre d’expérience et autres.
Suivant les actions négatives ou positives, il perdra de la vie ou gagnera de l’expérience

À l’intérieur de l’application, il y a tout un système de quêtes en équipe, mais aussi un shop.
Voici le lien officiel : https://habitica.com/static/home

lien git : https://github.com/HabitRPG/habitica
Je vous mets quelques captures d’écran de l’application mobile même si ici nous parle du déploiement de la partie serveur et container docker surtout.


Le déploiement (un peu laborieux)

L’application et la partie serveur sont open-source, certes,
mais vous verrez que parfois c’est plus compliqué qu’on ne le pense

le déploiement ce fais via docker mais le système fournis et complexe avec deux container docker
de mon coté après quelques recherche j’ai trouvé ce docker compose un fork
https://hub.docker.com/r/awinterstein/habitica-server
ou aussi sur son git : https://github.com/awinterstein/habitica

Les petit bug / correction lors de mes tentative de déploiement

j’ai utiliser ce container docker : https://hub.docker.com/r/awinterstein/habitica-server

Le premier lien peut fonctionner aussi, je crois que le développeur à fait des mises à jour,
mais personnellement j’ai utilisé le deuxième lien pour le docker-compose.

il faudra corriger un élément sinon la partie envoie de mail ne fonctionnera pas

registrations
      - EMAIL_SERVER_URL=mail.example.com
      - EMAIL_SERVER_PORT=587
      - EMAIL_SERVER_AUTH_USER=mail_user
      - EMAIL_SERVER_AUTH_PASSWORD=mail_password
      - ADMIN_EMAIL=mail@example.com # élément à rajouté sa défini le mail d’envois

Deuxième problème

J’ai pu constater que, si comme moi vous virtualisez avec Proxmox
et que vous utilisez Docker dans une machine virtualisée,
MongoDB 5 ne va pas fonctionner et crée des erreurs.

Pour corriger le problème, il faut changer le type de processeur
utilisé sur la VM et mettre :
type de processeur : x86-64-v3

Voir capture d’écran avec ces quelques infos.
Ça vous permet de voir un peu le contexte :
rien de complexe, mais des petits obstacles.


🧱l’Infrastructure technique

  • Hébergement : VM Debian 13 uniquement utilisé pour les containers docker
  • Stack :
    • Docker Utilisation de docker pour faire fonctionné stirling pdf
    • nginx local sur la VM gérant les containers Docker (reverse proxy HTTPS pour les services internes du LAN)
    • nginx frontal sur la VM dédiée au reverse proxy web (redirection depuis l’extérieur vers le nginx local, puis vers le container Docker)
  • Certificats SSL/TLS générés automatiquement via Let’s Encrypt

Résumer

Pour résumer, globalement ça fonctionne,
mais vous allez voir dans un prochain article
que la partie application smartphone est vraiment sympa mais très complexe cette fois
(j’ai même compilé pour la première fois un APK).

Retour en haut