# 빠른 시작

> 대화형 설치 프로그램을 사용하여 PentAGI를 설치합니다 — 시스템 요구 사항, 다운로드, providers 및 search engines의 안내된 설정, 그리고 첫 로그인.

## [시스템 요구 사항](https://pentagi.com/ko/docs/getting-started/quickstart/#system-requirements)

* Docker Engine 20 이상 및 Docker Compose; [Podman](https://pentagi.com/ko/docs/deployment/production/#podman)의 경우 [수동 설치](https://pentagi.com/ko/docs/getting-started/manual-installation/)
* 최소 2 vCPU 및 4 GB RAM
* 25 GB 이상의 사용 가능한 디스크 공간
* 이미지 및 업데이트를 위한 인터넷 연결

## [설치 프로그램 다운로드](https://pentagi.com/ko/docs/getting-started/quickstart/#download-the-installer)

설치 프로그램은 시스템을 점검하고, [providers](https://pentagi.com/ko/docs/glossary/#provider)와 [search engines](https://pentagi.com/ko/docs/glossary/#search-engine)를 구성하며, 설정을 강화한 후 스택을 배포하는 터미널 UI입니다.

| 플랫폼                 | 아카이브                                                                                     |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Linux amd64         | [installer-latest.zip](https://pentagi.com/downloads/linux/amd64/installer-latest.zip)   |
| Linux arm64         | [installer-latest.zip](https://pentagi.com/downloads/linux/arm64/installer-latest.zip)   |
| Windows amd64       | [installer-latest.zip](https://pentagi.com/downloads/windows/amd64/installer-latest.zip) |
| macOS Intel         | [installer-latest.zip](https://pentagi.com/downloads/darwin/amd64/installer-latest.zip)  |
| macOS Apple silicon | [installer-latest.zip](https://pentagi.com/downloads/darwin/arm64/installer-latest.zip)  |

> [!WARNING]
> macOS 빌드는 서명 및 공증되었습니다. macOS가 설치 프로그램을 계속 차단하더라도 경고를 무시하지 마세요: 위의 링크에서 CPU에 맞는 아카이브를 다시 다운로드하세요.

## [먼저 영상으로 확인하기](https://pentagi.com/ko/docs/getting-started/quickstart/#watch-it-first)

[asciinema](https://asciinema.org/a/BHI8GnwhzOnH1EfsQCNRfBatu)에서 설치 프로그램이 작동하는 터미널 녹화 영상을 확인할 수 있습니다.

## [실행하기](https://pentagi.com/ko/docs/getting-started/quickstart/#run-it)

```bash
mkdir -p ~/pentagi && cd ~/pentagi
uname -sm | sed -e 's,Linux ,linux/,' -e 's,Darwin ,darwin/,' -e s/x86_64/amd64/ -e s/aarch64/arm64/ | xargs -I PLATFORM curl -fLo installer.zip https://pentagi.com/downloads/PLATFORM/installer-latest.zip
unzip -o installer.zip
sudo ./installer
```

설치 프로그램은 `/var/run/docker.sock`를 통해 Docker API와 통신하므로 루트 권한 또는 `docker` 그룹에 속한 사용자가 필요합니다:

```bash
sudo usermod -aG docker $USER
newgrp docker
docker ps
```

> [!NOTE]
> `docker` 그룹 소속은 루트 권한과 동일하므로 신뢰할 수 있는 사용자에게만 부여해 주세요. 프로덕션 환경에서는 `sudo`로 설치 프로그램을 실행하거나 rootless Docker를 사용해 주세요.

설치 프로그램은 다음 단계를 진행합니다:

1. **시스템 점검** — Docker, 네트워크 연결 및 요구 사항을 확인합니다.
2. **환경 설정** — 적절한 기본값이 포함된 `.env` 파일을 생성합니다.
3. **LLM providers** — OpenAI, Anthropic, Gemini, Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI 또는 커스텀 엔드포인트.
4. **Search engines** — DuckDuckGo, Google, Tavily, Firecrawl, Traversaal, Perplexity, Sploitus, SearXNG.
5. **보안 강화** — 자격 증명 및 SSL 인증서를 생성합니다.
6. **배포** — Docker Compose로 스택을 시작합니다.

## [로그인](https://pentagi.com/ko/docs/getting-started/quickstart/#sign-in)

`https://localhost:8443`을 열고 기본 계정 `admin@pentagi.com` / `admin`로 로그인한 후 비밀번호를 변경해 주세요.

웹 UI와 다른 서비스는 localhost에 바인딩되지만, 각 [flow](https://pentagi.com/ko/docs/glossary/#flow)의 [sandbox](https://pentagi.com/ko/docs/glossary/#sandbox)는 기본적으로 `28000`–`29999` 범위의 두 콜백 포트를 Docker 호스트의 모든 인터페이스에 게시하며, ufw는 이를 필터링하지 않습니다. 다른 사용자가 접근할 수 있는 호스트에서는 먼저 해당 범위를 제한하십시오. [네트워크 노출](https://pentagi.com/ko/docs/configuration/security/#network-exposure)을 참조하십시오. 그런 다음 [첫 번째 flow](https://pentagi.com/ko/docs/getting-started/first-flow/)를 진행해 주세요. 나중에 설치를 업데이트하려면 [업그레이드](https://pentagi.com/ko/docs/deployment/upgrade/)를 따르십시오.