# Avvio rapido

> Installa PentAGI con l'installer interattivo: requisiti di sistema, download, una configurazione guidata di providers e search engines, e il primo accesso.

## [Requisiti di sistema](https://pentagi.com/it/docs/getting-started/quickstart/#system-requirements)

* Docker Engine 20 o successivo con Docker Compose; su [Podman](https://pentagi.com/it/docs/deployment/production/#podman), [installa manualmente](https://pentagi.com/it/docs/getting-started/manual-installation/)
* Almeno 2 vCPU e 4 GB di RAM
* 25 GB di spazio libero su disco
* Accesso a Internet per le immagini e gli aggiornamenti

## [Scarica l'installer](https://pentagi.com/it/docs/getting-started/quickstart/#download-the-installer)

L'installer è un'interfaccia da terminale che verifica il tuo sistema, configura i [providers](https://pentagi.com/it/docs/glossary/#provider) e i [search engines](https://pentagi.com/it/docs/glossary/#search-engine), applica le misure di sicurezza e distribuisce lo stack.

| Piattaforma         | Archivio                                                                                 |
| ------------------- | ---------------------------------------------------------------------------------------- |
| 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]
> Le build per macOS sono firmate e notarizzate. Se macOS blocca comunque l'installer, non ignorare l'avviso: scarica di nuovo l'archivio per la tua CPU dai link sopra indicati.

## [Anteprima](https://pentagi.com/it/docs/getting-started/quickstart/#watch-it-first)

Una registrazione da terminale dell'installer in azione è disponibile su [asciinema](https://asciinema.org/a/BHI8GnwhzOnH1EfsQCNRfBatu).

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

L'installer comunica con le API Docker tramite `/var/run/docker.sock`, quindi richiede i privilegi di root o un utente appartenente al gruppo `docker`:

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

> [!NOTE]
> L'appartenenza al gruppo `docker` equivale ai privilegi di root. Concedila solo ad utenti fidati; per la produzione, esegui l'installer con `sudo` oppure usa Docker in modalità rootless.

L'installer ti guiderà attraverso:

1. **Verifiche di sistema** — Docker, connettività di rete e requisiti.
2. **Configurazione dell'ambiente** — un file `.env` con valori predefiniti ottimali.
3. **LLM providers** — OpenAI, Anthropic, Gemini, Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI o un endpoint personalizzato.
4. **Search engines** — DuckDuckGo, Google, Tavily, Firecrawl, Traversaal, Perplexity, Sploitus, SearXNG.
5. **Rafforzamento della sicurezza** — generazione delle credenziali e dei certificati SSL.
6. **Distribuzione** — avvio dello stack con Docker Compose.

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

Apri `https://localhost:8443` e accedi con l'account predefinito `admin@pentagi.com` / `admin`, quindi cambia la password.

L’interfaccia web e gli altri servizi sono vincolati a localhost, ma il [sandbox](https://pentagi.com/it/docs/glossary/#sandbox) di ogni [flow](https://pentagi.com/it/docs/glossary/#flow) pubblica due porte di callback, da `28000`–`29999` per impostazione predefinita, su tutte le interfacce dell’host Docker, e ufw non le filtra. Su un host raggiungibile da altri, limita prima quell’intervallo — vedi [Esposizione alla rete](https://pentagi.com/it/docs/configuration/security/#network-exposure). Prosegui quindi con [il tuo primo flow](https://pentagi.com/it/docs/getting-started/first-flow/); per aggiornare l’installazione in seguito, segui [Aggiornamento](https://pentagi.com/it/docs/deployment/upgrade/).