# 설치하기

> **이 장에서 배우는 것**
> 설치 명령 한 줄, 설치 중 물어보는 것들, 그리고 무엇이 어디에 설치되는지.

## 한 줄

터미널(macOS·Linux) 또는 PowerShell(Windows)에 붙여넣으세요.

```bash
# macOS / Linux
curl -fsSL https://hyperteams.net/install.sh | bash
```

```powershell
# Windows PowerShell
iex (irm https://hyperteams.net/install.ps1)
```

**받아서 바로 쓸 수 있는 상태로 들어갑니다.** 따로 빌드하거나 조립하는 과정이
없습니다.

## 설치 중에 물어보는 것

### 1. 접속 주소

브라우저로 접속할 주소입니다. 기본값은 이렇습니다.

```
http://localhost:27777
```

**특별한 이유가 없으면 기본값을 쓰세요.** 그 번호가 이미 다른 프로그램에 쓰이고
있다면 바꾸라고 안내가 나옵니다.

### 2. 비밀번호

접속할 때 입력할 비밀번호입니다.

> **지금은 내 컴퓨터에서만 열리지만 비밀번호를 정해두세요.** 나중에
> [밖에서 접속](/guide/ht-remote-access)하게 되면 그 순간부터 이 비밀번호가
> 유일한 문입니다.

잊어버려도 [`hyperteams setup`](/guide/ht-cli)으로 다시 정할 수 있습니다.

## 무엇이 어디에 설치되나

| | 위치 |
|---|---|
| 프로그램 파일 | 설치 폴더 (설치 중 안내됨) |
| 실행 명령 | `hyperteams` — 어느 폴더에서든 실행 가능 |
| 데이터베이스 | 설치 폴더 안. **대화와 사용량 기록** |
| 설정 | `.env.local` |
| 로그 | `logs/server.log` |

**내 작업 폴더에는 아무것도 안 만듭니다.** 하이퍼팀즈(HyperTeams)는 작업 폴더의 경로만
기억하고, 그 안에 자기 파일을 넣지 않습니다.

## 설치 확인

```bash
hyperteams --version
```

버전이 나오면 설치 완료입니다.

> **`command not found`가 나오면** [준비물 장](/guide/ht-prerequisites)에서와
> 같습니다 — **새 터미널 창**을 열어 다시 해보세요.

## 다른 주소로 설치하고 싶다면

기본 번호(27777)가 이미 쓰이고 있다면 실행할 때 바꿀 수 있습니다.

```bash
PORT=9000 hyperteams
```

설치를 다시 할 필요는 없습니다. 실행할 때마다 지정하거나,
[`hyperteams setup`](/guide/ht-cli)으로 기본값을 바꾸면 됩니다.

## 업데이트는 재설치가 아닙니다

**중요합니다.** 새 버전이 나와도 설치 스크립트를 다시 돌리지 마세요.

```bash
hyperteams upgrade
```

`upgrade`는 **프로그램 파일만 바꿉니다.** 기록·설정·연결해둔 주소는 그대로
남습니다. 재설치하면 그것들이 어떻게 될지 보장되지 않습니다.

## 자주 막히는 곳

### "curl: command not found" (Windows)

Windows에서는 PowerShell 명령을 쓰세요. `curl` 쪽은 macOS·Linux용입니다.

### 회사 네트워크에서 다운로드가 막힙니다

프록시나 방화벽 때문일 수 있습니다. IT 담당자에게 `hyperteams.net` 접근 허용을
요청하시거나, 설치 스크립트를 받아서 내용을 확인한 뒤 실행할 수도 있습니다.

### 설치는 됐는데 실행이 안 됩니다

[다음 장](/guide/ht-first-run)에서 첫 실행을 단계별로 다룹니다.

---

## 확인

**1. 설치 중에 물어보는 두 가지는?**

<details>
<summary>답</summary>

**접속 주소(기본 `http://localhost:27777`)와 비밀번호**입니다. 비밀번호는 지금은
내 컴퓨터에서만 열리더라도 정해두는 게 좋습니다 — 나중에 밖에서 접속하게 되면
그것이 유일한 문이 됩니다.
</details>

**2. 새 버전이 나왔을 때 설치 스크립트를 다시 돌리면 안 되는 이유는?**

<details>
<summary>답</summary>

`hyperteams upgrade`는 **프로그램 파일만 바꾸고** 기록·설정·연결한 주소를
보존하지만, 재설치는 그것들이 어떻게 될지 보장되지 않습니다.
</details>

**3. HyperTeams가 내 작업 폴더에 파일을 만듭니까?**

<details>
<summary>답</summary>

**아니요.** 작업 폴더의 경로만 기억하고, 자기 파일(DB·설정·로그)은 설치 폴더에
둡니다.
</details>

---

이제 켜봅니다 → [처음 켜고 접속하기](/guide/ht-first-run)