# Быстрый старт

> Установите PentAGI с помощью интерактивного установщика: системные требования, загрузка, пошаговая настройка providers и search engines, а также первый вход.

## [Системные требования](https://pentagi.com/ru/docs/getting-started/quickstart/#system-requirements)

* Docker Engine 20 или новее с Docker Compose; при использовании [Podman](https://pentagi.com/ru/docs/deployment/production/#podman) [установите вручную](https://pentagi.com/ru/docs/getting-started/manual-installation/)
* Минимум 2 vCPU и 4 ГБ оперативной памяти
* 25 ГБ свободного места на диске
* Доступ к интернету для загрузки образов и обновлений

## [Загрузка установщика](https://pentagi.com/ru/docs/getting-started/quickstart/#download-the-installer)

Установщик представляет собой терминальный интерфейс, который проверяет систему, настраивает [providers](https://pentagi.com/ru/docs/glossary/#provider) и [search engines](https://pentagi.com/ru/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 всё равно блокирует установщик, не отключайте предупреждение: снова скачайте архив для вашего процессора по ссылкам выше.

## [Предварительный просмотр](https://pentagi.com/ru/docs/getting-started/quickstart/#watch-it-first)

Запись работы установщика в терминале доступна на [asciinema](https://asciinema.org/a/BHI8GnwhzOnH1EfsQCNRfBatu).

## [Запуск](https://pentagi.com/ru/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
```

Установщик взаимодействует с API Docker через `/var/run/docker.sock`, поэтому требуются права 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/ru/docs/getting-started/quickstart/#sign-in)

Откройте `https://localhost:8443` и войдите под учётной записью по умолчанию `admin@pentagi.com` / `admin`, затем смените пароль.

Веб-интерфейс и другие службы привязаны к localhost, но [sandbox](https://pentagi.com/ru/docs/glossary/#sandbox) каждого [flow](https://pentagi.com/ru/docs/glossary/#flow) публикует два порта обратного вызова, по умолчанию от `28000` до `29999`, на всех интерфейсах Docker-хоста, и ufw их не фильтрует. На хосте, доступном другим, сначала ограничьте этот диапазон — см. [Сетевая доступность](https://pentagi.com/ru/docs/configuration/security/#network-exposure). Затем перейдите к разделу [ваш первый flow](https://pentagi.com/ru/docs/getting-started/first-flow/); чтобы позже обновить установку, следуйте инструкциям [Обновление](https://pentagi.com/ru/docs/deployment/upgrade/).