jofoerster/habitsync

これは何？

主な機能

• 01毎日・毎週・毎月・任意の間隔で行う習慣と、減らしたい習慣の記録
• 02ランキングと投票機能を備えた共有習慣と月間チャレンジ
• 03リマインダーやしきい値アラートなど、Apprise経由の通知
• 04複数のIssuerと任意のユーザー承認に対応したOIDC/SSOログイン
• 05ブラウザー上のPWAとして動作し、Androidアプリも利用可能
• 06Swaggerドキュメント付きREST APIと、Loop Habit Trackerからのデータインポート

ユースケース

• クラウドアプリではなく、自分のサーバーで習慣を記録する
• 友人や家族と習慣チャレンジのグループを運営する
• Apprise経由で習慣のリマインダーをDiscord、メール、Home Assistantに連携する
• REST APIを使って習慣データをHome Assistant環境に取り込む

クイックスタート

1. 1

   Dockerでアプリをローカル起動します

   docker run \ -p 6842:6842 \ -e BASE_URL=http://localhost:6842 \ -e 'APP_SECURITY_BASIC-AUTH-USERS_test=$2y$10$EyuJ.fL/PzCTMMKTONEquuFLxAR8SAzl9iXF2v.qDZYCh5K2m78fS' \ ghcr.io/jofoerster/habitsync:latest
2. 2

   http://localhost:6842 を開き、ユーザー名 test と README に記載されたパスワードでログインします

3. 3

   本番環境では、README に記載された Docker Compose のセットアップを使用します

使う前に知っておきたいこと

• !Androidアプリは開発中のため、サーバーのバージョンと同期させる必要があります。
• !v0.19.0でモバイルのOIDCリダイレクトURIが変更されたため、既存のモバイル環境では更新が必要になる場合があります。
• !APIは未完成で、変更される可能性があります。

収録されている特集

トピック

よくある質問

habitsync とは？

目標設定や友人とのチャレンジ、習慣の共有、OIDC/SSOログインに対応したセルフホスト型習慣トラッカー。PWAとAndroidアプリも利用できます。 HabitSyncは、毎日・毎週・毎月、または任意の間隔で行う習慣を設定できるセルフホスト型の習慣トラッカーです。減らしたい習慣も記録できます。Dockerでデプロイでき、ブラウザーでプログレッシブウェブアプリとして、またはAndroidアプリから利用できます。

habitsync は無料で使えますか？ライセンスは？

habitsync は BSD-3-Clause ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

habitsync は今もメンテナンスされていますか？

半年以内に更新あり。habitsync の最終コミットは 2026年8月20日 です。

habitsync は何に使えますか？

クラウドアプリではなく、自分のサーバーで習慣を記録する 友人や家族と習慣チャレンジのグループを運営する Apprise経由で習慣のリマインダーをDiscord、メール、Home Assistantに連携する REST APIを使って習慣データをHome Assistant環境に取り込む

habitsync のインストール方法は？

Dockerでアプリをローカル起動します: docker run \ -p 6842:6842 \ -e BASE_URL=http://localhost:6842 \ -e 'APP_SECURITY_BASIC-AUTH-USERS_test=$2y$10$EyuJ.fL/PzCTMMKTONEquuFLxAR8SAzl9iXF2v.qDZYCh5K2m78fS' \ ghcr.io/jofoerster/habitsync:latest http://localhost:6842 を開き、ユーザー名 test と README に記載されたパスワードでログインします 本番環境では、README に記載された Docker Compose のセットアップを使用します

habitsync はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/jofoerster/habitsync