TL;DR

  • Ontoplano는 작은 작업부터 레시피·재고·메모·청구서까지 노트북별로 정리하는 개인 생활의 중앙 허브임.
  • 휴대전화에서 한 손으로 작업이나 메모를 추가할 수 있을 만큼 간단하며, AI 에이전트 연결은 선택 사항임.
  • 자체 호스팅은 개발 서버, Docker, systemd 서비스, Debian·RPM·Arch 패키지, Android 경로를 제공하며 Windows에서는 WSL을 사용함.
  • 첫 계정이 인스턴스 소유자가 되며, 이후 가입은 /settings/instance에서 설정을 바꾸기 전까지 닫힘.
  • 2026년 9월 5일 공개된 소프트웨어로, 아직 성숙 단계이며 버그가 있을 수 있고 개발 과정에서 LLM 출력을 검토·테스트함.

Ontoplano

  • 표어는 “한 번의 인생, 하나의 앱”이며, ontoplano.com은 공식 인스턴스임. 문서와 .deb, .rpm, Arch, Docker, Android 배포 경로가 제공됨.
  • 소프트웨어 공개일은 2026년 9월 5일이며, 아직 성숙 단계라 버그가 있을 수 있음. 개발 과정에서 LLM을 광범위하게 사용하고, 결과물은 반영 전에 검토하고 테스트함.
  • 문제 제기와 코드 변경 제안은 GitHub 이슈와 풀 리퀘스트를 통해 제출할 수 있음.

요약

  • Ontoplano는 생활을 정리하는 중앙 허브로, 세부 사항을 다룰 만큼 강력하면서도 휴대전화에서 한 손 동작으로 작업이나 메모를 추가할 만큼 간단함.
  • AI 에이전트에 연결하거나 연결하지 않을 수 있으며, 작업·레시피·재고·메모·청구서 등을 각각 특정 노트북으로 분류할 수 있음.

실행

  • 로컬 인스턴스의 설정은 ~/.config/ontoplano/, 데이터베이스는 ~/.local/share/ontoplano/에 저장됨.
  • 저장소를 복제하고 yarn으로 의존성을 설치한 뒤 yarn dev를 실행하면 http://localhost:1493에서 개발 서버가 구동됨. 개발 계정용 합성 데이터는 선택적으로 make db-seed로 생성할 수 있음.
  • make install-service를 실행해 systemd 서비스를 설치할 수 있음.
  • Docker 실행 시 컨테이너 이름은 ontoplano, 포트 매핑은 1493:1493, 데이터 볼륨은 ontoplano-data:/data로 설정됨. ORIGIN은 http://localhost:1493으로 지정하고, BETTER_AUTH_SECRET은 openssl rand -base64 32로 생성한 값으로 설정하며 이미지는 ontoplano/ontoplano:latest를 사용함.
  • /login에서 가입하며, 첫 계정이 인스턴스의 소유자가 됨. 이후 가입은 /settings/instance에서 설정을 변경하기 전까지 닫힘.
  • 알림 타이머가 설치에 포함됨.

바이너리

  • Debian·Ubuntu·Mint·Pop!_OS에서는 내려받은 .deb 파일을 sudo apt install ./ontoplano_*_amd64.deb로 설치함.
  • Fedora·RHEL·openSUSE에서는 .rpm 파일을 sudo dnf install ./ontoplano-*.x86_64.rpm로 설치함.
  • Arch·Manjaro에서는 아직 AUR 패키지가 제공되지 않음. 디렉터리를 만들고 PKGBUILD와 ontoplano.install을 내려받은 뒤 makepkg -si로 설치함.
  • 설치 후 sudo ontoplano config로 origin을 설정하고 sudo systemctl enable --now ontoplano로 서비스를 활성화함.
  • .deb와 .rpm은 릴리스 페이지에 있으며 자체 Node를 포함하므로 별도 설치 항목이 없음. 패키지 설치의 설정은 /etc/ontoplano/, 데이터베이스는 /var/lib/ontoplano/에 저장됨.
  • Windows 설치 프로그램은 아직 없음.

Windows

  • PowerShell에서 wsl --install -d Ubuntu를 실행해 Ubuntu용 WSL을 설치함. 재부팅 요청이 있으면 재부팅한 뒤 시작 메뉴에서 Ubuntu를 열고, 그 안에서 sudo apt update, Node.js·npm·Git 설치, 전역 Yarn 설치, 저장소 복제, yarn, yarn dev 순으로 실행함. 복제 주소는 https://github.com/ontoplano/ontoplano.git임.
  • Windows에서 http://localhost:1493을 열면 WSL이 포트를 전달하므로 기존 브라우저로 접속할 수 있음.
  • 이 경로에는 systemd가 없으며, 부팅 시 자동 실행되지 않음. make dev와 ontoplano 서비스 명령은 적용되지 않고, 앱을 실행하려면 yarn dev가 동작하는 터미널을 열어 둬야 함. 터미널을 닫으면 앱이 중지됨.
  • 데이터·설정·업그레이드는 다른 환경과 같은 방식으로 동작하며, WSL 내부 Linux 홈 디렉터리에 저장됨. 파일 탐색기에서는 \\wsl$\Ubuntu\home\<you> 경로로 접근함.
  • 코드 기여 방법은 CONTRIBUTING.md에 안내됨.

배포

  • 소스에서 설치한 뒤 서비스를 계속 실행하는 방식으로 배포함.
  • ~/.config/ontoplano/env에 ORIGIN=https://ontoplano.example.com과 BETTER_AUTH_SECRET을 설정함. ORIGIN은 공개 origin이어야 하며, 그렇지 않으면 CSRF 검사로 모든 양식 요청이 거부됨. 비밀 값은 openssl rand -base64 32로 생성함.
  • make install-service는 빌드·마이그레이션·서비스와 알림 설치를 수행함. 변경 후 make deploy-local은 다시 빌드하고 재배포한 뒤 서비스를 재시작함. SMTP를 사용하는 경우 주간 메일 서비스는 make install-mail-service로 설치함.
  • TLS를 종료하는 리버스 프록시 뒤에서 127.0.0.1에 바인딩하고, /healthz를 확인하는 대상을 설정함.
  • 전체 설정 목록은 docs/reference/configuration.md, 백업 안내는 docs/BACKUP.md, 휴대전화 안내는 docs/ANDROID.md에 있음.
  • 로그인에는 주소와 비밀번호를 사용함. 이메일은 선택 사항이며, SMTP 설정이 없으면 확인 및 재설정 링크가 이메일로 전송되지 않고 서버 로그에 기록됨.

후원