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

# 앱 업데이트

> 데스크톱 앱이 새 버전을 확인하고, 다운로드하고, 설치하는 방식을 설명합니다. 업데이트 진입점, 각 상태와 실패 처리, 재시작 규칙, 자동 확인과 자동 다운로드 스위치를 다룹니다.

**앱 업데이트**는 데스크톱 앱에만 적용됩니다. 기본적으로 앱은 새 버전을 자동으로 확인하고 백그라운드에서 다운로드한 다음, 설치를 완료하도록 재시작을 안내합니다. 언제든지 수동으로 확인하거나, 자동 다운로드나 자동 확인을 끌 수도 있습니다. 웹 앱에는 업데이트 진입점이 없습니다. 페이지를 새로 고치면 최신 버전을 불러옵니다.

## 적용 범위

| 형태 | 지원 | 비고 |
| - | - | - |
| 데스크톱 앱 | 지원 | 이 페이지의 모든 내용 |
| 웹 앱 / 모바일 웹 | 해당 없음 | 페이지를 새로 고치면 최신 버전을 불러옵니다 |

## 찾는 위치

다음 진입점은 같은 업데이트 상태를 공유합니다. 한곳에서 한 작업이 다른 곳에도 반영됩니다.

* **계정 메뉴**: **Appearance** 아래의 업데이트 행입니다. 기본적으로 **Check for updates** 와 현재 버전 번호가 표시됩니다.
* **아이콘 바 업데이트 버튼**: 아이콘 바 하단, 아바타 위에 있습니다. 업데이트가 있거나, 다운로드 중이거나, 다운로드에 실패했거나, 재시작을 기다리는 경우에만 나타납니다.
* **Settings › General › Updates**: 두 개의 스위치와 버전 상태.
* **명령 메뉴**: **Check for updates** 를 검색합니다.

## 수동으로 업데이트 확인

1. 계정 메뉴에서 **Check for updates** 를 클릭합니다(또는 **Settings › General › Updates** 에서 **Check for updates** 를 클릭합니다).
2. 확인이 끝나면:
   * 이미 최신 버전: **Up to date · vX.Y.Z** 가 표시됩니다.
   * 새 버전 발견: 자동 다운로드가 켜져 있으면 바로 백그라운드에서 다운로드합니다. 그렇지 않으면 진입점이 **Update available** 로 바뀌어 클릭하여 다운로드하기를 기다립니다.
   * 확인 실패: **Could not check for updates. Check your network and try again** 이 표시되고, 진입점이 **Retry update check** 로 바뀝니다.

## 다운로드와 설치

1. 진입점에 **Update available** 이 표시되면 클릭하여(설정에서는 버튼이 **Download and install**) 다운로드를 시작합니다. 각 진입점에 다운로드 진행률이 표시됩니다.
2. 다운로드가 끝나면 **vX.Y.Z downloaded. Restart to finish updating** 이 표시되고, 모든 진입점이 **Restart to update** 로 바뀝니다. 앱은 자동으로 재시작하지 않습니다.
3. **Restart to update** 를 클릭하면 확인 대화 상자가 열립니다.
   * 이 컴퓨터에서 실행 중인 로컬 작업 없음: **Later** 또는 **Restart now** 를 선택합니다.
   * 이 컴퓨터에서 아직 실행 중인 로컬 작업 있음: **Later** 또는 **Restart after tasks** 를 선택합니다.
4. 재시작 후 **Updated to 버전** 이 표시됩니다.

재시작은 클라우드 작업에 영향을 주지 않으며, 재시작 후에도 계속 표시됩니다.

### 이 컴퓨터의 작업이 끝난 후 재시작

**Restart after tasks** 를 선택하면:

* 설정에 기다리는 작업이 표시됩니다(예: **Waiting for “작업 제목” to finish**). 이 작업들이 모두 끝나면 앱이 자동으로 재시작하여 업데이트를 완료합니다.
* 기다리는 동안 **Cancel restart** 를 클릭할 수 있습니다. 업데이트는 다운로드된 상태로 유지되며, 나중에 **Restart to update** 를 다시 클릭할 수 있습니다.

## 규칙과 상태

| 상태 | 표시 내용 | 할 수 있는 작업 |
| - | - | - |
| 업데이트 있음 | **Update available** + 새 버전 번호. 아이콘 바 버튼에 알림 점이 있음 | 클릭하여 다운로드하고 설치 |
| 업데이트 필요 | 설정에 **Current vold is out of date. Update to vnew to keep using the app** 가 표시됨 | 빨리 다운로드하고 설치 |
| 다운로드 중 | 진행률 백분율, 클릭 불가 | 기다리기 |
| 다운로드 실패 | **Download failed · retry** | 네트워크를 확인하고 클릭하여 재시도 |
| 업데이트 준비 실패 | **Couldn’t prepare the update** · **Try again, or download the installer and install it manually** | **Retry** 를 클릭하여 다시 다운로드하거나, **Download manually** 를 클릭하여 설치 프로그램을 다운로드한 후 직접 설치 |
| 재시작 대기 | **Restart to update** | 재시작하거나 나중으로 미루기 |
| 로컬 작업 대기 | **Restart after tasks** | 자동 재시작을 기다리거나 **Cancel restart** |
| 재시작 실패 | **Restart failed. Try again or quit and reopen the app** | 다시 재시작하거나, 앱을 종료한 후 다시 열기 |

* **업데이트 필요**: 현재 버전이 최소 요구 버전보다 낮을 때 나타납니다. 인터페이스는 계속 사용할 수 있습니다. 빨리 업데이트하세요.
* **업데이트 준비 실패**: macOS에서 새 버전 다운로드가 끝난 후 오랫동안 설치 프로그램이 준비되지 않거나 준비에 실패하면 나타납니다(100%에 머무르지 않습니다). 자동 다운로드가 켜져 있으면 앱이 백그라운드에서 자동으로 재시도합니다.

## 자동 확인과 자동 다운로드

**Settings › General › Updates** 에는 두 개의 스위치가 있습니다.

| 스위치 | 기본값 | 설명 |
| - | - | - |
| Automatically check for updates | 켜짐 | 주기적으로 새 버전을 확인합니다 |
| Automatically download updates | 켜짐 | 백그라운드에서 새 버전을 다운로드하고, 완료되면 재시작을 안내합니다 |

| 조합 | 새 버전을 발견한 후 |
| - | - |
| 두 스위치 모두 켜짐(기본값) | 백그라운드에서 다운로드하고, 완료되면 재시작을 안내합니다 |
| 자동 확인만 켜짐 | 진입점이 **Update available** 로 바뀌며, 클릭하여 다운로드합니다 |
| 자동 확인 꺼짐 | **Automatically download updates** 는 회색으로 비활성화됩니다. 새 버전을 자동으로 찾지 않으므로 수동으로 확인하고 클릭하여 다운로드합니다 |

자동 확인을 다시 켜면 자동 다운로드는 이전 선택으로 돌아갑니다. 다운로드에 실패하면 앱이 백그라운드에서 자동으로 재시도합니다. **Check for updates** 나 **Download failed · retry** 를 클릭하면 언제든지 재시도할 수 있습니다.

## 참고 사항과 제한

* 업데이트는 데스크톱 앱 자체에만 영향을 줍니다. 클라우드 서버나 클라우드 작업에는 영향을 주지 않습니다.

## 자주 묻는 질문

### "Restart to update"를 클릭했을 때 왜 "Restart after tasks"만 선택할 수 있나요?

이 컴퓨터에서 아직 실행 중인 로컬 작업이 있습니다. 작업이 중단되지 않도록 앱은 작업이 끝날 때까지 기다린 후 자동으로 재시작합니다. **Cancel restart** 를 클릭하고 나중에 재시작할 수도 있습니다. 클라우드 작업에는 영향이 없습니다.

### 다운로드가 100%에서 멈춰 있으면 어떻게 하나요?

잠시 기다리세요. 그래도 설치 프로그램이 준비되지 않으면 **Couldn’t prepare the update** 가 표시됩니다. **Retry** 를 클릭하여 다시 다운로드하거나, **Download manually** 를 클릭하여 설치 프로그램을 다운로드한 후 직접 설치하세요.

### 다운로드에 실패하면 어떻게 하나요?

네트워크를 확인한 다음 **Download failed · retry** 를 클릭하세요.

### 웹 앱은 어떻게 업데이트하나요?

웹 앱은 수동으로 업데이트할 필요가 없습니다. 페이지를 새로 고치면 최신 버전을 불러옵니다.

## 관련 문서

* [일반 및 화면 스타일](https://docs.aihubmix.com/ko/cloud/settings/general.md)
* [계정 메뉴와 오버레이](https://docs.aihubmix.com/ko/cloud/interface/command-and-menus.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.