# クイックスタート

> インタラクティブインストーラーを使用してPentAGIをインストールします — システム要件、ダウンロード、providersとsearch enginesのガイド付きセットアップ、および初回サインイン。

## [システム要件](https://pentagi.com/ja/docs/getting-started/quickstart/#system-requirements)

* Docker Engine 20以降とDocker Compose。[Podman](https://pentagi.com/ja/docs/deployment/production/#podman)の場合は、[手動でインストール](https://pentagi.com/ja/docs/getting-started/manual-installation/)してください
* 最小 2 vCPU および 4 GB RAM
* 25 GB の空きディスク容量
* イメージおよび更新のためのインターネット接続

## [インストーラーのダウンロード](https://pentagi.com/ja/docs/getting-started/quickstart/#download-the-installer)

インストーラーはターミナル UI であり、システムの確認、[providers](https://pentagi.com/ja/docs/glossary/#provider) と [search engines](https://pentagi.com/ja/docs/glossary/#search-engine) の設定、セットアップのセキュリティ強化、スタックのデプロイを行います。

| プラットフォーム            | アーカイブ                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------- |
| 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/ja/docs/getting-started/quickstart/#watch-it-first)

[asciinema](https://asciinema.org/a/BHI8GnwhzOnH1EfsQCNRfBatu) にインストーラーの動作を記録したターミナル録画があります。

## [実行する](https://pentagi.com/ja/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 と通信するため、root または `docker` グループに所属するユーザーが必要です：

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

> [!NOTE]
> `docker` グループへの所属は root と同等の権限を持ちます。信頼できるユーザーにのみ付与してください。本番環境では、`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/ja/docs/getting-started/quickstart/#sign-in)

`https://localhost:8443` を開き、デフォルトアカウント `admin@pentagi.com` / `admin` でサインインしてからパスワードを変更してください。

Web UI と他のサービスは localhost にバインドされていますが、各 [flow](https://pentagi.com/ja/docs/glossary/#flow) の [sandbox](https://pentagi.com/ja/docs/glossary/#sandbox) は、デフォルトで `28000`–`29999` の2つのコールバックポートを Docker ホストのすべてのインターフェース上で公開し、ufw はそれらをフィルタリングしません。他のユーザーがアクセス可能なホストでは、まずその範囲を制限してください — [Network exposure](https://pentagi.com/ja/docs/configuration/security/#network-exposure) を参照してください。その後、[最初の flow](https://pentagi.com/ja/docs/getting-started/first-flow/) に進みます。後でインストールを更新するには、[Upgrading](https://pentagi.com/ja/docs/deployment/upgrade/) に従ってください。