# Szybki start

> Zainstaluj PentAGI za pomocą interaktywnego instalatora — wymagania systemowe, pobieranie, przewodnik konfiguracji providerów i search engines oraz pierwsze logowanie.

## [Wymagania systemowe](https://pentagi.com/pl/docs/getting-started/quickstart/#system-requirements)

* Docker Engine 20 lub nowszy z Docker Compose; w przypadku [Podmana](https://pentagi.com/pl/docs/deployment/production/#podman), [zainstaluj ręcznie](https://pentagi.com/pl/docs/getting-started/manual-installation/)
* Minimum 2 vCPU i 4 GB RAM
* 25 GB wolnego miejsca na dysku
* Dostęp do internetu w celu pobrania obrazów i aktualizacji

## [Pobierz instalator](https://pentagi.com/pl/docs/getting-started/quickstart/#download-the-installer)

Instalator to interfejs w terminalu, który sprawdza Twój system, konfiguruje [providers](https://pentagi.com/pl/docs/glossary/#provider) i [search engines](https://pentagi.com/pl/docs/glossary/#search-engine), wzmacnia bezpieczeństwo konfiguracji oraz wdraża stack.

| Platforma           | Archiwum                                                                                 |
| ------------------- | ---------------------------------------------------------------------------------------- |
| 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]
> Kompilacje dla macOS są podpisane i notaryzowane. Jeśli macOS nadal blokuje instalator, nie pomijaj ostrzeżenia: pobierz ponownie archiwum odpowiednie dla Twojego procesora z powyższych linków.

## [Zobacz to w akcji](https://pentagi.com/pl/docs/getting-started/quickstart/#watch-it-first)

Nagranie z działania instalatora w terminalu znajdziesz na [asciinema](https://asciinema.org/a/BHI8GnwhzOnH1EfsQCNRfBatu).

## [Uruchomienie](https://pentagi.com/pl/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
```

Instalator komunikuje się z API Dockera przez `/var/run/docker.sock`, dlatego wymaga uprawnień roota lub użytkownika należącego do grupy `docker`:

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

> [!NOTE]
> Członkostwo w grupie `docker` jest równoważne z uprawnieniami roota. Nadawaj je tylko zaufanym użytkownikom; w środowisku produkcyjnym uruchamiaj instalator z `sudo` lub używaj Dockera w trybie rootless.

Instalator przeprowadzi Cię przez następujące kroki:

1. **Sprawdzenie systemu** — Docker, łączność sieciowa i wymagania sprzętowe.
2. **Konfiguracja środowiska** — plik `.env` z rozsądnymi ustawieniami domyślnymi.
3. **LLM providers** — OpenAI, Anthropic, Gemini, Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI lub własny endpoint.
4. **Search engines** — DuckDuckGo, Google, Tavily, Firecrawl, Traversaal, Perplexity, Sploitus, SearXNG.
5. **Wzmocnienie bezpieczeństwa** — wygenerowane poświadczenia i certyfikaty SSL.
6. **Wdrożenie** — uruchamia stack za pomocą Docker Compose.

## [Logowanie](https://pentagi.com/pl/docs/getting-started/quickstart/#sign-in)

Otwórz `https://localhost:8443` i zaloguj się na domyślne konto `admin@pentagi.com` / `admin`, a następnie zmień hasło.

Interfejs webowy i inne usługi są powiązane z localhost, ale [sandbox](https://pentagi.com/pl/docs/glossary/#sandbox) każdego [flow](https://pentagi.com/pl/docs/glossary/#flow) publikuje dwa porty callback, domyślnie z zakresu `28000`–`29999`, na każdym interfejsie hosta Docker, a ufw ich nie filtruje. Na hoście dostępnym dla innych osób najpierw ogranicz ten zakres — zobacz [Network exposure](https://pentagi.com/pl/docs/configuration/security/#network-exposure). Następnie kontynuuj z [Twoim pierwszym flow](https://pentagi.com/pl/docs/getting-started/first-flow/); aby później zaktualizować instalację, postępuj zgodnie z [Upgrading](https://pentagi.com/pl/docs/deployment/upgrade/).