# 사이트에 앱 설치하기

Source: https://support.kapsulehost.com/ko-kr/apps-installing

앱을 설치할 때 마법사는 세 단계를 거칩니다: 관리자 계정 및 사이트 설정을 구성하고, 일어날 일을 검토한 다음, 설치를 실행하고 로그인 세부 정보를 수집합니다.

## 시작하기 전에

필요한 것이 하나 있습니다: 계정의 **활성 웹사이트**입니다. 마법사는 이미 가지고 있는 사이트에 설치되며, 새 사이트를 만들지는 않습니다. 없으신 경우 마법사가 알려드리고 새 사이트를 만들 수 있는 링크를 제공합니다. [첫 번째 웹사이트 만들기](https://support.kapsulehost.com/ko-kr/creating-your-first-website)를 참조하세요.

또한 계정 소유자 및 관리자가 보유한 **apps:write** 권한이 필요합니다.

> **Warning:** 이미 콘텐츠가 있는 사이트에 설치하기 전에 백업을 받으세요. 마법사는 이미 앱을 가지고 있는 사이트에 대한 안전 장치를 가지고 있으며, 이에 대해서는 아래에 설명되어 있지만, 의도적으로 수동으로 만든 복원 지점은 항상 자동으로 만든 것보다 더 가치 있습니다. [백업 수행](https://support.kapsulehost.com/ko-kr/taking-a-backup)을 참조하세요.

## 마법사로 이동

1. KPanel 사이드바에서 **앱**을 클릭합니다.
2. 원하는 앱을 클릭합니다.
3. 오른쪽 패널에서 **[앱] 설치**를 클릭합니다.

직접 주소는 `/apps/<app-slug>/install`입니다.

![KPanel의 앱 설치 마법사, 오른쪽 패널에 설치 버튼](https://support.kapsulehost.com/help/screenshots/apps-installing.1f6e023d.webp)

## 1단계: 구성

마법사는 앱을 표시한 다음 네 그룹의 필드를 표시합니다. **플랜 업그레이드 권장** 알림은 앱이 현재 사용 중인 플랜보다 높은 플랜 수준을 제안하는 경우 상단에 나타나며, 이는 조언이고 설치는 계속 진행됩니다.

### 위치

**사이트에 설치.** 활성 사이트에서 선택합니다. 앱이 설치될 위치입니다.

### 관리자 계정

- **관리자 사용자명.** 기본값은 `admin`입니다. 이것은 로그인할 때 사용할 사용자명이며, 나중에 더 많은 사용자를 추가할 수 있습니다.
- **관리자 암호.** 페이지가 로드되는 순간 강력한 16자 암호가 생성됩니다. **표시**하면 암호를 볼 수 있고 **생성**을 클릭하면 새로운 암호를 만들 수 있습니다. 직접 입력할 수도 있으며, 최소 8자 이상이어야 합니다.
- **관리자 이메일.** 선택 사항입니다. 로그인 및 암호 재설정에 사용됩니다. 비워두면 계정 이메일이 사용됩니다.

> **Important:** 마법사를 떠나기 전에 관리자 암호를 저장하세요. 검토 화면과 성공 화면에 표시되며, 그 후에는 사라집니다. KapsuleHost는 나중에 검색할 수 있는 복사본을 저장하지 않으므로, 분실하면 앱 자체를 통해 암호를 재설정해야 합니다.

### 사이트 설정

- **사이트 이름**, 앱에서 요청하는 경우입니다.
- **언어.** 앱이 설정된 언어입니다. English (US), English (UK), Te Reo Māori, 주요 유럽 및 아시아 언어를 포함한 16개 옵션 중에서 선택할 수 있습니다. 이것은 KPanel의 언어가 아니라 앱 자체의 콘텐츠 언어를 설정합니다.

### 데이터베이스

앱이 필요한 경우에만 표시됩니다. 마법사는 도메인에서 파생된 데이터베이스 이름을 제안합니다. 문자와 숫자만 가능하며, 밑줄이나 하이픈은 불가능합니다: 필드는 입력할 때 이를 강제합니다. 원하면 변경할 수 있습니다.

데이터베이스가 필요한 앱은 설치의 일부로 자동으로 프로비저닝됩니다.

일부 앱은 이 아래에 앱 자체에서 정의한 추가 필드를 추가하며, 해당하는 경우 도움말 텍스트가 제공됩니다. 필수 필드는 별표로 표시되며, 모든 필드가 채워질 때까지 **계속**은 비활성화된 상태입니다.

마법사는 이 앱의 리소스 요약(예상 설치 시간, 최소 RAM, 데이터베이스 추가 여부)을 하단에 표시합니다.

**계속**을 클릭합니다.

## 2단계: 검토 및 확인

검토 화면은 한 목록에서 결정 사항을 다시 표시합니다: 앱, 웹사이트, 사이트 이름, 관리자 사용자명, 관리자 암호(표시 또는 숨기기 토글 포함), 관리자 이메일, 언어 및 데이터베이스 이름입니다. 부제는 명확하게 말합니다: **확인할 때까지 아무것도 설치되지 않습니다.**

- **편집**하면 뒤로 이동하여 변경할 수 있습니다.
- **확인 및 설치**하면 작업을 시작합니다.

> **Tip:** 검토 화면을 사용하여 가장 중요한 확인을 하세요: **웹사이트** 행입니다. 잘못된 사이트에 설치하는 것은 가장 흔한 설치 실수이며, 아래의 덮어쓰기 보호가 있는 이유입니다.

## 3단계: 설치

마법사는 진행 상황 보기로 전환됩니다. 다음 내용을 순서대로 확인할 수 있습니다:

- **대기 중: 작업자 대기 중.** 작업이 큐에 있으며 곧 시작됩니다.
- **[앱] 설치 중**, 경과 시간(예상 설치 시간 기준) 및 진행 표시줄을 포함합니다.

페이지를 열어둡니다. 다른 곳으로 이동하면 설치가 백그라운드에서 계속되지만 라이브 보기와 끝의 자격 증명 요약을 잃게 됩니다.

설치가 문제에 부딪히면 자동으로 다시 시도하며 **설치 재시도** 및 시도 번호를 표시합니다. 예상 시간을 훨씬 넘어서 실행되는 경우, 계속 대기하거나 취소할 것을 제안하는 알림이 나타납니다.

### 취소

**설치 취소**하면 작업이 중지됩니다. 결과 화면에서 확인합니다: *설치가 중지되었습니다. 사이트에서 아무것도 변경되지 않았습니다.*

## 사이트에 이미 앱이 있는 경우

대상 사이트의 디렉터리에 이미 사이트가 있으면 설치가 경고와 함께 중지되며, 발견한 내용을 이름으로 지정합니다:

> 이 디렉터리에는 이미 [app]이 있습니다. [new app]을 설치하면 덮어쓰기되며 취소할 수 없습니다. 현재 사이트의 전체 백업이 먼저 수행되므로 복원할 수 있습니다.

두 가지 선택지가 있습니다: 취소하거나 **백업 및 덮어쓰기**합니다. 동의하면 작업은 기존 사이트의 전체 백업을 수행한 후 작업을 수행하므로 복원 지점이 있습니다.

> **Important:** 이것은 마법사의 돌아올 수 없는 지점입니다. 덮어쓰기는 기존 사이트의 파일을 대체합니다. 자동 백업은 복구 가능하다는 의미이지, 클릭 한 번으로 되돌릴 수 있다는 의미는 아닙니다. 사이트가 삭제해도 되는지 확실하지 않으면 취소하고 다른 사이트에 설치하세요.

## 우리 팀이 수동으로 설치하는 앱

일부 앱에는 입증된 자동 설치 프로그램이 없습니다. 이러한 경우 마법사는 진행 표시줄을 완전히 건너뛰고 따뜻한 확인을 대신 표시합니다:

> 당신을 위해 [app]을 설정하고 있습니다. 이 앱은 수동 설정이 필요하므로, 당신이 주문한 후 우리 팀이 사이트에 설치합니다. 라이브가 되는 순간 이메일을 보내드리며, 더 이상 할 일이 없습니다.

실패한 것도 없고 당신이 기다려야 할 것도 없습니다. 앱은 무료이므로 어느 쪽이든 요금이 없습니다.

## 4단계: 라이브 상태

성공 시 마법사는 **[app]이 라이브 상태입니다**를 표시하고, 도메인에 대한 링크 및 자격 증명 요약을 표시합니다:

- 관리자 사용자명
- 관리자 암호, 표시 또는 숨기기 포함
- 관리자 이메일
- 사이트 제목

또한 **설치 로그**를 한 줄씩 표시하며, 각 단계는 성공, 실패 또는 건너뜀으로 표시됩니다. 깨끗한 설치에서도 그 로그를 한 번 살펴볼 가치가 있습니다: 정확히 구성된 내용을 알려줍니다.

두 버튼이 흐름을 종료합니다: **[app] 열기**는 앱으로 직접 이동하고, **앱으로 돌아가기**는 카탈로그 페이지로 돌아갑니다.

## 실패하면 어떻게 하나요

**설치 실패.** 결과 화면은 무엇이 일어났는지 보여주고 중요한 부분을 명시합니다: *부분적 변경 사항은 모두 롤백되었습니다. 사이트가 깨끗합니다.* **다시 시도** 및 **지원팀 문의**의 두 가지 작업이 제공됩니다.

일반적인 원인 및 해결 방법:

- **리소스 제한.** 앱의 최소 RAM이 플랜에서 제공하는 것보다 크면 설치가 중간에 실패할 수 있습니다. 앱 페이지에서 **최소 RAM** 수치를 확인하세요. [플랜 업그레이드](https://support.kapsulehost.com/ko-kr/upgrading-your-plan)를 참조하세요.
- **거부된 필드.** 마법사는 작업이 큐에 조차 들어가기 전에 셸 안전하지 않은 문자를 포함하는 입력을 거부하고 필드를 이름으로 지정합니다. 값을 단순화합니다: 일반적인 사용자명, 생성된 암호, 문자와 숫자로만 된 데이터베이스 이름.
- **사이트가 활성화되지 않았습니다.** **ACTIVE** 상태의 사이트만 사이트 드롭다운에 나타납니다. 아직 프로비저닝 중인 사이트는 나열되지 않습니다.

**설치가 성공했지만 사이트에 오류가 표시됩니다.** 설치 로그에서 실패한 단계를 확인한 후 앱의 설명서에서 설치 후 설정을 확인하세요. 특히 커뮤니티 앱은 종종 브라우저에서 최종 설정 마법사를 실행해야 합니다. [웹사이트가 로드되지 않음](https://support.kapsulehost.com/ko-kr/website-not-loading)을 참조하세요.

**관리자 암호를 잃어버렸습니다.** 설정한 관리자 이메일로 앱 자체의 암호 재설정을 사용합니다. WordPress의 경우 [WordPress 암호 재설정](https://support.kapsulehost.com/ko-kr/wordpress-reset-password)을 참조하세요.

**설치가 대기 중에서 멈춰 있습니다.** 작업 큐가 바쁩니다. 시작됩니다. 예상 설치 시간을 훨씬 넘어 아직도 대기 중이면 취소하고 다시 시도한 후, 반복되면 [지원 티켓을 엽니다](https://support.kapsulehost.com/ko-kr/opening-a-support-ticket).

## 관련 항목

- [앱 카탈로그](https://support.kapsulehost.com/ko-kr/apps-overview)
- [WordPress 설치하기](https://support.kapsulehost.com/ko-kr/installing-wordpress)
- [백업 받기](https://support.kapsulehost.com/ko-kr/taking-a-backup)
- [내 웹사이트가 로드되지 않음: 진단 체크리스트](https://support.kapsulehost.com/ko-kr/website-not-loading)