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

# 설치

> ParalleLane 설치와 설치 후 자동 업데이트·커맨드 라인 도구 설정

ParalleLane을 설치하기 위한 시스템 요건과, 설치한 뒤 알아 두면 좋은 자동 업데이트·커맨드 라인 도구를 안내합니다.

<Note>
  다운로드 링크는 준비 중입니다. 현재 배포 형태는 **macOS용 DMG 하나**이며, 이 페이지의 설치·업데이트·커맨드 라인 안내도 모두 macOS를 기준으로 합니다.
</Note>

## 시스템 요건

<CardGroup cols={2}>
  <Card title="macOS" icon="monitor">
    Tauri 2와 시스템 웹뷰로 만든 네이티브 앱이며, 배포 형태는 macOS용 DMG입니다. DMG를 열어 앱을 응용 프로그램 폴더에 넣어 두세요.
  </Card>

  <Card title="Git (필수)" icon="git-branch">
    ParalleLane은 읽기 작업(커밋 그래프·diff·blame·상태 조회)은 내장 libgit2로 처리하지만, 쓰기 작업(체크아웃·커밋·푸시 등)은 시스템에 설치된 `git` 명령을 실행합니다. 터미널에서 `git --version` 이 동작하는지 확인하세요.
  </Card>
</CardGroup>

## 설치 후: 자동 업데이트

ParalleLane은 macOS에서 새 버전을 스스로 확인합니다. 앱을 켠 뒤 약 6초가 지났을 때 한 번, 그다음에는 6시간마다 백그라운드에서 조용히 확인합니다. 시작 직후를 피하는 것은 저장소 스캔과 그래프 스트리밍이 몰리는 구간을 비켜 주기 위한 것입니다.

<Steps>
  <Step title="알림 토스트가 뜹니다">
    새 버전을 찾으면 새 버전 번호와 함께 **ParalleLane … 사용 가능** 이라는 토스트가 우측 하단에 나타납니다. **자세히(Details)** 를 누르면 업데이트 다이얼로그가 열립니다. 같은 버전에 대한 알림은 24시간 동안 다시 뜨지 않습니다.
  </Step>

  <Step title="업데이트 다이얼로그에서 확인합니다">
    **업데이트 사용 가능** 다이얼로그에는 **새 버전** 번호와 **릴리스 노트 보기** 버튼이 있습니다. **설치하고 재시작**을 누르면 다운로드 진행률이 표시되고, 설치를 마치기 위해 앱이 다시 시작됩니다.
  </Step>

  <Step title="필요하면 직접 확인합니다">
    **설정 → ParalleLane → 일반(General)** 의 **업데이트(Updates)** 항목에서 현재 버전과 마지막 확인 시각을 볼 수 있고, **업데이트 확인** 버튼으로 즉시 확인할 수 있습니다. 새 버전이 이미 발견된 상태라면 그 옆에 **업데이트 설치** 버튼이 함께 나타나 다이얼로그를 다시 엽니다. **자동으로 업데이트 확인** 토글을 끄면 백그라운드 확인을 멈춥니다.
  </Step>
</Steps>

<Note>
  백그라운드 자동 확인이 실패해도 아무 알림이 뜨지 않습니다. 오프라인 상태에서 6시간마다 오류를 보여 주지 않기 위한 것으로, 오류 메시지는 직접 **업데이트 확인**을 눌렀을 때만 표시됩니다.
</Note>

<Warning>
  설치가 계속 실패한다면 ParalleLane을 응용 프로그램 폴더로 옮긴 뒤 다시 시도하세요. 앱 번들에 쓰기 권한이 없는 위치에서는 업데이트 설치가 막힐 수 있습니다.
</Warning>

## 커맨드 라인 도구

터미널에서 저장소를 바로 열고 싶다면 `parallelane` 명령을 설치할 수 있습니다.

<Steps>
  <Step title="명령을 설치합니다">
    **설정 → ParalleLane → 일반(General)** 의 **커맨드 라인(Command line)** 항목에서 **설치(Install)** 를 누릅니다. macOS 상단 메뉴 바의 **파일(File) → 커맨드 라인 도구 설치** 를 고르면 이 설정 화면이 바로 열립니다. 설치 위치에 관리자 권한이 필요하면 시스템 인증 창이 나타납니다.
  </Step>

  <Step title="터미널에서 저장소를 엽니다">
    터미널에서 `parallelane .` 처럼 실행하면 그 경로가 속한 저장소의 최상위 폴더가 ParalleLane에서 열립니다. 경로를 생략하면 현재 폴더를 사용하고, Git 저장소가 아니면 오류를 내고 끝납니다.
  </Step>
</Steps>

설치가 끝나면 같은 버튼의 라벨이 **제거(Uninstall)** 로 바뀌고, 다시 누르면 명령을 지웁니다. 버튼 아래 줄에는 **설치됨 · 경로** 또는 **미설치** 가 표시됩니다.

<Warning>
  설치된 명령은 그 시점의 앱 번들 위치를 가리킵니다. ParalleLane을 다른 폴더로 옮긴 뒤에는 다시 설치하세요. 커맨드 라인 도구 설치는 macOS에서만 지원됩니다.
</Warning>

## 다음 단계

<CardGroup cols={2}>
  <Card title="빠른 시작" icon="rocket" href="/quickstart">
    온보딩부터 첫 커밋까지 가장 짧은 경로를 따라가 봅니다.
  </Card>

  <Card title="화면 둘러보기" icon="layout-dashboard" href="/interface-overview">
    주요 화면 영역이 각각 무슨 역할을 하는지 살펴봅니다.
  </Card>
</CardGroup>