selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Habitica logo

Self-host Habitica

v5.52.1

Gamified habit tracker that turns life tasks into an RPG

ReleaseOpen SourceOther
Updatedyesterday
LanguageJavaScript
Setup difficultyAdvanced
MobileNative app
Stars
14 307
Ports
3000 (Habitica Express server (API)), 5173 (Web client UI in the browser)
Requires
MongoDB
Install with Docker
Habitica screenshot 1Habitica screenshot 2Habitica screenshot 3Habitica screenshot 4Habitica screenshot 5Habitica screenshot 6

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.

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

Public pull request submissions paused as of August 4, 2026

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.

⚠️ No AI-Generated Code Policy

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.

How to install Habitica

Install Habitica with Docker

Install system packages: sudo apt install -y curl git libkrb5-dev make g++

  • Restart your terminal session, then nvm install 20
  • Clone the Habitica repository and install dependencies:
  • git clone https://github.com/HabitRPG/habitica
  • cd habitica
  • npm i
  • cp config.json.example config.json
  • Install Docker Engine if you don't already have it.

All-in-One Docker: npm run docker:aio

Official wiki instructions; production Habitica runs on Ubuntu Linux, instructions target similar Debian-based distros. Framed as a local install for development and testing.

How to configure Habitica

  • NODE_DB_URImongodb://mongo/habitrpgMongoDB connection URI for the server (docker-compose)
  • BASE_URLhttp://server:3000Server base URL used by the client container (docker-compose)

Habitica releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

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

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…