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로 배포한 뒤 브라우저에서 progressive web app으로 사용하거나 Android 앱으로 이용할 수 있습니다.

habitsync은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

habitsync은(는) BSD-3-Clause 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

habitsync은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. 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