# Início rápido

> Instale o PentAGI com o instalador interativo — requisitos do sistema, download, configuração guiada de providers e search engines, e o primeiro login.

## [Requisitos do sistema](https://pentagi.com/pt-br/docs/getting-started/quickstart/#system-requirements)

* Docker Engine 20 ou posterior com Docker Compose; no [Podman](https://pentagi.com/pt-br/docs/deployment/production/#podman), [instale manualmente](https://pentagi.com/pt-br/docs/getting-started/manual-installation/)
* 2 vCPU e 4 GB de RAM no mínimo
* 25 GB de espaço livre em disco
* Acesso à internet para imagens e atualizações

## [Baixe o instalador](https://pentagi.com/pt-br/docs/getting-started/quickstart/#download-the-installer)

O instalador é uma interface de terminal que verifica seu sistema, configura [providers](https://pentagi.com/pt-br/docs/glossary/#provider) e [search engines](https://pentagi.com/pt-br/docs/glossary/#search-engine), reforça a segurança da configuração e implanta a pilha.

| Plataforma          | Arquivo                                                                                  |
| ------------------- | ---------------------------------------------------------------------------------------- |
| 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]
> As compilações para macOS são assinadas e notariadas. Se o macOS ainda bloquear o instalador, não ignore o aviso: baixe novamente o arquivo para a sua CPU a partir dos links acima.

## [Assista primeiro](https://pentagi.com/pt-br/docs/getting-started/quickstart/#watch-it-first)

Uma gravação de terminal do instalador em ação está disponível no [asciinema](https://asciinema.org/a/BHI8GnwhzOnH1EfsQCNRfBatu).

## [Execute-o](https://pentagi.com/pt-br/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
```

O instalador se comunica com a API do Docker através de `/var/run/docker.sock`, portanto precisa de root ou de um usuário no grupo `docker`:

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

> [!NOTE]
> Pertencer ao grupo `docker` equivale a ter privilégios de root. Conceda essa permissão apenas a usuários confiáveis; para produção, execute o instalador com `sudo` ou use o Docker sem root.

O instalador percorre as seguintes etapas:

1. **Verificações do sistema** — Docker, conectividade de rede e requisitos.
2. **Configuração do ambiente** — um arquivo `.env` com padrões sensatos.
3. **LLM providers** — OpenAI, Anthropic, Gemini, Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI ou um endpoint personalizado.
4. **Search engines** — DuckDuckGo, Google, Tavily, Firecrawl, Traversaal, Perplexity, Sploitus, SearXNG.
5. **Reforço de segurança** — credenciais geradas e certificados SSL.
6. **Implantação** — inicia a pilha com o Docker Compose.

## [Faça login](https://pentagi.com/pt-br/docs/getting-started/quickstart/#sign-in)

Abra `https://localhost:8443` e faça login com a conta padrão `admin@pentagi.com` / `admin`, depois altere a senha.

A interface web e os outros serviços ficam restritos ao localhost, mas o [sandbox](https://pentagi.com/pt-br/docs/glossary/#sandbox) de cada [flow](https://pentagi.com/pt-br/docs/glossary/#flow) publica duas portas de callback, de `28000`–`29999` por padrão, em todas as interfaces do host Docker, e o ufw não as filtra. Em um host acessível por outras pessoas, restrinja primeiro esse intervalo — veja [Exposição de rede](https://pentagi.com/pt-br/docs/configuration/security/#network-exposure). Depois, continue com [seu primeiro flow](https://pentagi.com/pt-br/docs/getting-started/first-flow/); para atualizar a instalação posteriormente, siga [Atualização](https://pentagi.com/pt-br/docs/deployment/upgrade/).