OpenHabitTracker logo

OpenHabitTracker

Cross-platform app to take notes, plan tasks, and track habits

Alternative to: habitica, google keep, todoist


OpenHabitTracker is a free, open-source, privacy-focused app for taking Markdown notes, planning tasks, and tracking habits in one place, with all data stored on your own device. It offers categories and priorities for organization, advanced search/filter/sort, JSON/YAML/TSV/Markdown import and export including migration from Google Keep, and 26 selectable light/dark themes. The self-hosted web app is complemented by official native clients for Windows, Linux, macOS, Android, and iOS.

OpenHabitTracker Docker Compose example

Self-host OpenHabitTracker on your own server, homelab, or VPS starting from this Docker Compose example. It runs OpenHabitTracker in Docker containers using the official jinjinov/openhabittracker:latest image, with persistent volumes and automatic restarts preconfigured. Review the environment variables and adjust them to your setup, save the file as compose.yml (or docker-compose.yml), and start the stack with docker compose up -d.

services:
  openhabittracker:
    image: jinjinov/openhabittracker:latest
    restart: unless-stopped
    volumes:
      - data:/app/.OpenHabitTracker
    environment:
      # Admin account username used to log in
      AppSettings__UserName: "admin"
      # Admin account email address
      AppSettings__Email: "admin@admin.com"
      # Admin account password used to log in
      AppSettings__Password: "changeme"
      # Base64-encoded secret key used to sign authentication tokens. Generate with: openssl rand -base64 32
      AppSettings__JwtSecret: "changeme"
      # Server timezone
      TZ: "UTC"

volumes:
  data:

Values set to changeme are required — replace them with your own values before starting OpenHabitTracker.

Prefer a managed setup? WinterFlow installs, configures, and updates OpenHabitTracker for you using this same Docker Compose configuration.