Get started

Run your first autonomous pentest in minutes

PentAGI is self-hosted: the whole stack runs in Docker on your own machine or server. Use the interactive installer, or bring up the Docker Compose stack by hand.

Docker with Docker Compose
2 vCPU
4 GB of RAM
25 GB of disk
Internet access

Install with the interactive installer

The terminal installer checks your system, configures LLM providers and search engines, hardens the setup and deploys the stack. Download the archive for your platform:

Linux · amd64 Linux · arm64 macOS · Intel macOS · Apple silicon Windows · amd64

Or from a Linux or macOS terminal:

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

The installer talks to the Docker API, so run it with sudo or as a user in the docker group. The macOS builds are signed and notarized: if macOS still blocks the installer, download the archive for your CPU again from this page instead of overriding the warning.

Or deploy with Docker Compose

Create a working directory:

mkdir -p ~/pentagi && cd ~/pentagi

Download the environment file:

test -f .env || curl -fo .env.new https://raw.githubusercontent.com/vxcontrol/pentagi/main/.env.example
test -f .env.new && openssl rand -hex 32 | xargs -I VALUE sed -E -i.bak 's/^COOKIE_SIGNING_SALT=salt( .*)?$/COOKIE_SIGNING_SALT=VALUE/' .env.new
test -f .env.new && openssl rand -hex 16 | xargs -I VALUE sed -E -i.bak 's/^PENTAGI_POSTGRES_PASSWORD=postgres( .*)?$/PENTAGI_POSTGRES_PASSWORD=VALUE/' .env.new
test -f .env || mv .env.new .env

Create the provider configuration files the stack mounts:

touch example.custom.provider.yml example.ollama.provider.yml example.bedrock.provider.yml

Edit .env and set the key of at least one LLM provider:

.env

OPEN_AI_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key

Download the compose file and start the stack:

curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/main/docker-compose.yml
test -f .env && docker compose up -d

Optional stacks — Langfuse, the knowledge graph and the Grafana/OpenTelemetry observability stack — are separate compose files you can layer on top. See the documentation.

Open the web console

Go to https://localhost:8443 and sign in with [email protected] / admin, then change the password. Describe a target and a goal — PentAGI plans the work, runs the tools in its sandbox and reports what it found.

Use PentAGI only against systems you own or are explicitly authorized to test. By installing it you agree to the EULA.

Read the docs Ask the community