SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor

KiroCrew su VPS: gateway sempre attivo con Docker

Configura KiroCrew su una VPS con container bloccato, systemd e SSH: memoria e job resistono ai riavvii, con backup e rollback dopo gli aggiornamenti.

Perché eseguire KiroCrew su un VPS invece che su un laptop

L'esecuzione autonoma di KiroCrew è utile solo su una macchina che non entra mai in sospensione. Per questo il VPS è la soluzione adatta, mentre il laptop non lo è. KiroCrew salva su disco la cronologia delle sessioni, la memoria semantica, i job pianificati e la coda delle approvazioni. Ricarica tutti questi dati quando il processo viene riavviato. Questi dati non servono se il processo non è in esecuzione alle 03:00, quando deve essere eseguito un job pianificato. Un laptop chiuso non esegue il processo.

KiroCrew è un workspace open source per agenti sviluppato dal team Kiro e distribuito con licenza Apache 2.0, con 0.1.0 rilasciato il 22 luglio 2026. Un unico processo, chiamato gateway, gestisce lo stato e pubblica una dashboard web sulla porta 5476. Puoi raggiungere il gateway dalla dashboard, dalla CLI kirocrew oppure da un canale di chat come Slack. Il gateway è l'unico componente che esegui autonomamente. Questa guida spiega quindi come mantenerlo in esecuzione, come non esporlo a Internet e come ripristinarlo dopo un aggiornamento non riuscito.

Prima di iniziare, devi conoscere due aspetti. A partire da 0.11.0, le nuove installazioni di KiroCrew senza una scelta del harness salvata usano KAS per impostazione predefinita e non richiedono kiro-cli. Le selezioni esplicite esistenti di Kiro CLI vengono mantenute. L'inferenza sui backend Kiro usa il tuo piano Kiro. Pertanto, al 1 novembre 2026, questa configurazione predefinita non è offline. Il progetto è inoltre recente e cambia rapidamente: le release stabili sono passate da 0.1.3 del 5 agosto 2026 a 0.10.0 del 25 ottobre 2026. Nel frattempo sono state pubblicate 0.8.0 il 9 ottobre e 0.9.0 il 16 ottobre. Inoltre, il 25 ottobre era già disponibile una release candidate 0.11.0 come pre-release. Devi prevedere la necessità di eseguire un rollback e installare il software in modo da poterlo fare. Se non hai mai eseguito un agent su un server, eseguire un coding agent su un VPS illustra le regole di base su cui si fonda questa guida. Se conosci meno il funzionamento degli agent rispetto alla gestione dei server, prima scopri che cosa sono realmente un agent loop, i suoi strumenti e la sua memoria: le scelte successive risulteranno decisioni motivate, non comandi da eseguire senza comprenderli.

Cosa richiede KiroCrew e dove risiede il suo stato

Un'installazione nativa richiede Python 3.12 o versione successiva e Node.js 22.12.0 o versione successiva se si compila la dashboard dal codice sorgente (il progetto consiglia Node 24 LTS). Il backend Kiro CLI richiede kiro-cli, autenticato con kiro-cli login oppure con una chiave API per l'uso automatizzato; da 0.10.0, il motore KAS integrato funziona senza che kiro-cli sia installato e 0.11.0 lo ha reso il valore predefinito per le nuove installazioni che non hanno una scelta dell'harness salvata. L'installazione in container non richiede nulla di tutto questo sull'host. Richiede Docker. Questo è il motivo principale per preferirla.

Lo stato risiede in ~/.kiro/crew e la variabile d'ambiente KIROCREW_HOME consente di spostarlo altrove. Il contenuto include:

  • config.json: impostazioni del gateway e credenziali dei canali di chat.
  • .env: secret.
  • workspace/memory/: preferenze, note sui progetti e cronologia delle chat.
  • memory.db e memory_index.db: gli indici semantico e full-text.
  • models/: il modello di embedding, scaricato al primo avvio.
  • security_events.jsonl: il log degli eventi di sicurezza.

Quella directory è l'installazione. Copiala su un nuovo VPS e avrai trasferito il tuo agent, per questo la sezione sul backup riportata di seguito è più importante di quella sull'installazione.

Pianifica lo spazio su disco, non la RAM. Il gateway è un processo Python; ciò che carica effettivamente il server è quello che esegue l'agent, oltre a un'eventuale compilazione o suite di test. La directory dello stato cresce con la cronologia delle chat e il modello di embedding viene scaricato al primo avvio. Per questo, dopo alcune settimane, misurala sul tuo server con du -sh ~/.kiro/crew invece di affidarti a una cifra pubblicata nei primi mesi di un progetto. Il confronto è con un runtime che assegna a ogni worker il proprio container e il proprio browser: in questo caso l'hosting autonomo dei colleghi AI di OpenBot rende la RAM il primo criterio di dimensionamento, prima ancora dello spazio su disco.

Quale dei quattro metodi di installazione scegliere

Il progetto ne pubblica quattro: applicazione desktop, wheel installabile con una sola riga, codice sorgente e Docker. L’installer a una riga scarica una wheel e crea un launcher kirocrew; se la relativa directory non è inclusa in PATH, mostra le istruzioni per aggiungerla:

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

Accetta un flag per il canale e un flag per la versione:

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

L’immagine del container è pubblicata in ghcr.io/kirodotdev/kirocrew, per linux/amd64 e linux/arm64 in ogni tag. La compilazione dal codice sorgente richiede git clone e make build ed è destinata a chi modifica il codice, non a chi deve eseguirlo.

Usa il container. Un’installazione nativa dal codice sorgente colloca i pacchetti Python e Node sullo stesso host che esegue gli altri servizi, oltre a kiro-cli quando si usa il backend Kiro CLI. Se un aggiornamento non va a buon fine, devi quindi risolvere manualmente le conseguenze. Il container mantiene il runtime in un’unica immagine e lo stato in un unico volume: per eseguire il rollback basta cambiare tag e riavviare.

Fissa l’immagine a un tag di release, non a stable

L’esempio del progetto usa il tag stable:

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

stable è un tag mobile, così come latest, che punta alla stessa release. Punta alla release stabile più recente disponibile. Di conseguenza, il pull successivo può cambiare la versione in esecuzione senza che tu lo scelga e il tag non registra quale versione fosse in uso. I tag di versione sono immutabili, quindi usane uno. La release stabile più recente al 1 novembre 2026 è 0.11.1, pubblicata il 31 ottobre 2026. Si tratta di una hot patch per l’integrità della memoria e le correzioni KAS in 0.11.0. L’esempio 0.8.0 seguente usa Kiro CLI. Sono disponibili anche i tag insider e nightly; nightly segue le build di main.

Scrivi /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:

Avvialo, quindi controlla l’endpoint health usato dall’immagine anche per il proprio HEALTHCHECK:

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

docker compose ps dovrebbe indicare che il container è integro entro circa un minuto e /api/health risponde senza token, così come /api/live e /api/ready, caratteristica che li rende utilizzabili come probe. Se lo stato rimane starting, leggi docker logs kirocrew prima di modificare qualsiasi cosa. La prima esecuzione scarica il modello di embedding in background. Fino al completamento del download, la ricerca nella memoria usa la corrispondenza per parole chiave.

Mantienilo in esecuzione con systemd

restart: unless-stopped riavvia il container dopo un arresto anomalo e dopo un riavvio, purché Docker stesso venga avviato al boot. Un file unit rende esplicita questa dipendenza e fornisce un unico comando per arrestare l'intero stack prima di un backup. Avviare uno stack Docker Compose al boot descrive il modello generale. Per KiroCrew, la configurazione è questa, 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 dovrebbe restituire active (exited), che è il risultato corretto per questa unit. Type=oneshot con RemainAfterExit=yes è corretto in questo caso perché docker compose up -d restituisce il controllo non appena il container viene avviato: systemd tiene traccia del fatto che lo stack è attivo, non di un processo in primo piano. Scrivi invece Type=simple: systemd rileva che il comando termina immediatamente, contrassegna il servizio come terminato e poi rinuncia oppure entra in un ciclo di riavvii, a seconda dell'impostazione Restart=. Per un'installazione nativa, il progetto fornisce l'equivalente, kirocrew service install, che scrive /etc/systemd/system/kirocrew.service ed esegue il gateway con il tuo utente. Non eseguire entrambe le unit. La trattazione più ampia dell'argomento è disponibile in Servizi e timer systemd su un VPS. Un'unit che non torna attiva dopo un riavvio rimane silenziosa finché non la configuri per segnalare l'errore: aggiungi un gestore OnFailure= che invia un avviso al tuo server ntfy e saprai dal telefono che il gateway è inattivo, invece di scoprirlo tramite un job pianificato che non è mai stato eseguito.

Prima esecuzione: accedere e ottenere un token per la dashboard

Il container avvia il gateway, ma il runtime predefinito di Kiro CLI nell’immagine 0.8.0 bloccata richiede ancora l’autenticazione. Accedi all’interno del container oppure passa KIRO_API_KEY tramite l’ambiente del container per l’uso automatizzato:

docker exec -it kirocrew kiro-cli login

Vengono mostrati un codice dispositivo e un URL da aprire nel browser locale. Genera quindi un token per la dashboard:

docker exec kirocrew kirocrew token --ttl 2h

L’URL della dashboard è http://localhost:5476/?token=<the token>. I token scadono: il link mostrato deve essere aperto entro cinque minuti dalla generazione. Questo comando richiede un cookie di accesso valido per due ore; il massimo documentato è venti ore. Il browser riceve anche un cookie di aggiornamento con una finestra di inattività scorrevole di 30 giorni. Una sessione attiva viene quindi rinnovata senza dover usare un altro link. Se la dashboard viene caricata vuota o reindirizza immediatamente alla schermata di accesso, nella maggior parte dei casi il token è scaduto. Generane un altro e aprilo subito. Non incollare mai un token in un ticket o in un messaggio di chat, perché chiunque lo possieda controlla il tuo agent.

Accedi alla dashboard tramite SSH e non pubblicare mai la porta 5476

Controlla di nuovo l'indirizzo di bind nell'esempio del progetto: -p 127.0.0.1:5476:5476. All'interno del container, il gateway è in ascolto su 0.0.0.0, perché deve essere raggiungibile tramite il port mapping. Il mapping, però, pubblica la porta soltanto sull'interfaccia loopback dell'host. Elimina il prefisso 127.0.0.1: e il gateway sarà esposto su Internet a chiunque esegua la scansione di quella porta. Una regola ufw non ti protegge comunque: Docker pubblica le porte scrivendo regole DNAT che instradano il traffico prima dell'applicazione delle regole di ufw, quindi ufw deny 5476 non ha alcun effetto su una porta pubblicata. Con il backend iptables predefinito di Docker, la soluzione prevista da Docker consiste nell'inserire le regole di filtraggio nella propria catena DOCKER-USER. Funziona, ma queste regole vedono l'indirizzo e la porta interni del container, a meno che non si usi l'estensione conntrack per la corrispondenza. Il bind sull'interfaccia loopback resta quindi il controllo più semplice e meno soggetto a errori. Il backend nftables di Docker usa invece tabelle nftables e catene base separate per il filtraggio personalizzato. Porte Docker che bypassano ufw descrive questo meccanismo.

Inoltra la porta tramite SSH dal tuo laptop:

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

Lascia il comando in esecuzione e apri localmente http://localhost:5476/?token=<the token>. Per rendere automatico il forwarding a ogni connessione, inseriscilo in ~/.ssh/config:

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

Se la porta 5476 è già in uso sul laptop, modifica soltanto il numero a sinistra: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com, quindi apri http://localhost:45476/?token=... nel browser. Non servono altre impostazioni per la porta loopback né la ricreazione del container: l'Origin loopback corrisponde all'Host della richiesta, quindi il controllo CSRF la accetta. Dovrai usare forwarding di questo tipo non appena un secondo agent condividerà il server, perché self-hosting di open-kritt per la scansione di sicurezza aggiunge sullo stesso server un'altra dashboard accessibile soltanto tramite loopback, sulla porta 5173.

Due comportamenti documentati determinano quali impostazioni puoi modificare dalla dashboard. Innanzitutto, il gateway considera remota qualsiasi richiesta che includa header di forwarding (Forwarded, X-Forwarded-* o X-Real-IP) e rifiuta tali richieste sugli endpoint di scrittura della configurazione e di rivelazione dei secret. Un reverse proxy aggiunge questi header; un forwarding ssh -L semplice non ne aggiunge, quindi viene considerato locale e non viene rifiutato per questo motivo. Inoltre, nell'immagine del container, le pagine delle credenziali dei canali e le viste che rivelano i secret sono di sola lettura per qualsiasi browser che non sia direttamente locale, e l'immagine non include alcun editor di testo. Se una credenziale del canale non può essere salvata dalla dashboard, questo comportamento è previsto e non indica un bug. Modifica invece la configurazione sull'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

Per l'accesso da telefono, il progetto indica tailscale serve di Tailscale, che mantiene la dashboard all'interno del tuo tailnet invece di esporla tramite un hostname pubblico. Preferisci questa soluzione a un reverse proxy pubblico. Il token viaggia nell'URL e l'URL viene scritto in ogni access log attraversato dalla richiesta. Questa regola riguarda ciò che si trova dietro la porta, non la porta in sé: una soluzione come Halcyon, che ricostruisce una libreria Jellyfin come videoteca degli anni '90 consultabile è destinata all'accesso di altre persone ed è quindi una candidata adatta per un reverse proxy, mentre un gateway in grado di eseguire comandi sul server non lo è.

Assegna all'agente il perimetro di impatto più ridotto possibile

Al primo avvio, il container verifica il supporto della sandbox. Il risultato determina se gli agenti possono eseguire attività. Se l'isolamento tramite namespace è disponibile, i sottoprocessi dell'agente vengono eseguiti in isolamento. Se non è disponibile e KIROCREW_ALLOW_UNSANDBOXED=1 non è impostato, l'esecuzione viene rifiutata invece di procedere senza isolamento. Per questo, quando un gateway sembra funzionare ma ogni attività resta bloccata, questa è spesso la causa. La decisione viene salvata in docker logs kirocrew durante la prima esecuzione. Il progetto pubblica anche un profilo seccomp (secure computing mode) che puoi applicare:

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

Su un host con AppArmor abilitato, la guida Docker del progetto considera il profilo seccomp solo metà della configurazione, perché Docker applica anche il profilo AppArmor docker-default e lo abbina a apparmor=unconfined. Questa opzione rimuove soltanto le regole AppArmor specifiche del container; il profilo seccomp, le capability rimosse e l'utente non root continuano ad applicarsi.

Se imposti KIROCREW_ALLOW_UNSANDBOXED=1, chiarisci cosa cambia: il container diventa l'unico confine tra l'agente e il server. Vale la pena ripetere integralmente l'avviso del progetto. Non montare percorsi dell'host che non consegneresti direttamente all'agente. In pratica, questo esclude il socket Docker, qualsiasi bind mount di / e qualsiasi directory che contenga i dati di un altro servizio.

Il resto costituisce la configurazione di base applicabile a ogni agente autorizzato a eseguire comandi. Limita le sue credenziali al singolo repository o al singolo bucket necessario. Non usare mai un token personale con autorizzazioni sull'intero account. Eseguilo con un utente dedicato, la cui home non contenga altro: è lo scopo di utenti con privilegi minimi su un VPS. Quando l'agente scrive codice e poi lo esegue, assegnagli una macchina che possa danneggiare: una VM usa e getta per gli agenti di coding offre un confine più solido di qualsiasi flag presente in questo file compose, perché puoi eliminarla invece di ripulirla. Lo stesso principio si applica a eseguire OpenClaw in sicurezza su un VPS e a self-hosting dell'agente Hermes su un VPS. Anche gli strumenti contribuiscono al perimetro di impatto: dare all'agente accesso alla ricerca web trasforma ogni pagina recuperata in input non attendibile. Per questo, indirizzarlo alla propria istanza SearXNG è una decisione legata alla prompt injection tanto quanto all'integrazione tecnica. Le attività pianificate possono inoltre generare costi mentre dormi, perché l'inferenza sui backend Kiro utilizza il tuo piano Kiro. Imposta quindi i limiti descritti in controllare il costo di un agente AI su un VPS prima di aggiungere un'attività notturna.

Eseguire il backup del volume di stato prima di ogni aggiornamento

Prima individuare il nome effettivo del volume. Compose antepone ai volumi denominati il nome del progetto, che per impostazione predefinita corrisponde al nome della directory. Di conseguenza, il volume dichiarato come kirocrew-home in /opt/kirocrew/compose.yaml viene creato come kirocrew_kirocrew-home:

docker volume ls

Arrestare il gateway prima di copiare qualsiasi file. memory.db e memory_index.db sono database SQLite. Copiare un database mentre è in corso una scrittura può acquisire una transazione incompleta, che durante il ripristino produce un file danneggiato. Anche le istruzioni di migrazione del progetto indicano la stessa procedura: spostare la memoria solo quando i gateway sono arrestati. Questa regola di arrestare prima il servizio non è specifica di KiroCrew. Se sullo stesso host è presente un server fotografico, il confronto tra PhotoPrism e Immich riporta i comandi di backup esatti richiesti da ciascuno dei due.

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

Copiare l'archivio fuori dall'host. Il ripristino usa lo stesso comando, con il container arrestato e tar xzf al posto di tar czf:

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

La migrazione a un nuovo host è un'operazione diversa dal ripristino sullo stesso host, e il progetto fornisce indicazioni specifiche. La cronologia delle chat e le note dei progetti in workspace/memory/ vengono trasferite, così come i due file di database e config.json. I file PID, il log degli eventi di sicurezza e .env sono associati al vecchio host. Non trasferirli e inserire nuovamente i secret sul nuovo host.

Come eseguire il rollback di un aggiornamento non riuscito

L'aggiornamento è rapido ed è sicuro solo perché è stata bloccata una versione specifica. Eseguire prima il backup, quindi modificare il 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 scarica l'immagine se non è già presente sulla macchina, quindi la modifica del tag costituisce l'intero aggiornamento. Il rollback segue la stessa sequenza con il vecchio numero e fornisce l'esatta immagine utilizzata in precedenza, poiché i tag di versione sono immutabili.

Il binario esegue il rollback in modo pulito. Lo stato è la parte che potrebbe non farlo. Un gateway più recente può sovrascrivere config.json o migrare i database in memoria in un formato che un gateway precedente non è in grado di leggere; al 12 ottobre 2026 non è documentato alcun percorso di downgrade per lo stato. La guida all'installazione è esplicita su un caso: i dati spostati fuori dalla directory home legacy ~/.kirocrew non prevedono rollback e una versione precedente a ~/.kiro/crew si avvierebbe vuota. Pertanto, se l'immagine precedente si avvia ma presenta comportamenti anomali, non tentare il debug. Arrestarla, ripristinare il backup effettuato prima dell'aggiornamento e riavviare. Questo è il motivo principale per cui il backup deve precedere l'operazione ed è il motivo per cui l'abitudine di aggiornare subito ed eseguire il backup in seguito fallisce in un progetto così recente.

Cosa non è dimostrato qui

Siate realistici sull'età di questo software. La versione 0.1.3 è stata rilasciata il 5 agosto 2026 e, al 12 ottobre 2026, la linea stabile aveva raggiunto 0.8.0. La maggior parte delle note di rilascio è ancora costituita da changelog generati automaticamente; le note di 0.8.0 sono redatte manualmente, ma non contengono una sezione sulla migrazione, e la cronologia pubblica dei rilasci copre circa tre mesi. Nulla di quanto descritto in questa guida è un risultato osservato nel lungo periodo. Considerate quindi la crescita della memoria, le dimensioni del database e l'affidabilità dello scheduler come aspetti da misurare sul vostro server, non come valori da dare per scontati.

Prima di fare affidamento su questi comportamenti, è opportuno verificarne personalmente due. Primo: controllate se un downgrade riesce a leggere lo stato scritto da una versione più recente. Eseguite la prova su una copia del volume, quando un eventuale problema non ha conseguenze, non durante un'interruzione del servizio. Secondo: verificate cosa fa il gateway quando l'accesso a Kiro scade mentre è prevista l'esecuzione di un job pianificato. Entrambi sono esempi di problemi tipici di un progetto giovane, che possono essere risolti discretamente tra un rilascio e l'altro. In entrambi i casi, verificarli ora richiede poco tempo.

FAQ

Perché la dashboard di KiroCrew non si apre sull'IP pubblico del mio server?

Perché l'esempio pubblicato associa la porta all'interfaccia loopback. -p 127.0.0.1:5476:5476 associa la porta del container soltanto all'indirizzo loopback dell'host; è una scelta intenzionale. Per raggiungerla, inoltra la porta tramite SSH con ssh -N -L 5476:127.0.0.1:5476 you@your-server, quindi apri http://localhost:5476/?token=<token> sul laptop. Rimuovere il prefisso 127.0.0.1: per renderla raggiungibile espone il gateway su Internet pubblico e ufw non lo filtrerà, perché le regole DNAT delle porte pubblicate da Docker instradano il traffico prima dell'applicazione delle regole di ufw. Per filtrare le porte pubblicate, usa la catena DOCKER-USER di Docker con il relativo backend iptables oppure catene base nftables separate con il relativo backend nftables; mantenere l'associazione all'interfaccia loopback è più semplice.

Dove salva i dati KiroCrew e di cosa devo eseguire il backup?

Tutto si trova in ~/.kiro/crew, che corrisponde a /home/kirocrew/.kiro/crew nell'immagine del container, e KIROCREW_HOME ne modifica il percorso. Esegui il backup dell'intera directory o dell'intero volume Docker, con il gateway arrestato. memory.db e memory_index.db sono database SQLite, quindi una copia eseguita mentre il gateway scrive può risultare incoerente. Quando esegui la migrazione su un nuovo host, workspace/memory/, i due file di database e config.json vengono trasferiti, mentre i file PID, il log degli eventi di sicurezza e .env appartengono al vecchio host.

Devo usare il tag stable o un tag di versione?

Usa un tag di versione. stable cambia ogni volta che viene rilasciata una nuova versione, quindi la versione in esecuzione può cambiare al pull successivo e il tag, da solo, non indica quale versione è in esecuzione. I tag di versione come 0.8.0 sono immutabili. È proprio questo che consente un rollback: ripristini il numero precedente e ottieni la stessa immagine. Al 1 novembre 2026, l'ultima release stabile è 0.11.1.

Perché il mio agent rifiuta di eseguire qualsiasi comando?

Al primo avvio, il container verifica la disponibilità del sandboxing. Se non riesce a isolare i sottoprocessi dell'agent e KIROCREW_ALLOW_UNSANDBOXED=1 non è impostata, rifiuta di eseguirli invece di avviarli senza isolamento. Di conseguenza, il gateway risulta operativo, ma ogni attività resta bloccata. docker logs kirocrew mostra la decisione relativa al sandboxing presa durante quella prima esecuzione. Impostando la variabile, il container diventa l'unico confine tra l'agent e l'host. Pertanto, se la imposti, monta soltanto ciò che consegneresti direttamente all'agent.

Mi serve un account Kiro per eseguire il self-hosting di KiroCrew?

Per i backend Kiro, sì, al 1 novembre 2026. KiroCrew è software libero distribuito con licenza Apache 2.0, ma l'inferenza su questi backend usa il tuo piano Kiro. Il container 0.8.0, fissato a una versione specifica, usa Kiro CLI: esegui docker exec -it kirocrew kiro-cli login e approva il codice del dispositivo nel browser, oppure passa KIRO_API_KEY tramite l'ambiente del container per l'uso automatizzato. Finché l'autenticazione non è configurata, il gateway si avvia e la dashboard viene caricata, ma il relativo harness predefinito non dispone di alcun modello con cui comunicare. A partire da 0.10.0 è disponibile anche un motore KAS integrato, che non richiede l'installazione di kiro-cli; 0.11.0 ha reso KAS il valore predefinito per le nuove installazioni prive di una scelta di harness salvata, mantenendo le selezioni esplicite di Kiro CLI. KAS usa l'accesso dell'account Crew anziché kiro-cli login. La guida del progetto per i backend personalizzati consente a un harness claude di inviare i turni principali del modello a un endpoint compatibile con Anthropic scelto da te, ma l'accesso kiro-cli resta comunque necessario per le funzionalità specifiche di Kiro.

Questo articolo ti è stato utile?