Handmatige installatie

Gebruik de handmatige methode wanneer je volledige controle over de configuratie wilt of de interactieve installer niet kunt uitvoeren.

1. Maak een werkmap aan

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

2. Download het omgevingsbestand

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

Het compose-bestand gebruikt drie configuratiebestanden voor providers, dus maak deze aan — lege bestanden zijn voldoende:

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

Als je een eigen OpenAI-compatibel endpoint of Ollama wilt gebruiken, haal dan de voorbeeldconfiguraties op in plaats van de lege bestanden en verwijs met LLM_SERVER_CONFIG_PATH of OLLAMA_SERVER_CONFIG_PATH in .env naar /opt/pentagi/conf/custom.provider.yml of /opt/pentagi/conf/ollama.provider.yml. De aangepaste voorbeelden noemen OpenAI-modellen, waaronder o3-mini, dat OpenAI op 23 oktober 2026 uitfaset — stel de model van elke agent in op een model dat jouw endpoint aanbiedt:

curl -o example.custom.provider.yml https://raw.githubusercontent.com/vxcontrol/pentagi/main/examples/configs/custom-openai.provider.yml
curl -o example.ollama.provider.yml https://raw.githubusercontent.com/vxcontrol/pentagi/main/examples/configs/ollama-llama318b.provider.yml

3. Voeg minimaal één LLM-provider toe

Bewerk .env en stel de sleutel van ten minste één provider in:

OPEN_AI_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key

Andere providers — AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI en eigen endpoints — worden beschreven in LLM-providers. Search engines zijn optioneel; DuckDuckGo en Sploitus hebben geen sleutel nodig:

DUCKDUCKGO_ENABLED=true
SPLOITUS_ENABLED=true
TAVILY_API_KEY=your_tavily_key

4. Start de stack

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

De webinterface is beschikbaar op https://localhost:8443. Log in met [email protected] / admin en wijzig het wachtwoord.

De web-UI en de andere services zijn gebonden aan localhost, maar de sandbox van elke flow publiceert twee callback-poorten, standaard van 28000–29999, op elke interface van de Docker-host en ufw filtert deze niet. Beperk dat bereik eerst op een host die anderen kunnen bereiken — zie Netwerkexpositie. Volg Upgraden om de installatie later bij te werken.

Optionele stacks

Elke optionele service wordt geleverd als een eigen compose-bestand dat je bovenop het basisbestand legt: