SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor

KiroCrew zelf hosten op een VPS: handleiding

Installeer KiroCrew als een permanente Docker-container op uw eigen VPS. Voorkom dataverlies bij reboots en beheer uw agent via systemd, SSH en veilige backups.

Waarom KiroCrew zelf hosten op een VPS in plaats van een laptop

Het zelf hosten van KiroCrew is alleen zinvol op een machine die nooit in de slaapstand gaat; daarom is een VPS de juiste plek en een laptop niet. KiroCrew slaat sessiegeschiedenis, semantisch geheugen, geplande taken en de wachtrij voor goedkeuringen op schijf op, en laadt dit alles opnieuw bij het herstarten van het proces. Dit heeft geen nut als het proces niet draait om 03:00 uur wanneer een geplande taak moet worden uitgevoerd, en een gesloten laptop voert dit niet uit.

KiroCrew is een open-source agent-werkruimte van het Kiro-team, gelicentieerd onder Apache 2.0, met 0.1.0 uitgebracht op 22 juli 2026. Eén proces, de gateway genaamd, beheert de status en serveert een webdashboard op poort 5476. U bereikt die gateway via het dashboard, via de kirocrew CLI, of via een chatkanaal zoals Slack. De gateway is het enige onderdeel dat u zelf host, dus deze handleiding gaat over het in de lucht houden ervan, het buiten het openbare internet houden en het kunnen herstellen na een mislukte upgrade.

Twee dingen om te weten voordat u begint. Sinds 0.11.0 worden nieuwe KiroCrew-installaties zonder opgeslagen harness-keuze standaard ingesteld op KAS zonder dat kiro-cli nodig is; bestaande expliciete Kiro CLI-selecties blijven behouden. Inferentie op de Kiro-backends maakt gebruik van uw Kiro-abonnement, dus vanaf 1 november 2026 is deze standaardconfiguratie niet offline. Het project is bovendien jong en ontwikkelt zich snel: de stabiele releases gingen van 0.1.3 op 5 augustus 2026 naar 0.10.0 op 25 oktober 2026, met 0.8.0 op 9 oktober en 0.9.0 op 16 oktober daartussenin, en een 0.11.0 release candidate was al beschikbaar als pre-release op 25 oktober. Ga ervan uit dat u op enig moment een rollback moet uitvoeren en installeer het op een manier die dit toelaat. Als u nog niet eerder een agent op een server heeft gedraaid, behandelt het draaien van een coding agent op een VPS de basisregels waarop deze handleiding voortbouwt. Als de agent-kant nieuw voor u is in vergelijking met de server-kant, zal leren wat een agent-loop, de tools en het geheugen daarvan daadwerkelijk zijn ervoor zorgen dat de onderstaande keuzes aanvoelen als beslissingen in plaats van als bezweringen.

Wat KiroCrew vereist en waar de status wordt opgeslagen

Een native installatie vereist Python 3.12 of nieuwer en Node.js 22.12.0 of nieuwer als u het dashboard vanuit de broncode bouwt (het project adviseert Node 24 LTS). De Kiro CLI-backend vereist kiro-cli, geauthenticeerd met kiro-cli login of een API-sleutel voor geautomatiseerd gebruik; sinds 0.10.0 draait de ingebouwde KAS-engine zonder dat kiro-cli is geïnstalleerd, en 0.11.0 maakte dit de standaard voor nieuwe installaties zonder opgeslagen harness-keuze. De containerinstallatie vereist niets van dit alles op de host. Het vereist Docker. Dat is de belangrijkste reden om de voorkeur hieraan te geven.

De status bevindt zich in ~/.kiro/crew, en de omgevingsvariabele KIROCREW_HOME verplaatst deze naar een andere locatie. Wat zich hierin bevindt:

  • config.json: gateway-instellingen en inloggegevens voor chatkanalen.
  • .env: geheimen.
  • workspace/memory/: voorkeuren, projectnotities en chatgeschiedenis.
  • memory.db en memory_index.db: de semantische en full-text indexen.
  • models/: het embedding-model, dat bij de eerste uitvoering wordt gedownload.
  • security_events.jsonl: het beveiligingsgebeurtenissenlogboek.

Die map is de installatie. Kopieer deze naar een nieuwe VPS en u heeft uw agent verplaatst; daarom is de sectie over back-ups hieronder belangrijker dan de installatiesectie.

Plan voor schijfruimte in plaats van RAM. De gateway is een Python-proces; wat de server daadwerkelijk belast, is wat de agent uitvoert, zoals een build of een testsuite. De statusmap groeit naarmate de chatgeschiedenis toeneemt en het embedding-model wordt gedownload bij de eerste start. Meet dit daarom na enkele weken op uw eigen systeem met du -sh ~/.kiro/crew, in plaats van te vertrouwen op cijfers die in de eerste maanden van een project worden gepubliceerd. Vergelijk dit met een runtime die elke worker een eigen container en een eigen browser geeft, waarbij het zelf hosten van OpenBot's AI-collega's ervoor zorgt dat dimensionering eerst een RAM-vraagstuk is en pas daarna een schijfvraagstuk.

Welk van de vier installatiepaden moet u gebruiken

Het project publiceert er vier: desktop-app, one-line wheel, broncode en Docker. De one-line installer haalt een wheel op en maakt een kirocrew launcher aan; als de map daarvan niet in uw PATH staat, toont het instructies om deze toe te voegen:

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh

Het vereist een channel-vlag en een version-vlag:

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --channel insider
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --version 0.8.0

De container-image wordt gepubliceerd op ghcr.io/kirodotdev/kirocrew, voor linux/amd64 en linux/arm64 onder elke tag. De broncode-build is git clone plus make build, en deze is bedoeld voor mensen die de code aanpassen, niet voor gebruikers die de software draaien.

Gebruik de container. Een native installatie vanuit broncode plaatst Python-pakketten en Node op dezelfde host die uw andere services draait, plus kiro-cli bij gebruik van de Kiro CLI-backend. Een mislukte upgrade dwingt u daardoor om dit handmatig te herstellen. De container houdt de runtime in één image en de status in één volume, waardoor een rollback neerkomt op een wijziging van de tag en een herstart.

Koppel de image aan een release-tag, niet aan stable

Het voorbeeld van het project zelf gebruikt de stable-tag:

docker run -d --name kirocrew \
  -p 127.0.0.1:5476:5476 \
  -v kirocrew-home:/home/kirocrew \
  ghcr.io/kirodotdev/kirocrew:stable

stable is een bewegende tag, net als latest, die naar dezelfde release verwijst. Deze tag wijst altijd naar de meest recente stabiele release. Hierdoor kan de volgende pull de versie die u draait wijzigen zonder dat u daarvoor kiest, en de tag legt niet vast welke versie dit was. Versie-tags zijn onveranderlijk, dus gebruik een specifieke versie. De nieuwste stabiele release op 1 november 2026 is 0.11.1, gepubliceerd op 31 oktober 2026; dit is een hotfix voor geheugenintegriteit en KAS-oplossingen in 0.11.0. Het 0.8.0-voorbeeld hieronder gebruikt Kiro CLI. Er zijn ook insider- en nightly-tags; nightly volgt builds van main.

Schrijf /opt/kirocrew/compose.yaml:

services:
  kirocrew:
    image: ghcr.io/kirodotdev/kirocrew:0.8.0
    container_name: kirocrew
    restart: unless-stopped
    ports:
      - "127.0.0.1:5476:5476"
    volumes:
      - kirocrew-home:/home/kirocrew

volumes:
  kirocrew-home:

Start de container en controleer vervolgens het health-endpoint dat de image ook gebruikt voor zijn eigen HEALTHCHECK:

cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/health

docker compose ps zou de container binnen ongeveer een minuut als healthy moeten rapporteren, en /api/health antwoordt zonder token (net als /api/live en /api/ready, wat ze bruikbaar maakt als probes). Als de status op starting blijft staan, lees dan docker logs kirocrew voordat u wijzigingen aanbrengt. Bij de eerste uitvoering wordt het embedding-model op de achtergrond gedownload; de geheugenzoekfunctie gebruikt trefwoordmatching totdat het model beschikbaar is.

Houd het draaiende met systemd

restart: unless-stopped zorgt ervoor dat de container na een crash en na een herstart weer opkomt, zolang Docker zelf bij het opstarten wordt geladen. Een unit-bestand maakt die afhankelijkheid expliciet en geeft u één commando om de volledige stack te stoppen voor een back-up. Een Docker Compose-stack starten bij het opstarten behandelt het algemene patroon. Dit is de KiroCrew-vorm ervan, in /etc/systemd/system/kirocrew.service:

[Unit]
Description=KiroCrew gateway
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/kirocrew
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
TimeoutStartSec=0

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now kirocrew
systemctl status kirocrew

systemctl status kirocrew hoort active (exited) te lezen, wat het gezonde resultaat is voor deze unit. Type=oneshot met RemainAfterExit=yes staat hier omdat docker compose up -d direct terugkeert zodra de container is gestart: systemd houdt bij dat de stack actief is, niet een proces op de voorgrond. Schrijf in plaats daarvan Type=simple en systemd ziet het commando direct afsluiten, markeert de service als dood en geeft het op of komt in een herstart-loop terecht, afhankelijk van uw Restart=-instelling. Voor een native installatie levert het project zijn eigen equivalent, kirocrew service install, dat /etc/systemd/system/kirocrew.service schrijft en de gateway als uw gebruiker uitvoert. Voer niet beide units tegelijk uit. De uitgebreidere versie van dit onderwerp vindt u in systemd-services en timers op een VPS. Een unit die niet terugkeert blijft stil tenzij u deze laat spreken, dus voeg een OnFailure=-handler toe die een melding naar uw eigen ntfy-server pusht en u hoort vanaf uw telefoon dat de gateway offline is, in plaats van dat u erachter komt via een geplande taak die nooit is uitgevoerd.

Eerste uitvoering: inloggen en een dashboard-token ophalen

De container start de gateway, maar de standaard Kiro CLI-runtime in de vastgezette 0.8.0-image vereist nog authenticatie. Log in binnen de container of geef KIRO_API_KEY door via de containeromgeving voor geautomatiseerd gebruik:

docker exec -it kirocrew kiro-cli login

Dit toont een apparaatcode en een URL die u in uw eigen browser opent. Genereer vervolgens een dashboard-token:

docker exec kirocrew kirocrew token --ttl 2h

De dashboard-URL is http://localhost:5476/?token=<the token>. Tokens verlopen: de getoonde link moet binnen vijf minuten na aanmaak worden geopend. Dit commando vraagt een toegangscookie aan voor twee uur, waarbij twintig uur het gedocumenteerde maximum is. De browser ontvangt ook een vernieuwingscookie met een glijdend inactief venster van 30 dagen, waardoor een actieve sessie zonder nieuwe link wordt verlengd. Een dashboard dat leeg laadt of u direct terugstuurt, heeft meestal een verlopen token; genereer in dat geval een nieuwe en open deze direct. Plak nooit een token in een ticket of chatbericht, omdat degene die het token bezit, ook uw agent beheert.

Bereik het dashboard via SSH en stel poort 5476 nooit open

Bekijk het bind-adres in het voorbeeld van het project opnieuw: -p 127.0.0.1:5476:5476. Binnen de container luistert de gateway op 0.0.0.0, omdat deze bereikbaar moet zijn via de port mapping, maar de mapping zelf publiceert alleen naar de loopback-interface op de host. Verwijder het 127.0.0.1:-voorvoegsel en de gateway staat op het openbare internet voor iedereen die die poort scant. Een ufw-regel zal u ook niet redden: Docker publiceert poorten door DNAT-regels te schrijven die het verkeer routeren voordat de regels van ufw worden toegepast, dus ufw deny 5476 doet niets bij een gepubliceerde poort. Bij de standaard iptables-backend van Docker is het antwoord van Docker zelf om filterregels in de DOCKER-USER-chain te plaatsen. Dat werkt, maar die regels zien het interne adres en de poort van de container, tenzij u filtert met de conntrack-extensie. Daarom blijft de loopback-bind de eenvoudigere methode die minder foutgevoelig is. De nftables-backend van Docker gebruikt in plaats daarvan aparte nftables-tabellen en base chains voor aangepaste filtering. Docker-poorten die ufw omzeilen doorloopt dat mechanisme.

Forward de poort in plaats daarvan vanaf uw laptop via SSH:

ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.com

Laat dit draaien en open http://localhost:5476/?token=<the token> lokaal. Om de forward automatisch bij elke verbinding te maken, plaatst u deze in ~/.ssh/config:

Host your-server.example.com
    LocalForward 5476 127.0.0.1:5476

Als poort 5476 al in gebruik is op uw laptop, wijzigt u alleen het linkergetal: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com, en navigeert u vervolgens naar http://localhost:45476/?token=.... Er is geen extra loopback-poortinstelling of het opnieuw aanmaken van de container nodig: de loopback Origin komt overeen met de eigen Host van het verzoek, waardoor de CSRF-controle deze accepteert. U zult dergelijke forwards stapelen zodra een tweede agent de server deelt, omdat self-hosting open-kritt voor security scanning een ander dashboard dat alleen via loopback toegankelijk is op dezelfde server plaatst, op poort 5173.

Twee gedocumenteerde gedragingen bepalen welke instellingen u vanuit het dashboard kunt wijzigen. Ten eerste behandelt de gateway elk verzoek dat forwarding-headers bevat (Forwarded, X-Forwarded-* of X-Real-IP) als extern, en de endpoints voor het schrijven van configuraties en het tonen van geheimen weigeren die verzoeken. Een reverse proxy voegt die headers toe; een eenvoudige ssh -L-forward voegt er geen toe, waardoor het er lokaal uitziet en op die grond niet wordt geweigerd. Ten tweede zijn in de container-image de pagina's voor channel-credentials en de weergaven voor het tonen van geheimen alleen-lezen voor elke browser die niet direct-lokaal is, en de image bevat geen teksteditor. Een channel-credential dat niet kan worden opgeslagen vanuit het dashboard is dit, geen bug. Bewerk de configuratie in plaats daarvan op de host:

docker cp kirocrew:/home/kirocrew/.kiro/crew/config.json .
# edit config.json here
docker cp config.json kirocrew:/home/kirocrew/.kiro/crew/config.json
docker exec -u 0 kirocrew chown kirocrew:kirocrew /home/kirocrew/.kiro/crew/config.json
docker restart kirocrew

Voor toegang via een telefoon wijst het project naar tailscale serve van Tailscale, dat het dashboard binnen uw eigen tailnet houdt in plaats van op een openbare hostnaam. Geef de voorkeur aan die methode boven een openbare reverse proxy. Het token reist mee in de URL, en een URL wordt in elk toegangslogboek op het pad geschreven. Die regel gaat over wat zich achter de poort bevindt in plaats van de poort zelf: iets als Halcyon, dat een Jellyfin-bibliotheek herbouwt als een doorzoekbare videotheek uit de jaren 90 bestaat om door anderen geopend te worden en is een geschikte kandidaat voor een reverse proxy, terwijl een gateway die opdrachten op uw server kan uitvoeren dat niet is.

Geef de agent de kleinst mogelijke blast radius

De container controleert bij de eerste start op ondersteuning voor sandboxing; het resultaat bepaalt of agents opdrachten kunnen uitvoeren. Als namespace-isolatie beschikbaar is, draaien agent-subprocessen in isolatie. Als dit niet beschikbaar is en KIROCREW_ALLOW_UNSANDBOXED=1 niet is ingesteld, wordt uitvoering geweigerd in plaats van ongecontroleerd uitgevoerd. Een gateway die gezond lijkt terwijl elke taak blijft hangen, wijst meestal hierop. De beslissing staat in docker logs kirocrew vanaf die eerste run. Het project publiceert ook een seccomp (secure computing mode) profiel dat u kunt toepassen:

curl -fsSL https://raw.githubusercontent.com/kirodotdev/KiroCrew/main/docker/seccomp/kirocrew-seccomp.json \
  -o /opt/kirocrew/kirocrew-seccomp.json
    security_opt:
      - seccomp:./kirocrew-seccomp.json

Op een host waar AppArmor is ingeschakeld, noemt de Docker-handleiding van het project het seccomp-profiel slechts de helft van de wijziging. Docker koppelt namelijk ook zijn docker-default AppArmor-profiel en combineert dit met apparmor=unconfined. Die optie heft alleen de per-container regels van AppArmor op; het seccomp-profiel, de verwijderde capabilities en de non-root gebruiker blijven van kracht.

Als u KIROCREW_ALLOW_UNSANDBOXED=1 instelt, wees u dan bewust van wat er verandert: de container is nu de enige grens tussen de agent en uw server. De waarschuwing van het project is het volledig herhalen waard. Koppel geen host-paden die u niet direct aan de agent zou toevertrouwen. In de praktijk sluit dit de Docker-socket, elke bind-mount van / en elke map met gegevens van een andere service uit.

De rest is het kader dat geldt voor elke agent die opdrachten mag uitvoeren. Beperk de credentials tot de specifieke repository of bucket die nodig is; gebruik nooit een persoonlijk token met rechten voor het gehele account. Laat de agent draaien als een toegewezen gebruiker wiens home-map niets anders bevat, waarvoor least privilege users on a VPS is bedoeld. Wanneer de agent code schrijft en deze vervolgens uitvoert, geef hem dan een machine die hij mag beschadigen: a disposable VM for coding agents vormt een sterkere grens dan elke vlag in dit compose-bestand, omdat u de machine verwijdert in plaats van deze op te schonen. Dezelfde redenering vormt de basis voor running OpenClaw safely on a VPS en self-hosting the Hermes agent on a VPS. Tools tellen ook mee voor de blast radius: door de agent toegang te geven tot webzoekopdrachten, wordt elke pagina die hij ophaalt niet-vertrouwde input. Daarom is pointing it at your own SearXNG instance net zozeer een beslissing over prompt injection als over de technische inrichting. Geplande taken kosten ook geld terwijl u slaapt, aangezien inferentie op de Kiro-backends uw Kiro-abonnement verbruikt. Stel daarom de limieten in die worden beschreven in controlling what an AI agent costs on a VPS voordat u een nachtelijke taak toevoegt.

Maak voor elke upgrade een back-up van het state-volume

Bepaal eerst de werkelijke volumenaam. Compose voegt de projectnaam toe als voorvoegsel aan volumes; de projectnaam is standaard de mapnaam. Een volume dat als kirocrew-home in /opt/kirocrew/compose.yaml is gedeclareerd, wordt daarom aangemaakt als kirocrew_kirocrew-home:

docker volume ls

Stop de gateway voordat u bestanden kopieert. memory.db en memory_index.db zijn SQLite-databases. Het kopiëren van een database terwijl er naar geschreven wordt, kan resulteren in een onvolledige transactie, wat bij herstel leidt tot een corrupt bestand. De eigen migratie-instructies van het project vermelden hetzelfde: verplaats gegevens alleen terwijl de gateways zijn gestopt. Deze regel geldt niet alleen voor KiroCrew; als er ook een fotoserver op de machine draait, biedt de vergelijking tussen PhotoPrism en Immich de exacte back-upcommando's die voor beide nodig zijn.

sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data:ro -v "$PWD":/backup \
  alpine tar czf /backup/kirocrew-2026-08-06.tgz -C /data .
sudo systemctl start kirocrew

Kopieer het archief van de server af. Herstellen gebeurt met hetzelfde commando, terwijl de container is gestopt en tar xzf in plaats van tar czf wordt gebruikt:

sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data -v "$PWD":/backup \
  alpine tar xzf /backup/kirocrew-2026-08-06.tgz -C /data
sudo systemctl start kirocrew

Verhuizen naar een nieuwe host is een andere taak dan lokaal herstellen, en het project is hier specifiek over. Chatgeschiedenis en projectnotities onder workspace/memory/ worden overgezet, evenals de twee databasebestanden en config.json. PID-bestanden, het beveiligingslogboek en .env zijn gekoppeld aan de oude host; laat deze achter en voer de secrets opnieuw in op de nieuwe machine.

Hoe voert u een rollback uit na een mislukte upgrade

Een upgrade is kort en alleen veilig omdat u een versie heeft vastgezet. Maak eerst een back-up en wijzig daarna de tag:

sudo systemctl stop kirocrew
# take the backup here, as above
sudo nano /opt/kirocrew/compose.yaml   # set the new image tag
sudo systemctl start kirocrew
docker compose -f /opt/kirocrew/compose.yaml ps
curl -s http://127.0.0.1:5476/api/health

docker compose up -d haalt de image op als deze nog niet op de machine staat, dus het bewerken van de tag is de volledige upgrade. Een rollback is dezelfde reeks met het oude nummer; dit geeft u exact de image die u daarvoor had, omdat versietags onveranderlijk zijn.

De binary rolt probleemloos terug. De status is het onderdeel dat dit mogelijk niet doet. Een nieuwere gateway kan config.json herschrijven of memory databases migreren naar een vorm die een oudere gateway niet kan lezen. Er is op 12 oktober 2026 geen downgrade-pad voor status gedocumenteerd. De installatiehandleiding is duidelijk over één geval: data die uit de legacy ~/.kirocrew-map is verplaatst, heeft geen rollback-mogelijkheid en een release van vóór ~/.kiro/crew zou leeg opstarten. Als de oudere image opstart en zich vervolgens vreemd gedraagt, debug deze dan niet. Stop de service, herstel de back-up die u vóór de upgrade heeft gemaakt en begin opnieuw. Dat is de enige reden waarom de back-up eerst komt, en waarom de gewoonte om nu te upgraden en later een back-up te maken bij een project van deze leeftijd faalt.

Wat hier niet bewezen is

Wees eerlijk over de ouderdom van deze software. Versie 0.1.3 werd uitgebracht op 5 augustus 2026 en op 12 oktober 2026 had de stabiele lijn 0.8.0 bereikt. De meeste release notes zijn nog steeds geautomatiseerde changelogs; de 0.8.0-notities zijn handgeschreven maar bevatten geen migratiesectie, en de openbare releasegeschiedenis beslaat ongeveer drie maanden. Niets in deze handleiding is gebaseerd op resultaten op de lange termijn, dus beschouw geheugengroei, databasegrootte en scheduler-betrouwbaarheid als zaken die u op uw eigen systeem moet meten in plaats van als aannames.

Twee gedragingen zijn het waard om zelf te testen voordat u ervan afhankelijk wordt. Ten eerste of een downgrade de status kan lezen die door een nieuwere versie is geschreven: probeer dit op een kopie van het volume wanneer het niet uitmaakt, niet tijdens een storing. Ten tweede wat de gateway doet wanneer de Kiro-aanmelding verloopt terwijl er een geplande taak moet worden uitgevoerd. Beide zijn typische onvolkomenheden die bij een jong project stilletjes tussen releases door worden gladgestreken, en beide zijn nu eenvoudig te controleren.

FAQ

Waarom opent het KiroCrew-dashboard niet op het publieke IP-adres van mijn server?

Omdat het gepubliceerde voorbeeld de poort aan de loopback-interface bindt. -p 127.0.0.1:5476:5476 koppelt de poort van de container uitsluitend aan het loopback-adres van de host, wat een bewuste keuze is. U bereikt de interface door de poort via SSH door te sturen met ssh -N -L 5476:127.0.0.1:5476 you@your-server en vervolgens http://localhost:5476/?token=<token> op uw laptop te openen. Het verwijderen van het 127.0.0.1:-voorvoegsel om de interface bereikbaar te maken, plaatst de gateway op het publieke internet. ufw zal dit verkeer niet filteren, omdat de DNAT-regels voor gepubliceerde poorten van Docker het verkeer routeren voordat de regels van ufw worden toegepast. Gebruik de DOCKER-USER-chain van Docker met de bijbehorende iptables-backend, of afzonderlijke nftables-base-chains met de nftables-backend, om gepubliceerde poorten te filteren; de loopback-binding behouden is eenvoudiger.

Waar slaat KiroCrew zijn gegevens op en waarvan moet ik een back-up maken?

Alles bevindt zich onder ~/.kiro/crew, wat in de container-image overeenkomt met /home/kirocrew/.kiro/crew, en KIROCREW_HOME verplaatst deze locatie. Maak een back-up van de gehele map of het volledige Docker-volume terwijl de gateway is gestopt. memory.db en memory_index.db zijn SQLite-databases; een kopie die wordt gemaakt terwijl de gateway schrijft, kan inconsistent zijn. Bij het verhuizen naar een nieuwe host verplaatst u workspace/memory/, de twee databasebestanden en config.json. PID-bestanden, het beveiligingsgebeurtenislogboek en .env horen bij de oude host.

Moet ik de stable-tag of een versie-tag gebruiken?

Gebruik een versie-tag. stable wijzigt telkens wanneer een nieuwe release verschijnt, waardoor de versie die u draait bij de volgende pull ongemerkt kan veranderen. De tag zelf geeft bovendien geen informatie over de actieve versie. Versie-tags zoals 0.8.0 zijn onveranderlijk (immutable), en dat is precies wat een rollback mogelijk maakt: u stelt het oude nummer weer in en krijgt exact dezelfde image terug. Per 1 november 2026 is de nieuwste stabiele release 0.11.1.

Waarom weigert mijn agent om opdrachten uit te voeren?

De container controleert bij de eerste start of sandbox-ondersteuning beschikbaar is. Als de container agent-subprocessen niet kan isoleren en KIROCREW_ALLOW_UNSANDBOXED=1 niet is ingesteld, weigert de container deze uit te voeren in plaats van ze zonder beperkingen te draaien. Hierdoor lijkt de gateway gezond, terwijl elke taak blijft steken. docker logs kirocrew toont de beslissing over de sandbox van die eerste uitvoering. Het instellen van de variabele maakt de container de enige grens tussen de agent en de host; als u deze instelt, mount dan niets wat u niet direct aan de agent zou toevertrouwen.

Heb ik een Kiro-account nodig om KiroCrew zelf te hosten?

Voor de Kiro-backends is dit per 1 november 2026 het geval. KiroCrew is vrije software onder de Apache 2.0-licentie, maar inferentie op die backends maakt gebruik van uw Kiro-abonnement. De vastgezette 0.8.0-container gebruikt Kiro CLI: voer docker exec -it kirocrew kiro-cli login uit en keur de apparaatcode goed in uw browser, of geef KIRO_API_KEY door via de containeromgeving voor geautomatiseerd gebruik. Totdat de authenticatie is geconfigureerd, start de gateway en laadt het dashboard, maar de standaard harness heeft geen model om mee te communiceren. Sinds 0.10.0 is er ook een ingebouwde KAS-engine die niet vereist dat kiro-cli is geïnstalleerd; 0.11.0 maakte KAS de standaard voor nieuwe installaties zonder opgeslagen harness-keuze, terwijl expliciete Kiro CLI-selecties behouden blijven. KAS gebruikt de eigen inlogmethode van Crew in plaats van kiro-cli login. De handleiding voor aangepaste backends van het project staat toe dat een claude-harness de belangrijkste modelinteracties naar een Anthropic-compatibel eindpunt naar keuze stuurt, maar de kiro-cli-inlogmethode blijft vereist voor Kiro-specifieke functies.

Was dit artikel nuttig?