> For the complete documentation index, see [llms.txt](https://orbitron.gitbook.io/orbitron-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbitron.gitbook.io/orbitron-docs/documentation/ko/user-guide/installation.md).

# 설치

Orbitron Context는 운영 체제와 아키텍처에 맞는 바이너리를 자동 설치 스크립트 또는 수동 다운로드를 통해 쉽게 설치할 수 있습니다. 이 섹션에서는 macOS, Linux, Windows 사용자를 위한 다양한 설치 방법을 제공합니다.

최신 빌드는 [Orbitron 다운로드 페이지](https://orbitron.megaone.com/download)에서도 찾을 수 있습니다.

<figure><img src="/files/RfGW0i8dRQPYVY7hojiH" alt=""><figcaption></figcaption></figure>

## 🚀 빠른 설치 (권장)

자동 설치 스크립트를 사용하면 가장 빠르고 쉽게 시작할 수 있습니다:

### 🖥 macOS / 🐧 Linux

```bash
curl -fsSL https://orbitron.megaone.com/api/install.sh | bash
```

### 🪟 Windows (PowerShell)

```powershell
irm https://orbitron.megaone.com/api/install.ps1 | iex
```

### ✨ 자동 설치 스크립트의 기능

자동 설치 스크립트는 다음을 자동으로 처리합니다:

1. **감지** - 운영 체제와 아키텍처를 자동으로 감지
2. **다운로드** - 최신 Orbitron 바이너리를 다운로드
3. **설치** - `~/.local/bin/orbitron`에 버전 관리와 함께 설치
4. **PATH 구성** - 셸 PATH를 자동으로 구성
5. **자동 업데이트 설정** - 자동 업데이트 활성화 여부를 대화형으로 선택 (선택사항)
6. **레거시 마이그레이션** - 이전 설치가 감지되면 마이그레이션 제안 (사용자 승인 필요)

설치가 완료된 후 터미널을 재시작하고 확인하세요:

```bash
orbitron --help
```

> **참고:** 이전 버전이 설치된 경우, 설치 프로그램이 자동으로 감지하고 대화형 마이그레이션을 제공합니다. 자세한 내용은 [마이그레이션 가이드](/orbitron-docs/documentation/ko/user-guide/installation/migration-guide.md)를 참조하세요.

## 📦 수동 다운로드 (비권장)

바이너리를 직접 다운로드하여 원하는 위치에서 실행할 수도 있습니다.

> **선택적 설정**: 다운로드 후 `./orbitron install`을 실행하면 자동 업데이트 지원 및 자동 PATH 설정을 활성화할 수 있습니다. 이 단계는 선택사항이지만 권장됩니다.

### 🖥 macOS

#### Apple Silicon (M1, M2, M3, M4)

```bash
curl -L -o orbitron https://d160u887c48md2.cloudfront.net/latest/orbitron-macos-arm64
chmod +x orbitron

# 선택사항: 자동 업데이트 지원 활성화
./orbitron install
```

#### Intel (x86\_64)

```bash
curl -L -o orbitron https://d160u887c48md2.cloudfront.net/latest/orbitron-macos-x86_64
chmod +x orbitron

# 선택사항: 자동 업데이트 지원 활성화
./orbitron install
```

### 🐧 Linux

#### AMD64 (x86\_64)

```bash
curl -L -o orbitron https://d160u887c48md2.cloudfront.net/latest/orbitron-linux-x86_64
chmod +x orbitron

# 선택사항: 자동 업데이트 지원 활성화
./orbitron install
```

#### ARM64 (예: Raspberry Pi, ARM 기반 서버)

```bash
curl -L -o orbitron https://d160u887c48md2.cloudfront.net/latest/orbitron-linux-arm64
chmod +x orbitron

# 선택사항: 자동 업데이트 지원 활성화
./orbitron install
```

### 🪟 Windows

```powershell
Invoke-WebRequest -Uri "https://d160u887c48md2.cloudfront.net/latest/orbitron-windows-x86_64.exe" -OutFile "orbitron.exe"

# 선택사항: 자동 업데이트 지원 활성화
.\orbitron.exe install
```

### ✅ 설치 확인

다운로드 후 실행하여 설치를 확인하세요:

```bash
# Unix/Linux/macOS
./orbitron --help

# Windows
.\orbitron.exe --help
```

***

## 🔄 자동 업데이트

> **지원 버전:** v0.1.13 이상

Orbitron은 설치를 자동으로 최신 상태로 유지하는 내장 자동 업데이트 시스템을 포함합니다.

### 주요 특징

* **기본값:** 자동 업데이트는 설치 시 대화형 선택지를 제공하며, 선택하지 않을 경우 기본적으로 비활성화
* **확인 빈도:** 활성화 시 6시간마다 자동 확인
* **업데이트 방법:** 백그라운드에서 다운로드 후 다음 실행 시 자동으로 업그레이드된 버전으로 교체되어 실행

### 자동 업데이트 활성화/비활성화

```bash
# 자동 업데이트 활성화
orbitron config set autoUpdate true

# 자동 업데이트 비활성화
orbitron config set autoUpdate false

# 현재 설정 확인
orbitron config get autoUpdate
```

자세한 내용은 [자동 업데이트 가이드](/orbitron-docs/documentation/ko/user-guide/installation/auto-update.md)를 참조하세요.

***

## 🎯 플랫폼 지원 요약

| 플랫폼     | 아키텍처    | 바이너리 이름                       | 자동 업데이트 |
| ------- | ------- | ----------------------------- | ------- |
| macOS   | ARM64   | `orbitron-macos-arm64`        | ✅       |
| macOS   | x86\_64 | `orbitron-macos-x86_64`       | ✅       |
| Linux   | ARM64   | `orbitron-linux-arm64`        | ✅       |
| Linux   | x86\_64 | `orbitron-linux-x86_64`       | ✅       |
| Windows | x86\_64 | `orbitron-windows-x86_64.exe` | ✅       |

***

## ✅ 다음 단계

설치가 완료되면 다음 명령어로 Orbitron 사용을 시작할 수 있습니다:

```bash
orbitron --help
```

빠르게 시작하려면:

```bash
# Orbitron 로그인
orbitron login

# 프로젝트에서 Orbitron 사용
cd /path/to/your/project
orbitron
```