~/.nora/onprem/.env.onprem 에 쓰이고, 값이 실제로 바뀐 경우에만 스택이 재시작됩니다.
필드
라이선스 키
유료 라이선스 활성화 문자열입니다. 값이 비어 있으면 워크스페이스는 free tier — 워크스페이스 1개, 플로우 3개, 하루 100회 실행 — 로 돕니다.- 값은
.env.onprem에NORA_LICENSE_KEY로 저장됩니다. - 다음 서버 start 에서 반영됩니다. 값이 바뀐 상태로 [Save + Restart] 를 누르면 앱이 stop → start 를 대신 실행합니다.
- 완전 오프라인 설치에서는 대신
NORA_LICENSE_FILE(라이선스 JSON 파일 경로) 을 사용합니다. 오프라인 라이선스 흐름은 에어갭 tarball 을 참고하세요.
호스트 포트
Nora 인스턴스가 listen 할 TCP 포트입니다. 기본값은8090 입니다.
- 값은
.env.onprem에NORA_HOST_PORT로 저장되고nora-server컨테이너의 포트 맵에 적용됩니다. - 이미
8090이 점유되어 있거나 Nora 인스턴스를 두 개 나란히 돌리고 싶을 때 바꿉니다. - 포트를 바꾸면 스택이 stop → start 됩니다. SPA · API 가 새 포트로 이동하고, MCP 링크는 새
NORA_PUBLIC_URL을 기준으로 재생성됩니다.
액션
Save + Restart
위 필드 값을.env.onprem 에 씁니다. 스택이 이미 떠 있으면 앱이 stop → start 를 실행해 새 값을 즉시 반영합니다.
Reset (drop data)
파괴적입니다. Postgres 와 Qdrant 볼륨이 드랍되어 워크스페이스, 사용자, 플로우, 메모리, 리트리벌 인덱스가 모두 사라집니다. 설정 (.env.onprem, docker-compose.yml) 은 보존되므로 다음 start 는 같은 형태로 부팅됩니다.
- 버튼은 확인 상자에
reset을 입력해야 실행됩니다. 되돌릴 수 없습니다. - Docker 이미지는 데몬의 이미지 스토어에 그대로 남습니다. 마운트된 볼륨만 드랍합니다.
Uninstall
전체 해체입니다. 모든 컨테이너를 stop 하고 볼륨을 드랍하고 Nora 소유 이미지를 제거하고~/.nora/onprem/ 을 삭제한 뒤 앱을 종료합니다.
- 버튼은 확인 상자에
uninstall을 입력해야 실행됩니다. 되돌릴 수 없습니다. .app번들 자체는 디스크에 남으므로 macOS 는 휴지통으로, Windows 는 앱 및 기능 으로 마무리합니다.- 데스크톱 프로세스는 응답이 UI 에 닿은 뒤 약 400 ms 지나 종료되므로 앱이 스스로 닫히는 모습이 보입니다. 이 구간에 강제 종료하지 마세요.
- 번들된
postgres,redis,qdrant이미지는 다른 프로젝트가 공유할 수 있어 그대로 남깁니다. 디스크 회수는docker image prune로 처리합니다.
설정 파일 위치
앱이 호스트에 지속시키는 모든 값은~/.nora/onprem/ 아래에 있습니다.
두 파일 모두 변경은 다음 스택 start 에 적용됩니다. 트레이의 [Restart stack] 이 가장 빠른 적용 방법입니다.
다음
업데이트
업데이트 확인과 오프라인 tarball import.
에어갭 tarball
오프라인 설치와
NORA_LICENSE_FILE 흐름.