Self-host Habitica
v5.52.1Gamified habit tracker that turns life tasks into an RPG
- Stars
- 14 307
- Ports
- 3000 (Habitica Express server (API)), 5173 (Web client UI in the browser)
- Requires
- MongoDB
What is Habitica?
Habitica is a habit-building app that frames personal goals as a role-playing game: positive and negative Habits, scheduled Dailies, and one-off To-Dos earn Experience and Gold, while missed Dailies cost your avatar HP. Completing tasks levels up a customizable character with four classes (Warrior, Healer, Mage, Rogue), stats, equipment, magic skills, pets and mounts; players can fight boss Quests in Parties, join community Challenges, and spend in-game Gold on self-defined real-life rewards. Group Plans provide shared task boards for families or teams but are a paid feature, alongside Gem purchases and subscriptions. The server is GPL-3 code (art and content assets are CC-licensed) built with Node.js, Express, Vue and MongoDB, with native Android and iOS clients. Most players use the hosted habitica.com service; the project's wiki documents running the whole stack locally through an all-in-one Docker command or separate npm processes, although these steps are written for development environments on Ubuntu/Debian-based Linux. Public pull-request submissions have been paused since August 2026, though the codebase remains open and visible, and the repo bans AI-generated code.
Habitica alternatives
shabiticaShabitica is a self-hosted, open-source Habitica fork that removes third-party services, runs sandboxed, and unlocks all premium features for free on NixOS.Compareshabitica with Habitica
HabitTroveSelf-hosted gamified habit tracker with coin rewards, streaks, dark mode, PWA support, and multi-language interface.CompareHabitTrove with Habitica
Beaver Habit TrackerOpen-source, self-hosted habit tracker for daily and periodic habits, with streaks, notes, categories, import/export and a REST API, run via a single Docker container.CompareBeaver Habit Tracker with Habitica
habitsyncHabitSync is a self-hosted, open-source habit tracker with social features, OIDC/SSO auth, Apprise notifications, PWA, and Android app. Runs via Docker.Comparehabitsync with Habitica
AnyHabitSelf-hosted habit tracker with streak tracking, journals, groups, API tokens, webhooks, Prometheus metrics, and MCP/AI integration for Raspberry Pi and Docker.CompareAnyHabit with Habitica
NeohabitSelf-hosted, open-source habit tracker with customizable frequencies like X times in Y days, multiple heatmap styles, and project grouping.CompareNeohabit with Habitica
OpenHabitTrackerA free, open-source habit tracker that runs everywhere and lets you sync data to your own Docker server.CompareOpenHabitTracker with Habitica
TidyQuestSelf-hosted web app that turns chores into RPG quests with health bars, coins, streaks, and family leaderboards.CompareTidyQuest with Habitica
Should you self-host Habitica?
Habitica scores 70/100 on selfhost.directory (how scoring works) and ranks #2 of 39 in Personal Productivity. It has 14 307 GitHub stars, +109 in the last 30 days.
It shipped 27 stable releases in the past year. The latest, v5.52.1, came out on 12 November 2026. New versions land roughly every 5 days.
Setup is advanced: plan for several services and some ongoing maintenance. It is Other-licensed and written mostly in JavaScript.
Its closest alternative on selfhost.directory is LanguageTool (74/100, 15 257 stars). It scores higher overall, so compare the two before you pick. See Habitica vs LanguageTool side by side.
Features
- Avatar Customization
- Challenges
- Character classes and stats
- Custom real-life rewards
- Gamified progression
- Group Plans (shared task board)Paid feature on the hosted service
- Habit, Daily and To-Do task types
- In-game pets, equipment and skills
- Party quests with other players
- Pause Damage (break mode)
- REST API
- Task Scheduling
Habitica README
Due to changes in the tech landscape and in how our player base interacts with Habitica on various platforms, we have made the decision to pause our acceptance of code-based contributions (Blacksmith tiers). Our codebase will remain open-source and publicly visible. If you’d like to know more about this pause, you can find additional details on the GitHub wiki.
This repository prohibits the submission of code generated by large language models (LLMs), AI coding assistants, or automated generation tools. All code must be authored entirely by humans. AI-assisted commits will be rejected during pull request reviews.
FAQ
What kind of Food does my Pet like?
Pets prefer food matching their color (for example White Pets like Milk and Red Pets like Strawberries), while all Base Pets like Meat.
What is the blue bar that appears after level 10?
It is Mana: unlocking the Class System also unlocks Skills that require Mana, which is determined by your Intelligence stat.
How does Automatic Allocation work?
It assigns stat points automatically by distributing them evenly, based on your class, or based on the task activity you complete.
What are stat points?
You earn one stat point per level up (to level 100) and assign it manually or automatically; allocation unlocks with the Class System at level 10.
What are character stats?
Four stats — Strength, Intelligence, Constitution and Perception — affect crits, experience, damage taken and item drops; they grow through stat points, equipment, skills and leveling.
How can I choose a class?
Everyone starts as a Warrior; at level 10 you pick a class or opt out, and you can later switch via the Orb of Rebirth or for 3 Gems in Settings.
What are the classes in Habitica?
Classes are character roles — Warrior, Healer, Mage and Rogue — each with unique benefits, skills and equipment as you level up.
Why did I lose HP when interacting with a non-negative task?
This is usually a delay while the server syncs changes made on other platforms, such as using Gold on the mobile app and then completing a task on the website.
How do I prevent losing HP?
Pause your Dailies with the Settings button, set them to never be due, or use class skills such as the Rogue's Stealth to avoid damage from missed Dailies.
What happens when I run out of HP?
At zero HP you lose a level, that level's stat point, all Gold, and a piece of equipment you can buy back, then rebuild by completing tasks.
How do I recover HP?
Buy a Health Potion from your Rewards column for 25 Gold to recover 15 HP, and note that you always recover full HP when you level up.
Can I pause my Dailies if I need a break?
Yes, the Pause Damage button in Settings stops you losing HP for missed Dailies; you can also set specific Dailies to be due every 0 days.
Why do tasks change color?
Color reflects a task's value: all tasks start yellow, become bluer as they're completed, and redder when missed or left incomplete. Redder tasks pay more Gold and Experience.
What are some sample tasks?
Examples include taking vitamins or flossing as positive Habits, smoking or doom scrolling as Negative Habits, washing dishes as a Daily, and scheduling an appointment as a To-Do.
What are the different task types?
Habitica has three task types: Habits (positive or negative, trackable multiple times a day), Dailies (tasks repeated on a structured schedule), and To-Dos (one-off tasks that may have a due date).
More in Personal Productivity
habitsyncHabitSync is a self-hosted, open-source habit tracker with social features, OIDC/SSO auth, Apprise notifications, PWA, and Android app. Runs via Docker.
HabitTroveSelf-hosted gamified habit tracker with coin rewards, streaks, dark mode, PWA support, and multi-language interface.
HammerHammer is a self-hosted, open-source story editor for novelists that works offline on all major platforms with optional self-hosted sync.
HealthLogHealthLog is a self-hosted health tracker that aggregates vitals from wearables into one timeline on your server, with AI insights and medication tracking.
HealthSave ObservatorySelf-hosted backend syncing Apple Health into your TimescaleDB with a private dashboard, Grafana, REST API, local AI, and Home Assistant/MQTT — all on your hardware.
Hermes Life OSSelf-hosted personal OS tracking mood, sleep, nutrition, habits with pattern detection and daily briefings via CLI, web dashboard, or chat bots.
HisterA self-hosted private search engine that indexes visited web pages and local files for full-content search from web, terminal, or MCP AI assistants.
HomeboxOpen-source, self-hosted home inventory for tracking your stuff by location, label and custom fields, with OIDC SSO, a REST API and QR-code labels.
IvaIva is an open-source, self-hosted Telegram AI assistant with a Markdown memory vault, voice transcription, image description, web search, and Google Workspace.
JeluJELU is a self-hosted, open-source book tracker for managing reading history, to-read lists, and book metadata with import/export, multi-user support, and a REST API.
JennyJenny is a self-hosted AI agent for Android with on-device memory, autonomous scheduling, self-written mini-apps, and optional launcher. BYOK or run local models offline.
jetlogJetlog is a self-hosted, open-source flight tracker for aviation enthusiasts to log flights, view them on a world map, and see travel statistics.






0 comments