Open-kritt zelf hosten op een VPS: handleiding
Leer hoe u open-kritt veilig zelf host via Docker Compose. Wij leggen uit hoe u een release vastzet, een SSH-tunnel naar poort 5173 opzet en welk budget u moet instellen.
Waarom open-kritt zelf hosten op een VPS en niet op uw laptop
Host open-kritt op een server die u kunt vernietigen en opnieuw kunt opbouwen. De tool voert zijn analyse-agents uit als root binnen tijdelijke job-containers, geeft elke container een beschrijfbare kopie van uw code en directe internettoegang, en koppelt de Docker-socket van de host aan zijn engine-service. Dat is een acceptabele afweging op een machine die specifiek voor deze taak is ingericht. Het is een onverstandige keuze op de machine waar uw SSH-keys op staan.
Vier eigenschappen van de standaardconfiguratie vormen de basis voor dit advies, en alle vier zijn afkomstig uit de README en het compose-bestand van het project zelf.
De agents zijn ontworpen om krachtig te zijn. De README stelt dat agents met tool-ondersteuning als root draaien binnen tijdelijke job-containers, voorzien van beschrijfbare kopieën van repositories en directe internettoegang, zodat ze tools kunnen installeren, targets kunnen compileren, tests kunnen uitvoeren en proofs of concept kunnen bouwen. Een scan is geen linter die alleen bestanden leest. Het is willekeurige code-executie waar u zelf om heeft gevraagd. Die internettoegang werkt twee kanten op: alles wat een agent ophaalt tijdens het onderzoeken van een target is niet-vertrouwde tekst die in de prompt terechtkomt; dit is hetzelfde risico dat u neemt wanneer u een agent zelf laat zoeken op het web.
De engine beheert de Docker-socket. docker-compose.yml koppelt de Docker-socket van de host aan de engine-service, omdat de engine per job één scan-container bouwt en start. Elk proces dat toegang heeft tot die socket kan een container starten die het bestandssysteem van de host koppelt. De engine heeft daardoor in feite root-rechten op de host waarop deze draait.
Er is geen inlogscherm. De backend wordt geleverd zonder applicatie-authenticatie. Toegang tot de poort betekent toegang tot uw resultaten en uw provider-tegoed.
De code die u scant is vaak niet van u. Wanneer u agents naar een repository van derden wijst, betekent dit dat u de build van die repository op uw eigen machine uitvoert, als root, met netwerktoegang.
Als u heeft gelezen waarom coding agents in een tijdelijke VM thuishoren, dan is dit hetzelfde dreigingsmodel, maar dan sterker. Geef open-kritt een VPS waar verder niets op staat, en beheer die VPS vanuit een afzonderlijk gebruikersaccount met minimale rechten in plaats van als root.
Wat open-kritt daadwerkelijk doet
open-kritt (de repository is Kritt-ai/open-kritt, gelicentieerd onder AGPL-3.0) splitst kwetsbaarheidsonderzoek op in kleine taken, voert deze taken parallel uit via AI-agents en ontdubbelt en rangschikt vervolgens de resultaten. U definieert een workflow als een keten van gerichte prompts, waarbij elke stap gestructureerde context ontvangt van de voorgaande stappen. Het scandoel is een externe of lokale git-repository. De analyse-engine is Codex of Claude Code. Nadat een kandidaat-kwetsbaarheid is gevonden, kunnen optionele post-scripts proberen deze te valideren of een proof of concept te bouwen. Het ontwerpen van die keten is regulier agent-werk in plaats van beveiligingswerk. Als prompts, tools en het doorgeven van context nog onbekend terrein voor u zijn, zal leren hoe agents worden samengesteld meer bijdragen aan uw resultaten dan welke instelling in deze handleiding dan ook.
Wat u aan het einde ontvangt, is een gerangschikte lijst met kandidaten. Behandel dit als een triage-wachtrij, niet als een rapport.
Vereisten voor aanvang
- Een VPS met Ubuntu 24.04, Debian 12 of Rocky Linux 9. De installatiedocumentatie vermeldt deze als geteste distributies, op zowel x86_64 als ARM64.
- Docker Engine met de Compose-plugin.
- Node.js 20 of nieuwer op de host, aangezien de
./krittCLI op de host draait in plaats van in een container. - Eén modelprovider: een Codex-login, of
OPENAI_API_KEY,CODEX_API_KEY,ANTHROPIC_API_KEYofOPENROUTER_API_KEY. GITHUB_TOKENalleen als u van plan bent om private repositories te scannen. De meegeleverde.env.examplestelt dit duidelijk: een GitHub-token alleen is onvoldoende om scans uit te voeren.
Installeer eerst Docker en Node 20
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USERLog uit en weer in zodat het nieuwe groepslidmaatschap wordt toegepast en bevestig daarna dat de Compose-plugin aanwezig is.
docker compose versionEen versiereeks betekent dat Compose als plugin is geïnstalleerd. docker: 'compose' is not a docker command betekent dat u in plaats daarvan het oude zelfstandige docker-compose-binarybestand heeft, en open-kritt roept docker compose aan. Lidmaatschap van de docker-groep staat gelijk aan root-toegang op de host; voeg daarom alleen het account toe dat open-kritt uitvoert. Voor een uitgebreidere versie van die configuratie, zie Docker draaien op een VPS.
Ubuntu 24.04 levert Node 18 in de eigen repository, en de CLI sluit af bij alles lager dan 20. Node 20 zelf heeft inmiddels het einde van de levensduur bereikt en ontvangt geen updates meer, dus installeer Node 22 via NodeSource. Dit voldoet aan dezelfde controle voor versie 20 of hoger.
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -vnode -v moet hier v22. weergeven, en alles onder v20. wordt door de CLI geweigerd. Op Rocky Linux 9 is het equivalent sudo dnf module enable nodejs:22 -y gevolgd door sudo dnf install -y nodejs.
Cloneer open-kritt en pin een getagde release
git clone https://github.com/Kritt-ai/open-kritt
cd open-kritt
git fetch --tags
git tag --list
git checkout v1.4.1main verplaatst zich met u mee. Een tag doet dat niet. Op 12 oktober 2026 is de nieuwste tag v1.4.1, gepubliceerd op 16 augustus 2026, en git tag --list toont wat er op de dag van het klonen bestaat. v1.4.0 (12 augustus 2026) voegde de geheugenbewuste runner-toelating toe die hieronder bij de dimensionering wordt beschreven, en v1.4.1 verhielp een bug waarbij de ranker door de gebruiker opgegeven rankingregels negeerde. Het uitchecken van een tag laat de repository in een detached HEAD-status achter; dit is correct in deze context: u behandelt deze kloon als een vastgezette implementatie, niet als een branch waaraan u wijzigingen doorvoert. Om later te upgraden, leest u de release notes, voert u git fetch --tags uit, checkt u de nieuwe tag uit en voert u ./kritt start opnieuw uit, aangezien start de images opnieuw bouwt.
Voer ./kritt niet uit met sudo. De documentatie is hier expliciet over. De CLI beheert project-lokale credential-mappen onder .data/; een uitvoering als root zorgt er dus voor dat die mappen eigendom worden van root, waardoor een volgende normale uitvoering er niet naar kan schrijven.
Toegang tot het model configureren met ./kritt setup
./kritt setupHet commando maakt .env aan vanuit .env.example als dit bestand nog niet bestaat, toont de status van elke credential en stelt u in staat deze in of uit te schakelen. De waarden worden nooit in de terminal getoond. Zowel .env als het credential-bestand van de engine worden geschreven met modus 0600.
Als u dit liever handmatig doet:
cp .env.example .env
chmod 600 .env
mkdir -p .data/codex
chmod 700 .data/codexBewerk vervolgens de provider-key in .env en zorg dat het bestand de rechten 0600 behoudt. Hoe dan ook, er bevindt zich nu een werkende provider-credential op de server; dit is een extra reden waarom de server geen andere taken zou moeten uitvoeren. Maak een key aan die uitsluitend voor dit project is bedoeld, zodat het intrekken ervan later geen andere zaken verstoort. Geheimen buiten het bereik van AI-agents houden behandelt de bredere werkwijze hiervoor.
Stel een bestedingslimiet in bij de provider vóór de eerste scan
open-kritt is ontworpen om taken te spreiden, en u betaalt voor deze spreiding. De standaardwaarden in .env.example bij v1.4.1 zijn conservatief: ENGINE_WORKER_COUNT=2, in het bestand beschreven als een conservatieve standaard voor een kleine 2-vCPU machine, en ENGINE_MAX_CONCURRENT_SCANS=1. Daarboven staan ENGINE_WORKERS_PER_ACCOUNT=15, het maximaal aantal gelijktijdige root-modelaanroepen toegestaan op één provideraccount, en ENGINE_CODEX_MAX_SUBAGENTS_PER_SESSION=5, omdat een Codex-sessie tot vijf onderliggende agents kan uitvoeren. Verhoog het aantal workers op een grotere VPS en het aantal actieve modelaanroepen stijgt mee.
Niets in de repository begrenst uw uitgaven. Er is geen budgetinstelling in .env.example. De eigen stopcondities van de engine zijn die worker-limieten plus ENGINE_HARNESS_TIMEOUT_SECONDS, die standaard op 7200 seconden per harness-run staat. Een harness is hier de lus die het model blijft aanroepen met tools en context totdat iets de run beëindigt; die time-out is dus een kloklimiet voor het programma dat rond het model is gewikkeld en geen limiet op wat het model daarbinnen uitgeeft. Het plafond moet daarom bij de provider worden ingesteld. Open de console van uw provider en stel een harde maandelijkse limiet in vóór de eerste scan, niet erna. Beheersing van de kosten van een AI-agent op een VPS doorloopt de instellingen per provider.
Er is ook een lokale rem. Het instellen van ENGINE_WORKER_COUNT=0 pauzeert het oppakken van nieuwe taken, en dezelfde worker-waarden kunnen in het instellingenscherm worden gewijzigd zodra de stack draait.
Deze handleiding noemt geen prijs per scan, omdat de kosten afhangen van de grootte van de repository, de workflow die u bouwt en het model dat erachter zit. Voer één scan uit op één kleine repository en bekijk daarna de verbruikspagina van uw provider voordat u de tool op iets groots loslaat.
De stack starten en de status controleren
./kritt startDit controleert .env en ten minste één inloggegeven, waarna docker compose up --build wordt uitgevoerd. De eerste build duurt lang, omdat de images voor de frontend, backend, engine, executor view en database worden gebouwd. Het proces draait bovendien op de voorgrond; het sluiten van de SSH-sessie stopt de stack daarom. Start deze binnen tmux, of start de stack op de achtergrond zodra de eerste build is geslaagd. Geen van beide methoden overleeft een reboot uit zichzelf. Als u wilt dat de stack na een herstart van de server automatisch weer opkomt, is het systemd-unitpatroon in een self-hosted agent actief houden na reboots direct toepasbaar.
docker compose up -d --build
docker compose psdocker compose ps hoort open-kritt-frontend, open-kritt-backend, open-kritt-engine, open-kritt-executor-view en open-kritt-db weer te geven. Controleer vervolgens of de backend antwoordt op de server zelf.
curl -s http://127.0.0.1:3002/api/healthEen JSON-antwoord betekent dat de backend actief is. Failed to connect to 127.0.0.1 port 3002: Connection refused betekent dat dit niet het geval is, en docker compose logs backend geeft de reden daarvan aan. Stop alles met docker compose down vanuit de repository-directory.
Een optionele extra: docker compose exec backend npm run seed laadt demogegevens. Dit is een eenvoudige manier om de interface te bekijken voordat u tijd of middelen investeert in een echte scan.
De UI bereiken op poort 5173 via een SSH-tunnel
Elke service in het compose-bestand bindt standaard aan 127.0.0.1: de frontend op 5173, de backend op 3002, de executor-view op 8090 en Postgres op 5432. Wijzig deze bindingen niet en forward de poort via SSH vanaf uw eigen machine.
ssh -N -L 5173:127.0.0.1:5173 you@your-server-ipOpen http://localhost:5173 in uw lokale browser terwijl dit commando draait. -N betekent dat de verbinding de forward draagt en geen shell opent. Voeg een tweede -L 8090:127.0.0.1:8090 toe aan hetzelfde commando als u ook de executor-view wilt gebruiken.
De verleiding is groot om FRONTEND_BIND_ADDRESS=0.0.0.0 in te stellen en de tunnel over te slaan. Doe dit niet. De backend heeft geen inlogscherm, dus iedereen die die pagina bereikt, kan scans starten en uw provider-tegoed verbruiken. Ter vergelijking: Vaultwarden is ontworpen om direct aan het internet te hangen, en het beveiligen ervan komt nog steeds neer op het admin-token en het back-upbestand, wat hefbomen zijn die open-kritt u niet biedt. Er schuilt nog een tweede valkuil onder: een gepubliceerde containerpoort wordt afgehandeld voordat het standaardbeleid van ufw wordt toegepast, waardoor een ufw deny 5173-regel er correct uitziet maar niets blokkeert. Docker-poorten die ufw omzeilen toont de regelketen die dit veroorzaakt.
De VPS dimensioneren
ENGINE_MIN_FREE_STORAGE_GB staat standaard op 20, en de engine weigert een nieuwe scan-container per taak te starten wanneer de vrije opslagruimte daaronder zakt. De gebouwde images, de checkout-cache, de Postgres-data en de werkmappen van de taken bevinden zich allemaal op dezelfde schijf; een VPS van 20 GB start daarom nooit een scan. Hanteer 40 GB als ondergrens en wijs meer toe als u grote repositories scant. Weersta de verleiding om de kosten van de server te drukken door er een opslagintensieve service naast te draaien, want de gemeten RAM- en schijfvereisten in deze vergelijking tussen PhotoPrism en Immich laten zien hoe snel een mediabibliotheek de ruimte opeet die een scan nodig heeft. Hetzelfde geldt voor de decoratieve extra's die naast een scanner lichtgewicht lijken: een browser-frontend die een Jellyfin-bibliotheek restylet als een videotheek uit de jaren 90 sleept alsnog een volledige mediaserver en bijbehorende transcodes mee naar de schijf; gebruik hiervoor dus een andere host.
Geheugengebruik volgt een eenvoudige rekensom. De instellingen hiervoor zijn geïntroduceerd in v1.4.0 en zijn dus van toepassing op de hierboven vastgezette tag, maar niet op oudere versies. ENGINE_MEMORY_RESERVE_GB=2 houdt geheugen achter voor de engine, de database, de API en kortstondige overhead. Elke scan-runner heeft vervolgens een zachte reservering van ENGINE_SCAN_RUNNER_MEMORY_RESERVATION_MB=1536 en een harde limiet van ENGINE_SCAN_RUNNER_MEMORY_MB=1536. Twee workers vereisen daarom ongeveer 5 GB voordat er iets anders draait. De engine laat alleen de runners toe die in het resterende budget passen; op een kleine server komen scans dus in de wachtrij te staan in plaats van te falen, wat een veel betere foutafhandeling is dan de out-of-memory killer. Dezelfde rekensom vormt de ondergrens voor elk hulpmiddel dat elke werkeenheid in een eigen container plaatst. Dit is de reden waarom OpenBot's ene container en browser per AI-collega veel eerder tegen een RAM-plafond aanloopt dan tegen een CPU-limiet.
Twee opschooninstellingen staan standaard op true: ENGINE_AUTO_PRUNE_DOCKER_BUILD_CACHE en ENGINE_AUTO_PRUNE_UNUSED_DOCKER_IMAGES. Nadat een taak is voltooid, verwijdert de engine ongebruikte build-cache, ongebruikte images en gestopte scan-containers. Images waarnaar wordt verwezen door een container, service-containers, bind mounts, databasegegevens, inloggegevens en volumes blijven behouden. Dit is nog een reden om de host niet te delen: er draait een opschoonproces dat u niet zelf heeft geconfigureerd tegen die Docker-daemon.
De engine-instellingen die de meeste gebruikers aanpassen
ENGINE_WORKER_COUNT: totaal aantal worker-slots gedeeld door scanstappen en nabewerking. Zet dit op 0 om het oppakken van nieuwe taken te pauzeren.ENGINE_MAX_CONCURRENT_SCANS: hoeveel scans er tegelijkertijd worden toegelaten. Wachtende scans wachten tot de actieve pool leeg is.ENGINE_MAX_WORKERS_PER_SCAN: 0 verdeelt de beschikbare slots gelijkmatig over de scans.ENGINE_HARNESS_TIMEOUT_SECONDS: standaard 7200. Dit is de maximale duur van een uit de hand gelopen taak. De engine accepteert waarden van 60 tot 86400; elke waarde buiten dit bereik, inclusief 0, valt terug op 7200.ENGINE_MIN_FREE_STORAGE_GB: de opslagondergrens.ENGINE_IGNORE_LOW_STORAGE=trueschakelt de beveiliging uit, en het bestand waarschuwt dat dit de schijf van de host kan vullen.ENGINE_SCAN_RUNNER_MEMORY_MB: harde geheugenlimiet per runner. 0 verwijdert de limiet.ENGINE_SCAN_RUNNER_MEMORY_RESERVATION_MB: de zachte reservering per runner die wordt meegeteld bij toelating. Het verlagen hiervan zorgt voor overcommitment van inactief geheugen, terwijl de harde limiet pieken blijft opvangen.
Een lokale repository scannen zonder datalekken
LOCAL_REPOS_PATH gebruikt standaard ./local_repos en wordt via een bind-mount read-only gekoppeld aan de backend- en engine-containers. Een repository die u in die map op de host plaatst, is daardoor direct zichtbaar in de containers. Gebruik een verse clone en niet uw actieve werkmap. De job-container krijgt een beschrijfbare kopie, voert processen uit als root en heeft toegang tot internet. Dit betekent dat alles wat zich in die kopie bevindt, kan worden gewijzigd of naar buiten kan worden verstuurd. Verwijder .env-bestanden en privésleutels voordat u een project kopieert.
Wat u ontvangt en wat niet
U ontvangt gerangschikte kandidaat-bevindingen. U ontvangt geen geverifieerde kwetsbaarheden. Rangschikking en ontdubbeling bepalen de volgorde van uw triage-wachtrij. Ze bewijzen niet dat een item daadwerkelijk bestaat. Post-scripts kunnen validatie proberen en een proof of concept opbouwen; dit is het sterkste signaal dat de tool biedt. Een post-script dat faalt, is echter geen bewijs dat de bevinding onjuist is. Een persoon beoordeelt nog steeds elke kandidaat. Die kloof tussen een kandidaat en een bewijs is de reden waarom een agent vragen om bewijs dat u zelf kunt uitvoeren hier relevant is: een bevinding die u op verzoek kunt reproduceren, is waardevoller dan een gerangschikte bevinding die u op goed vertrouwen moet aannemen.
Deze handleiding doet geen uitspraken over hoeveel echte bugs open-kritt vindt, omdat we dit niet hebben gemeten. Iedereen die een detectiepercentage voor uw codebase noemt, heeft de tool niet op uw codebase uitgevoerd. Scan eerst een repository die u al goed kent: bevindingen die u zelf kunt beoordelen, zijn de goedkoopste manier van kalibratie.
Autorisatie is hier belangrijker dan bij de meeste zelfgehoste tools. De agents compileren en voeren code uit en maken verbinding met het netwerk, dus een proof-of-concept-stap kan live systemen raken. Wijs de tool alleen aan op code die u bezit of waarvoor u een contract heeft om deze te testen, en leg het doelbereik vast voordat u iets uitvoert. Als u ANTHROPIC_API_KEY configureert en de Claude Code engine gebruikt, zijn de sandboxing-gewoonten in veilig Claude Code uitvoeren op een VPS ook van toepassing op deze agents.
FAQ
Waarom heeft open-kritt een eigen VPS nodig?
Omdat de analyse-agents als root draaien in tijdelijke job-containers met beschrijfbare kopieën van uw code en directe internettoegang, en omdat de engine-service de Docker-socket van de host mount om per job een container te kunnen starten. Elk proces dat die socket bereikt, kan een container starten die het bestandssysteem van de host mount; de gehele stack moet daarom als root op de host worden beschouwd. Op een toegewezen VPS is dat een acceptabel risico en kost het opnieuw opbouwen van de server niets. Op uw dagelijkse werkstation plaatst dit uw SSH-keys en browserprofielen binnen dezelfde vertrouwensgrens als de code die u scant.
Kan ik poort 5173 openstellen in plaats van een SSH-tunnel te gebruiken?
Dat moet u niet doen. De backend wordt geleverd zonder applicatie-authenticatie, dus de poort is het enige dat tussen het internet en uw bevindingen en provider-tegoed staat. Het compose-bestand bindt om die reden elke service aan 127.0.0.1. Voer ssh -N -L 5173:127.0.0.1:5173 you@your-server-ip uit en navigeer lokaal naar http://localhost:5173. Een ufw-regel is geen vervanging, omdat een gepubliceerde Docker-poort wordt afgehandeld voordat het standaardbeleid van ufw wordt toegepast.
Hoe voorkom ik dat open-kritt meer uitgeeft dan gepland?
Stel een harde limiet in de console van uw modelprovider in vóór de eerste scan, aangezien open-kritt zelf geen budgetinstelling heeft. Houd de meegeleverde standaardwaarden voor gelijktijdigheid aan voor de eerste paar runs, ENGINE_WORKER_COUNT=2 en ENGINE_MAX_CONCURRENT_SCANS=1, en onthoud dat één provider-account standaard tot 15 gelijktijdige root-modelaanroepen toestaat, terwijl een Codex-sessie tot vijf child-agents kan draaien. ENGINE_WORKER_COUNT=0 pauzeert het oppakken van nieuwe jobs en is de snelste lokale stopmethode.
Welke versie moet ik uitchecken?
Een tag, nooit main. git fetch --tags gevolgd door git tag --list toont wat beschikbaar is, en v1.4.1, gepubliceerd op 16 augustus 2026, is de nieuwste versie per 12 oktober 2026. Vastpinnen betekent dat een rebuild maanden later dezelfde stack oplevert, en het maakt upgraden een beslissing die u neemt na het lezen van de release notes in plaats van een bijwerking van het klonen op een andere dag.
Een scan start nooit. Wat moet ik controleren?
Controleer eerst de vrije schijfruimte, aangezien de engine geen scan-container per job start wanneer de vrije opslag onder ENGINE_MIN_FREE_STORAGE_GB komt, wat standaard 20 GB is. Controleer vervolgens of ENGINE_WORKER_COUNT niet 0 is, omdat die waarde het oppakken van nieuwe jobs pauzeert. Bevestig daarna of een model-credential daadwerkelijk is geconfigureerd door ./kritt setup uit te voeren, omdat een GITHUB_TOKEN op zichzelf geen scans kan uitvoeren. docker compose logs engine benoemt de reden waarom de job werd overgeslagen.