openhabittracker

openhabittracker

Docker app from Jinjinov's Repository

Overview

Take notes, plan tasks and track habits - free, ad-free, open source, no account, all data on your server. This container is the self-hosted sync server: native apps for Windows, Linux, Android, iOS and macOS log into it and sync. Single user; log in at /login with the credentials you set below. Includes a REST API with OpenAPI UI at /scalar/v1. Habits show how overdue you are instead of guilt-driven streaks.

OpenHabitTracker

https://openhabittracker.net

App:

https://pwa.openhabittracker.net

Take notes, plan tasks, track habits

  • Free and Ad-free
  • Open Source
  • Privacy Focused: All user data is stored locally on your device
  • Available on Windows, Linux, Android, iOS, macOS, and as a web app
  • Localized to English, German, Spanish, Slovenian, French, Portuguese, Italian, Japanese, Chinese, Korean, Dutch, Danish, Norwegian, Swedish, Finnish, Polish, Czech, Slovak, Croatian, Serbian

Key Features:

  • Markdown support for notes
  • Use categories and priorities to organize your notes, tasks, and habits
  • Advanced Search, Filter, and Sort
  • Data Export/Import: JSON, YAML, TSV, Markdown
  • Import your notes from Google Keep
  • Available in 26 themes with Dark and Light modes

Stores:

Windows:

Linux - Flathub:

Linux - Snap Store:

Android:

iOS:

macOS:

Android - APKPure:

Android - GitHub, auto-updating with Obtainium:

Windows - winget (installs the Microsoft Store version):
winget install OpenHabitTracker

Docker image contains a Blazor Server app for one user

https://hub.docker.com/r/jinjinov/openhabittracker

https://github.com/Jinjinov/OpenHabitTracker/pkgs/container/openhabittracker

Set your username and password with environment variables:

.env

APPSETTINGS_USERNAME=admin
APPSETTINGS_EMAIL=admin@admin.com
APPSETTINGS_PASSWORD=admin
APPSETTINGS_JWT_SECRET=your-extremely-strong-secret-key

Replace your-extremely-strong-secret-key in Windows terminal:

[System.Convert]::ToBase64String([System.Security.Cryptography.RandomNumberGenerator]::GetBytes(32))

Replace your-extremely-strong-secret-key in Linux / macOS terminal:

openssl rand -base64 32

docker-compose.yml

services:
  openhabittracker:
    image: jinjinov/openhabittracker:latest
    ports:
      - "5050:8080"
    environment:
      - AppSettings__UserName=${APPSETTINGS_USERNAME}
      - AppSettings__Email=${APPSETTINGS_EMAIL}
      - AppSettings__Password=${APPSETTINGS_PASSWORD}
      - AppSettings__JwtSecret=${APPSETTINGS_JWT_SECRET}
      - TZ=Europe/Berlin # replace with your timezone
    volumes:
      - ./.OpenHabitTracker:/app/.OpenHabitTracker

Timezone strings: List of tz database time zones (TZ identifier column).

The default port is 5050. You can change it to 80 to avoid typing the port in the address, or to any other free port if 5050 is already in use - update the port in docker-compose.yml accordingly.

After you login at http://localhost:5050/login you can use the same browser tab to access:

Sync desktop or mobile app with Docker

Run the Docker container

Choose the platform where you want to host the OpenHabitTracker server:

Docker Desktop

  1. Open Docker Desktop and make sure it shows Engine running
  2. Open a terminal in the folder containing your .env and docker-compose.yml
  3. Run: docker-compose up -d
  4. Open http://localhost:5050/login in a browser to confirm the server is running
  5. Find this machine's IP address:
    • Windows: ipconfig
    • Mac / Linux: ifconfig

Linux server

  1. SSH into your server
  2. Install Docker: sudo apt update && sudo apt install -y docker.io docker-compose
  3. Open a terminal in the folder containing your .env and docker-compose.yml
  4. Run: docker-compose up -d
  5. Find the server IP: ifconfig

Synology NAS

  1. Open Package Center and install Container Manager
  2. Open Container ManagerProjectCreate
  3. Set the project name to openhabittracker
  4. Paste the docker-compose.yml content, replacing ${APPSETTINGS_...} placeholders with your actual values
  5. Click NextDone — the container starts automatically
  6. Find your NAS IP: Control PanelNetworkNetwork Interface

Enable sync in OpenHabitTracker

  1. Open OpenHabitTracker on your device
  2. Open the menu and click Data
  3. Scroll down to Online sync
  4. Enter the Address: http:// + the IP from your scenario above + :5050 or whichever port you chose (omit the port entirely if you chose 80)
  5. Enter your Username and Password from .env
  6. Check Remember me to stay logged in across app restarts
  7. Click Log in

Made with:

Runs with:

Desktop videos:

Notes, Tasks, Habits

Search, Settings

Desktop screenshots:

Phone screenshots:

Media gallery

1 / 3

Install Openhabittracker on Unraid in a few clicks.

Find Openhabittracker in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Openhabittracker Review the template variables and paths Click Install

Requirements

A password and a JWT secret must be set before the first start.

Categories

Download Statistics

6,076
Total Downloads

Related apps

Explore more like this

Explore all

Details

Repository
jinjinov/openhabittracker:latest
Last Updated2026-07-10
First Seen2026-07-13

Runtime arguments

Web UI
http://[IP]:[PORT:8080]
Network
bridge
Shell
bash
Privileged
false

Template configuration

WebUI PortPorttcp

Host port for the web interface.

Target
8080
Default
5050
AppdataPathrw

SQLite data: notes, tasks, habits, settings.

Target
/app/.OpenHabitTracker
Default
/mnt/user/appdata/openhabittracker
UsernameVariable

Login username for the single user.

Target
AppSettings__UserName
Default
admin
EmailVariable

Login email for the single user.

Target
AppSettings__Email
Default
admin@example.com
PasswordVariable

Login password for the single user.

Target
AppSettings__Password
JWT SecretVariable

Secret used to sign login tokens. Generate one in the Unraid terminal with: openssl rand -base64 32

Target
AppSettings__JwtSecret
TimezoneVariable

tz database name, e.g. Europe/Berlin - sets the day boundary for habit tracking.

Target
TZ
Default
Etc/UTC