> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 데스크톱 앱 설치

> macOS · Windows · Linux 다운로드, 사전 조건, 그리고 첫 실행에 한 번 뜨는 서명 프롬프트.

데스크톱 앱은 Nora 를 macOS · Windows · Linux 의 네이티브 창으로 감쌉니다. Docker 스택 관리는 앱이 대신 처리하고, 스택이 뜨는 즉시 Nora SPA 로 넘어갑니다. 별도 브라우저 탭도, `docker compose` 를 외울 필요도 없습니다.

## 다운로드

플랫폼 릴리스 페이지에서 최신 빌드를 받고 사용하는 플랫폼의 파일을 선택하세요.

| 플랫폼 | 파일 | 대략 크기 |
| - | - | - |
| macOS (Apple Silicon) | `Nora-macos-arm64-*.dmg` | \~40 MB |
| macOS (Intel) | `Nora-macos-x64-*.dmg` | \~40 MB |
| Windows 10 / 11 | `Nora-windows-x64-*.msi` | \~50 MB |
| Linux (x86\_64) | `Nora-linux-x64-*.AppImage` | \~70 MB |

<Note>
  현재 빌드는 **서명이 없습니다**. 바이너리 자체는 정상이지만 OS 가 첫 실행에 한 번 물어봅니다. 아래 플랫폼별 안내대로 처리하면 이후에는 뜨지 않습니다.
</Note>

## 사전 조건

앱을 실행하기 전에 호스트가 아래 조건을 만족해야 합니다.

* **Docker.** macOS · Windows 는 Docker Desktop, Linux 는 Docker Engine + Compose plugin 이 필요합니다. 앱이 `docker compose` 를 대신 호출하므로 Docker 설치가 필수입니다. [Docker 다운로드](https://docs.docker.com/get-docker/) 를 참고하세요.
* **디스크 여유 약 15 GB.** 컨테이너 이미지와 Postgres 데이터 볼륨을 담을 공간이 필요합니다.
* **Docker 에 4 GB RAM 이상 할당.** 백그라운드에서 플로우를 계속 돌릴 예정이면 8 GB 가 편안합니다.

## 첫 실행

<Tabs>
  <Tab title="macOS">
    1. `.dmg` 를 열고 `Nora.app` 을 **응용 프로그램** 폴더로 드래그합니다.
    2. **응용 프로그램** 에서 `Nora.app` 을 우클릭하고 **열기** 를 선택합니다.
    3. macOS 가 *"macOS 가 Nora 개발자를 확인할 수 없습니다"* 를 띄우면 **열기** 를 누릅니다.
    4. macOS 14 이상에서는 우클릭 방식이 여전히 막힐 수 있습니다. 그럴 때는:
       * **시스템 설정 → 개인정보 보호 및 보안** 을 엽니다.
       * 아래로 스크롤해 *"Nora 가 Mac 보호를 위해 차단되었습니다"* 옆의 **그래도 열기** 를 누릅니다.
       * 대화상자가 다시 뜨면 **열기** 를 누릅니다.
    5. 이후부터는 더블클릭으로 정상 실행됩니다.
  </Tab>

  <Tab title="Windows">
    1. `.msi` 를 더블클릭합니다. 인스톨러가 `Nora.exe` 를 시작 메뉴와 `%LOCALAPPDATA%\Nora` 에 배치합니다.
    2. 첫 실행에서 Windows Defender SmartScreen 이 *"Windows가 PC를 보호했습니다"* 를 띄웁니다.
    3. **추가 정보** 를 누른 뒤 **실행** 을 누릅니다.
    4. 이후 실행은 프롬프트를 건너뜁니다.
  </Tab>

  <Tab title="Linux">
    AppImage 에 실행 권한을 주고 바로 실행합니다.

    ```bash theme={null}
    chmod +x Nora-linux-x64-*.AppImage
    ./Nora-linux-x64-*.AppImage
    ```

    Linux 는 서명 프롬프트가 뜨지 않습니다. Dock · 메뉴 아이콘을 원한다면 [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) 로 자동 통합할 수 있습니다.
  </Tab>
</Tabs>

## 어디에 무엇이 놓이나

앱이 뜨면 호스트에 몇 가지 파일이 자리를 잡습니다.

* **앱 바이너리** 는 macOS 라면 `/Applications/Nora.app`, Windows 라면 `%LOCALAPPDATA%\Nora`, Linux 라면 AppImage 를 저장한 위치입니다.
* **Docker 스택 설정** 은 `~/.nora/onprem/` 아래에 자리를 잡습니다. 첫 실행에서 앱이 `docker-compose.yml` 과 `.env.onprem` 을 이 위치에 씁니다. Postgres 비밀번호는 앱이 임의값으로 생성해 넣어 두므로 \[Install Nora] 버튼을 누르기 전에 수동 편집이 필요하지 않습니다.
* **Docker 볼륨** 은 `nora-onprem_pgdata` 와 `nora-onprem_qdrantdata` 입니다. 표준 Docker 볼륨이라 `docker volume ls` 에 보입니다.
* **컨테이너 이미지** 는 첫 설치에서 기본 Docker 이미지 스토어로 pull 됩니다.

## 다음

<CardGroup cols={2}>
  <Card title="첫 실행" icon="wand-magic-sparkles" href="/ko/local-app/desktop/first-launch">
    설치 마법사, 트레이 아이콘, SPA 로의 이양 흐름을 따라갑니다.
  </Card>

  <Card title="Settings" icon="sliders" href="/ko/local-app/desktop/settings">
    라이선스 키, 호스트 포트, 리셋, 언인스톨.
  </Card>

  <Card title="업데이트" icon="arrows-rotate" href="/ko/local-app/desktop/updates">
    업데이트 확인과 오프라인 tarball import.
  </Card>

  <Card title="Docker Compose" icon="docker" href="/ko/local-app/deploy/compose">
    같은 compose 파일을 서버에서 직접 실행합니다.
  </Card>
</CardGroup>