pinn-shost/pinn

가족 조직 관리를 위해 내 NAS에 Docker로 설치하는 웹 앱

완성 앱맘대로 써도 됨 · MIT데브옵스·인프라JavaScript난이도

620 찜

2포크1이슈

중간맛 분석

pinn.은 가족의 여러 일상 작업(공유 캘린더, 식사 계획, 쇼핑, 작업, 재정, 위치 공유)을 하나의 앱에서 처리하고 각 기기에 실시간 알림으로 전달합니다. 사용자가 자신의 NAS에 와 Compose 2.17 이상을 갖춘 뒤 제공된 설치 스크립트를 실행하면, PocketBase(데이터베이스), Caddy(HTTPS 자동 발급), Traccar(GPS 추적, 선택사항), Home Assistant 연동(선택사항) 등이 Compose로 자동 구성됩니다. 웹 설정 어시스턴트로 DuckDNS, WireGuard/Tailscale VPN, Google 캘린더/연락처, Gemini AI, 스마트홈을 4개 언어로 단계별 설정 가능하며, 오프라인 모드와 자동 동기화를 지원하고 야간 백업을 14일 보관합니다. 한 서버에 여러 가족을 등록하여 각각 독립된 데이터를 관리할 수 있습니다.

이런 레포예요

이럴 때 쓰면 좋아요

가족이 공유하는 iPad에 설치하여 일정, 작업, 식사, 날씨를 한 눈에 확인하기
각 가족 구성원의 폰에서 쇼핑 목록, 작업, 위치를 실시간으로 동기화하고 알림받기
같은 서버에 여러 가정을 설치하여 각각 독립된 데이터를 관리하고 선택적으로 레시피 공유하기

핵심 기능

공유 캘린더, 식사 계획, 쇼핑 목록 통합작업, 재정, 위치 공유, 스마트홈 연동오프라인 동기화, 푸시 알림, 다국어 지원

대안 대비 차별점

자신의 NAS에서만 실행되므로 클라우드 서비스 없이 가족 데이터를 집 안에만 완전히 보관할 수 있습니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

NAS 또는 Docker, Docker Compose 2.17+가 설치된 서버(amd64, arm64, armv7)
SSH 접속 권한
선택사항: DuckDNS 계정(HTTPS, 푸시 알림, 앱 설치용)

바로 차려먹기Docker Compose

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/pinn-shost/pinn.git &&
cd pinn &&
docker compose up

Docker가 필요해요 — 맥이라면 OrbStack(brew install --cask orbstack)을 추천해요.

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기

최신 릴리스 ZIP 다운로드 및 압축 해제 https://github.com/pinn-shost/pinn/releases/latest 에서 최신 버전 다운로드
NAS의 도커 폴더(예: /volume1/docker/Pocketbase/)에 압축 해제된 폴더 복사
SSH로 NAS에 접속하여 설치 스크립트 실행

cd /volume1/docker/Pocketbase && sudo sh pinn-*/pinn-setup.sh

웹브라우저에서 http://<NAS-IP>:8090 에 접속하여 관리자 기본 비밀번호 Admin으로 로그인 후 새 비밀번호 설정
설정 어시스턴트로 HTTPS, VPN, Google 캘린더, AI, 위치, Home Assistant 설정
각 폰의 웹브라우저에서 pinn. HTTPS 주소 접속 후 홈 화면에 추가 및 알림 활성화
- iPhone/iPad (Safari): 공유 → 홈 화면에 추가
- Android (Chrome): Chrome 메뉴 → 앱 설치