> 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/auto-update.md).

# 자동 업데이트

Orbitron은 설치를 자동으로 최신 상태로 유지하는 내장 자동 업데이트 시스템을 포함합니다. 이 가이드에서는 자동 업데이트 시스템의 작동 방식과 구성 방법을 설명합니다.

## 🎯 주요 특징

### 기본 설정

* **기본값:** 자동 업데이트는 설치 시 대화형 선택지를 제공하며, 선택하지 않을 경우 기본적으로 **비활성화** (옵트인 방식)
* **사용자 제어:** 언제든지 활성화/비활성화 가능
* **안전한 업데이트:** 백그라운드에서 다운로드하고 다음 실행 시 적용

### 업데이트 프로세스

1. **자동 확인:** 6시간마다 새 버전 확인 (활성화 시)
2. **백그라운드 다운로드:** 새 버전이 있으면 자동으로 다운로드
3. **다음 실행 시 적용:** 다운로드된 버전은 다음에 Orbitron을 실행할 때 자동으로 적용
4. **중단 없음:** 현재 작업을 방해하지 않음

## ⚙️ 자동 업데이트 구성

### CLI 명령어로 설정

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

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

# 현재 설정 확인
orbitron config get autoUpdate

# 모든 설정 확인
orbitron config list
```

### 환경 변수로 설정 (임시)

환경 변수를 사용하여 임시로 자동 업데이트를 제어할 수 있습니다:

```bash
# 자동 업데이트 활성화 (현재 세션만)
export ORBITRON_AUTO_UPDATE=true

# 자동 업데이트 비활성화 (현재 세션만)
export ORBITRON_AUTO_UPDATE=false
```

### 우선순위

자동 업데이트 설정은 다음 순서로 적용됩니다:

1. `ORBITRON_AUTO_UPDATE` 환경 변수 (최우선)
2. `~/.orbitron.json` 파일의 `autoUpdate` 설정
3. 설치 방법에 따른 기본값

## 🔒 안전한 업데이트

Orbitron은 안전한 업데이트를 위해 다음을 보장합니다:

* **검증된 다운로드:** 모든 바이너리는 체크섬으로 검증되어 안전성을 보장합니다
* **충돌 방지:** 동시에 여러 업데이트가 실행되지 않도록 자동으로 관리합니다
* **자동 롤백:** 업데이트 실패 시 이전 버전을 유지합니다

## 🚨 중요 업데이트 알림

중요한 보안 패치나 필수 업데이트가 있을 경우, Orbitron 실행 시 업데이트 알림이 표시되고 **프로그램이 자동으로 종료**됩니다:

```bash
$ orbitron

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Critical Update Required
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

New version v0.1.13 has been released.
This update includes critical security patches.

Update with the following command:

# Automated installation (recommended)
curl -fsSL https://orbitron.megaone.com/api/install.sh | bash

[Program will automatically terminate]
```

**중요:**

* 중요 업데이트 알림의 경우, 해당 버전의 Orbitron은 업데이트를 완료하기 전까지 실행할 수 없습니다
* 업데이트 후 정상적으로 사용할 수 있습니다

## 🔄 `/update` 커맨드로 수동 업데이트

Orbitron의 대화형 모드에서 `/update` 커맨드를 사용하여 수동으로 업데이트를 확인하고 설치할 수 있습니다:

### 사용법

```
/update
```

### 작동 방식

`/update` 커맨드는 필요에 따라 업데이트를 확인하고 설치합니다:

1. **버전 확인**: 사용 가능한 최신 버전 확인 (6시간 쿨다운 무시)
2. **스마트 감지**: 세 가지 가능한 상태 식별:
   * 이미 최신 버전
   * 업데이트가 이미 다운로드됨 (재시작 시 적용 준비 완료)
   * 다운로드 가능한 새 업데이트
3. **백그라운드 다운로드**: 작업을 방해하지 않고 비동기로 업데이트 다운로드
4. **재시작 시 적용**: 다운로드된 업데이트는 다음에 Orbitron을 실행할 때 적용됨

### 업데이트 메시지

| 상태           | 메시지                                                          | TTL    |
| ------------ | ------------------------------------------------------------ | ------ |
| **이미 최신**    | "Already on the latest version"                              | 2초     |
| **이미 다운로드됨** | "Update v{version} is already downloaded. Restart to apply." | 지속적    |
| **다운로드 중**   | "Downloading update v{version}..."                           | 최대 10분 |
| **다운로드 완료**  | "Update completed: v{version}. Restart to use new version."  | 2초     |

### 기술적 세부사항

`/update` 커맨드는:

* 즉시 버전 확인 강제 실행 (쿨다운 기간 무시)
* 파일 기반 잠금으로 동시 업데이트 방지
* SHA256 체크섬으로 다운로드 검증
* 플랫폼별 설치 지원

## 🛠️ 문제 해결

### 자동 업데이트가 작동하지 않는 경우

1. **자동 업데이트가 활성화되어 있는지 확인:**

   ```bash
   orbitron config get autoUpdate
   ```
2. **`/update` 커맨드로 수동 업데이트 시도:**
   * Orbitron을 대화형 모드로 실행
   * `/update`를 입력하고 Enter 키 누르기
   * 다운로드가 완료될 때까지 대기
   * Orbitron을 재시작하여 업데이트 적용
3. **설치 스크립트로 수동 업데이트:**

   ```bash
   # 최신 버전 설치
   curl -fsSL https://orbitron.megaone.com/api/install.sh | bash
   ```

## 🔗 관련 문서

* [설치 가이드](https://github.com/AlphaCode-AI/orbitron-docs/tree/main/docs/ko/user-guide/installation/README.md) - Orbitron 설치 방법
* [마이그레이션 가이드](/orbitron-docs/documentation/ko/user-guide/installation/migration-guide.md) - 레거시 버전에서 업그레이드
* [문제 해결](/orbitron-docs/documentation/ko/user-guide/installation/troubleshooting.md) - 일반적인 문제 및 해결 방법