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

# Static HTML

빌드 과정 없이 정적 HTML 파일을 그대로 배포합니다.

<Note>
  저장소 루트(또는 아래 `docbase` 로 지정한 경로)에 **`index.html` 파일이 반드시 있어야 합니다.** 배포 전에 파일 유무를 확인하세요.
</Note>

## 대시보드를 통한 생성

### 1. 템플릿 선택하기

* **[Github 저장소에서 템플릿 보기](https://github.com/cloudtype-examples/html.git)**

* 시작하기 페이지의 **언어/플랫폼** 카테고리에 접속 또는 `⌘ + K` 를 사용하여 `html` 을 검색하고 `HTML` 템플릿을 클릭하세요.

### 2. 새 저장소(repository) 생성하기 또는 나의 저장소 선택하기

클라우드타입은 기본적으로 사용자 Github 계정의 저장소에 반영된 소스를 배포합니다.

* 1️⃣ **배포하려는 저장소가 없다면**
  ⇒ 클라우드타입이 제공하는 예제 저장소를 사용자의 Github 계정에 생성합니다.
* 2️⃣ **배포하려는 저장소가 있다면**
  ⇒ 클라우드타입에서 배포할 사용자 본인의 저장소를 선택합니다.

#### 1️⃣ 배포하려는 저장소가 없는 경우

* **비공개 저장소 설정하기** 여부만 선택한 후 `저장소 만들기` 를 클릭하면 사용자의 Github 계정에 해당 템플릿 저장소가 자동으로 생성됩니다.

#### 2️⃣ 배포하려는 저장소가 있는 경우

* Github 계정에 존재하는 저장소 중 배포를 원하는 항목을 선택하세요. 이미 위에서 저장소를 만든 경우 이 부분은 건너뛰어주세요.
* 저장소를 직접 선택한 경우 세부 설정이 기본 설정과 다를 수 있습니다. 빌드 설정의 **설정변경** 버튼을 클릭하고 수정이 필요한 설정사항을 수정해주세요.

### 3. 배포하기

* 위 과정을 마친 후 마지막으로 배포할 리전을 선택하고 `배포하기` 버튼을 클릭하면 배포가 자동으로 진행됩니다.

***

## CLI 를 통한 생성

### 1. 사전준비

아래 가이드에 따라 CLI 를 설치하고 로그인을 진행해주세요.<br />
[CLI 설치하기](/ko/developers/cli/install)

### 2. 설정파일 생성

`.cloudtype/app.yaml` 파일을 생성하세요.

#### Static HTML

```yaml theme={null}
name: html
app: web
options:
  docbase: /
  spa: false
context:
  git:
    url: https://github.com/cloudtype-examples/html.git
    branch: main
  preset: html
```

주요 설정 항목은 아래와 같습니다.

| 항목           | 설명                                                                            |
| ------------ | ----------------------------------------------------------------------------- |
| `docbase`    | 정적 파일이 위치한 기준 경로. 저장소 루트면 `/`, 하위 폴더면 `/dist` 처럼 지정합니다                        |
| `spa`        | SPA 여부. `true` 면 존재하지 않는 경로 요청도 `index.html` 로 응답합니다. 정적 HTML 문서 묶음이면 `false` |
| `git.url`    | 배포할 저장소 주소                                                                    |
| `git.branch` | 배포할 브랜치                                                                       |
| `preset`     | `html` 프리셋 사용                                                                 |

### 3. 배포하기

```sh theme={null}
$ ctype apply
```

## 참고

### FAQ

* [HTML 파일이 GitHub 저장소에 있는데 도메인으로 접속하면 정상적으로 페이지가 로드되지 않아요.](/ko/troubleshooting/common)
* [서비스 접속 시 50X 페이지만 뜹니다.](/ko/troubleshooting/common)
* [하나의 Git 원격 저장소에서 두 개 이상의 앱을 배포하고 싶어요.](/ko/troubleshooting/git)