Self-host KiroCrew sa VPS para laging tumakbo
Alamin kung paano patakbuhin ang KiroCrew gateway sa sariling VPS gamit ang Docker, systemd, SSH, backups, at rollback para manatili ang memory at schedules pagkatapos ng reboot.
Bakit i-self-host ang KiroCrew sa isang VPS sa halip na sa laptop
Sulit lamang ang pag-self-host ng KiroCrew sa isang machine na hindi kailanman natutulog, kaya VPS ang tamang paglagyan nito at hindi laptop. Naka-save sa disk ang session history, semantic memory, scheduled jobs, at approval queue ng KiroCrew, at nilo-load nitong muli ang lahat ng iyon kapag nag-restart ang process. Walang silbi ang mga ito kung hindi tumatakbo ang process sa 03:00 kapag nakatakdang tumakbo ang isang scheduled job, at hindi ito tumatakbo kapag nakasara ang laptop.
Ang KiroCrew ay isang open source agent workspace mula sa Kiro team, na may Apache 2.0 license, kasama ang 0.1.0 na inilabas noong 22 July 2026. Isang process, na tinatawag na gateway, ang nagmamay-ari ng state at naghahatid ng web dashboard sa port 5476. Maa-access mo ang gateway na iyon mula sa dashboard, sa kirocrew CLI, o sa isang chat channel gaya ng Slack. Ang gateway lamang ang sini-self-host mo, kaya tungkol ang gabay na ito sa pagpapanatili nitong tumatakbo, pagpapanatili nitong hindi naa-access mula sa public internet, at pagbabalik nito pagkatapos ng isang maling upgrade.
Dalawang bagay ang dapat mong malaman bago magsimula. Simula sa 0.11.0, ang mga bagong KiroCrew install na walang naka-save na harness choice ay naka-default sa KAS nang hindi kailangan ang kiro-cli; pinapanatili naman ang mga dati nang tahasang piniling Kiro CLI. Ginagamit ng inference sa Kiro backends ang iyong Kiro plan, kaya as of 1 November 2026, hindi offline ang default setup na ito. Bata pa rin ang project at mabilis itong nagbabago: ang stable releases nito ay nagmula sa 0.1.3 noong 5 August 2026 at umabot sa 0.10.0 noong 25 October 2026, na may 0.8.0 noong 9 October at 0.9.0 noong 16 October sa pagitan ng mga ito, at mayroon nang 0.11.0 release candidate bilang pre-release noong 25 October. Ipagpalagay na kakailanganin mong mag-roll back sa isang punto, at i-install ito sa paraang magbibigay-daan sa iyo na gawin iyon. Kung hindi ka pa nakapagpatakbo ng agent sa isang server, ipinapaliwanag ng pagpapatakbo ng coding agent sa isang VPS ang mga pangunahing tuntunin na pinagbabatayan ng gabay na ito. Kung mas bago sa iyo ang agent side kaysa sa server side, makatutulong na basahin muna ang pag-unawa sa kung ano talaga ang agent loop, mga tool nito, at memory nito upang ang mga pagpipilian sa ibaba ay mabasa mo bilang mga desisyon, hindi bilang mga utos na basta inuulit.
Mga kailangan ng KiroCrew at kung saan naka-store ang state nito
Ang native install ay nangangailangan ng Python 3.12 o mas bago at Node.js 22.12.0 o mas bago kung bina-build mo ang dashboard mula sa source (inirerekomenda ng project ang Node 24 LTS). Kailangan ng Kiro CLI backend ang kiro-cli, na ina-authenticate gamit ang kiro-cli login o isang API key para sa automated use; dahil sa 0.10.0, gumagana ang built-in na KAS engine nang hindi naka-install ang kiro-cli, at ginawa itong default ng 0.11.0 para sa mga bagong install na walang naka-save na harness choice. Walang kailangan sa mga iyon ang container install sa host. Docker ang kailangan nito. Ito ang pangunahing dahilan para piliin ito.
Nasa ~/.kiro/crew ang state, at inililipat ito ng environment variable na KIROCREW_HOME sa ibang lokasyon. Narito ang laman nito:
config.json: mga gateway setting at credential ng chat channel..env: mga secret.workspace/memory/: mga preference, project note, at chat history.memory.dbatmemory_index.db: mga semantic at full-text index.models/: ang embedding model na dina-download sa unang run.security_events.jsonl: ang security event log.
Ang directory na iyon ang mismong install. Kopyahin ito sa isang bagong VPS at nailipat mo na ang iyong agent. Ito ang dahilan kung bakit mas mahalaga ang backup section sa ibaba kaysa sa install section.
Magplano batay sa disk, hindi sa RAM. Python process ang gateway; ang aktuwal na naglo-load sa machine ay ang anumang pinapatakbo ng agent, build, o test suite. Lumalaki ang state directory kasabay ng chat history, at dumarating ang embedding model sa unang start. Kaya sukatin ito sa sarili mong machine gamit ang du -sh ~/.kiro/crew pagkalipas ng ilang linggo, sa halip na umasa sa anumang figure na inilathala sa mga unang buwan ng project. Ihambing ito sa runtime na nagbibigay sa bawat worker ng sariling container at sariling browser, kung saan ang pag-self-host ng AI coworkers ng OpenBot ay ginagawang RAM muna ang pangunahing sizing concern bago disk.
Alin sa apat na install path ang dapat mong gamitin
Apat ang inilalabas ng project: desktop app, one-line wheel, source, at Docker. Nagda-download ang one-line installer ng wheel at gumagawa ng kirocrew launcher. Kung wala ang directory nito sa iyong PATH, nagpi-print ito ng mga tagubilin para idagdag ito:
curl -fsSL https://download.crew.kiro.dev/cli.sh | shTumatanggap ito ng channel flag at version flag:
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.0Naka-publish ang container image sa ghcr.io/kirodotdev/kirocrew para sa linux/amd64 at linux/arm64 sa bawat tag. Binubuo ang source gamit ang git clone at make build. Para ito sa mga nagbabago ng code, hindi sa mga nagpapatakbo nito.
Gamitin ang container. Sa native source install, napupunta ang Python packages at Node sa parehong host na nagpapatakbo ng iba mong serbisyo, pati ang kiro-cli kapag ginagamit ang Kiro CLI backend. Kapag nagkaproblema ang upgrade, kailangan mong ayusin nang mano-mano ang mga pagbabagong iyon. Pinananatili ng container ang runtime sa isang image at ang state sa isang volume. Dahil dito, rollback ay pagpapalit lang ng tag at pag-restart.
I-pin ang image sa release tag, hindi sa stable
Ginagamit ng sariling halimbawa ng proyekto ang stable tag:
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stableMoving tag ang stable, at ganoon din ang latest, na tumutukoy sa parehong release. Tumatakbo ito sa anumang pinakabagong stable release, kaya maaaring magbago ang bersyon na ginagamit mo sa susunod na pull nang hindi mo ito pinipili. Wala ring itinatala ang tag tungkol sa bersyong iyon. Immutable ang mga version tag, kaya mag-pin ng isa. Ang pinakabagong stable release noong 1 November 2026 ay 0.11.1, na inilathala noong 31 October 2026. Isa itong hot patch para sa memory integrity at mga KAS fix sa 0.11.0. Ginagamit ng 0.8.0 halimbawa sa ibaba ang Kiro CLI. Mayroon ding insider at nightly tags; sinusundan ng nightly ang mga build mula sa main.
Isulat ang /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:Simulan ito, pagkatapos ay suriin ang health endpoint na ginagamit din ng image para sa sarili nitong HEALTHCHECK:
cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/healthDapat iulat ng docker compose ps na healthy ang container sa loob ng humigit-kumulang isang minuto, at sumasagot ang /api/health nang walang token. Ganoon din ang /api/live at /api/ready, kaya magagamit ang mga ito bilang probes. Kung mananatili ang state sa starting, basahin ang docker logs kirocrew bago magbago ng anuman. Sa unang pag-run, dina-download sa background ang embedding model. Keyword matching muna ang ginagamit ng memory search hanggang matapos ang pag-download nito.
Panatilihin itong tumatakbo gamit ang systemd
restart: unless-stopped ibinabalik ang container pagkatapos ng crash at reboot, basta awtomatikong nagsisimula ang Docker sa boot. Ginagawang malinaw ng unit file ang dependency na ito at nagbibigay ito sa iyo ng isang command na humihinto sa buong stack bago ang backup. Sinasaklaw ng Pagsisimula ng Docker Compose stack sa boot ang pangkalahatang pattern. Ganito ang anyo nito para sa KiroCrew, sa /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.targetsudo systemctl daemon-reload
sudo systemctl enable --now kirocrew
systemctl status kirocrewDapat maging active (exited) ang systemctl status kirocrew, na siyang tamang resulta para sa unit na ito. Tama ang Type=oneshot kasama ang RemainAfterExit=yes rito dahil agad na bumabalik ang docker compose up -d kapag nagsimula na ang container: sinusubaybayan ng systemd ang katotohanang naka-up ang stack, hindi ang isang foreground process. Kung Type=simple ang isusulat mo sa halip, makikita ng systemd na agad na lumabas ang command, mamarkahan nitong dead ang service, at pagkatapos ay maaaring sumuko o paulit-ulit itong i-restart depende sa iyong setting na Restart=. Para sa native install, kasama sa release ng project ang katumbas nitong kirocrew service install, na nagsusulat ng /etc/systemd/system/kirocrew.service at nagpapatakbo ng gateway bilang iyong user. Huwag patakbuhin ang dalawang unit. Nasa systemd services at timers sa isang VPS ang mas malawak na bersyon ng paksang ito. Tahimik ang isang unit na hindi muling nagsisimula maliban kung gagawin mo itong maglabas ng alert, kaya magdagdag ng OnFailure= handler na nagpapadala ng alert sa sarili mong ntfy server upang malaman mo sa phone na down ang gateway, sa halip na mula sa isang scheduled job na hindi kailanman tumakbo.
Unang pagtakbo: mag-sign in at kumuha ng dashboard token
Sinisimulan ng container ang gateway, pero kailangan pa ring mag-authenticate ng default na Kiro CLI runtime sa naka-pin na 0.8.0 image. Mag-sign in sa loob ng container, o ipasa ang KIRO_API_KEY sa environment ng container para sa automated na paggamit:
docker exec -it kirocrew kiro-cli loginNagpi-print ito ng device code at URL na bubuksan mo sa sarili mong browser. Pagkatapos, gumawa ng dashboard token:
docker exec kirocrew kirocrew token --ttl 2hAng dashboard URL ay http://localhost:5476/?token=<the token>. Nag-e-expire ang mga token: dapat buksan ang naka-print na link sa loob ng limang minuto matapos gumawa ng token, at humihiling ang command na ito ng access cookie na valid nang dalawang oras; dalawampung oras ang dokumentadong maximum. Tumatanggap din ang browser ng refresh cookie na may 30-araw na sliding idle window, kaya awtomatikong nari-renew ang aktibong session nang hindi na kailangan ng panibagong link. Karaniwang expired na token ang dahilan kung blanko ang dashboard o agad kang ibinabalik sa labas. Gumawa ng panibagong token at buksan agad ang link. Huwag kailanman mag-paste ng token sa ticket o chat message, dahil sinumang may hawak nito ay may hawak ng iyong agent.
I-access ang dashboard sa pamamagitan ng SSH, at huwag kailanman i-publish ang port 5476
Tingnan muli ang bind address sa example ng project: -p 127.0.0.1:5476:5476. Sa loob ng container, nakikinig ang gateway sa 0.0.0.0 dahil kailangan itong maabot sa pamamagitan ng port mapping, pero ang mapping mismo ay nagpu-publish lamang sa loopback ng host. Kapag tinanggal mo ang prefix na 127.0.0.1:, magiging available ang gateway sa public internet para sa sinumang mag-scan sa port na iyon. Hindi ka rin maililigtas ng ufw rule: nagpa-publish ang Docker ng mga port sa pamamagitan ng pagsulat ng DNAT rules na nagra-route ng traffic bago mailapat ang rules ng ufw, kaya walang epekto ang ufw deny 5476 sa isang published port. Sa default na iptables backend ng Docker, ang sariling solusyon ng Docker ay maglagay ng filtering rules sa chain nitong DOCKER-USER. Gumagana ito, pero nakikita ng mga rule na iyon ang internal address at port ng container maliban kung gagamit ka ng conntrack extension sa matching. Kaya mas simple ang loopback bind at mas maliit ang posibilidad na magkamali. Sa halip, gumagamit ang nftables backend ng Docker ng magkahiwalay na nftables table at base chain para sa custom filtering. Ipinapaliwanag ng Mga port ng Docker na lumalampas sa ufw ang mekanismong ito.
I-forward ang port sa SSH mula sa iyong laptop:
ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.comPanatilihing tumatakbo iyon at buksan ang http://localhost:5476/?token=<the token> nang lokal. Para awtomatikong gawin ang forward sa bawat connection, ilagay ito sa ~/.ssh/config:
Host your-server.example.com
LocalForward 5476 127.0.0.1:5476Kung ginagamit na sa iyong laptop ang port 5476, ang kaliwang numero lamang ang palitan: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com, pagkatapos ay mag-browse sa http://localhost:45476/?token=.... Hindi kailangan ng dagdag na loopback-port setting o pag-recreate ng container: tumutugma ang loopback Origin sa sariling Host ng request, kaya tinatanggap ito ng CSRF check. Gagamit ka ng magkakapatong na forward na ganito kapag may ikalawang agent nang mag-share sa server, dahil ang self-hosting ng open-kritt para sa security scanning ay naglalagay ng isa pang loopback-only dashboard sa parehong server, sa port 5173.
Dalawang documented behavior ang nagtatakda kung aling settings ang maaari mong baguhin mula sa dashboard. Una, itinuturing ng gateway na remote ang anumang request na may forwarding headers (Forwarded, X-Forwarded-* o X-Real-IP), at tinatanggihan ng mga config-write at secret-reveal endpoint nito ang mga request na iyon. Idinadagdag ng reverse proxy ang mga header na iyon; walang idinadagdag ang plain ssh -L forward, kaya itinuturing itong local at hindi tinatanggihan dahil sa kadahilanang iyon. Ikalawa, sa container image, read-only ang mga channel-credential page at secret-revealing view para sa browser na hindi direct-local, at walang kasamang text editor ang image. Kung hindi ma-save mula sa dashboard ang isang channel credential, ito ang dahilan, hindi ito bug. I-edit na lang ang config sa 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 kirocrewPara sa access mula sa phone, itinuturo ng project ang tailscale serve ng Tailscale, na nagpapanatili sa dashboard sa loob ng sarili mong tailnet sa halip na ilagay ito sa public hostname. Mas piliin ito kaysa sa public reverse proxy. Naglalakbay ang token sa URL, at naitatala ang URL sa bawat access log na dinaanan nito. Ang tuntuning ito ay tungkol sa serbisyong nasa likod ng port, hindi sa port mismo: ang gaya ng Halcyon, na nagre-rebuild ng Jellyfin library bilang isang browsable na 90s video store ay ginawa para buksan ng ibang tao at angkop para sa reverse proxy, samantalang hindi ang gateway na maaaring magpatakbo ng mga command sa iyong server.
Bigyan ang agent ng pinakamaliit na blast radius na posible
Sa unang pagsisimula, sinusuri ng container kung suportado ang sandbox. Batay sa resulta nito kung maaaring magsagawa ng anuman ang mga agent. Kung available ang namespace isolation, isolated na tumatakbo ang mga subprocess ng agent. Kung hindi ito available at hindi nakatakda ang KIROCREW_ALLOW_UNSANDBOXED=1, tinatanggihan ang execution sa halip na patakbuhin nang walang isolation. Kaya kung mukhang healthy ang gateway pero natitigil ang bawat task, karaniwang ito ang dahilan. Nasa docker logs kirocrew ang desisyong ito mula sa unang run. Naglalabas din ang project ng seccomp (secure computing mode) profile na maaari mong ilapat:
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.jsonSa host na naka-enable ang AppArmor, sinasabi sa Docker guide ng project na kalahati lamang ng pagbabago ang seccomp profile. Nag-a-attach din ang Docker ng sarili nitong docker-default AppArmor profile, at ipinapareha nito ang profile sa apparmor=unconfined. Tinatanggal lamang ng option na iyon ang per-container rules ng AppArmor. Nananatili pa rin ang seccomp profile, ang mga capability na dine-drop, at ang non-root user.
Kung itatakda mo ang KIROCREW_ALLOW_UNSANDBOXED=1, maging malinaw sa naging pagbabago: ang container na lamang ang boundary sa pagitan ng agent at ng server mo. Mahalagang ulitin nang buo ang babala ng project. Huwag mag-mount ng host paths na hindi mo direktang ipagkakatiwala sa agent. Sa praktika, hindi dapat kasama rito ang Docker socket, anumang bind mount ng /, at anumang directory na naglalaman ng data ng ibang service.
Ang natitirang bahagi ay ang mga panuntunang nalalapat sa bawat agent na pinapayagang magpatakbo ng mga command. Limitahan ang credentials nito sa isang repository o isang bucket lamang na kailangan nito. Huwag gumamit ng personal token na may account-wide rights. Patakbuhin ito bilang dedicated user na walang ibang laman sa home directory nito. Ito ang layunin ng mga user na may pinakamababang privilege sa isang VPS. Kapag nagsusulat ng code ang agent at pagkatapos ay pinapatakbo nito ang code na iyon, bigyan ito ng machine na maaari nitong masira: mas matibay na boundary ang disposable VM para sa mga coding agent kaysa sa anumang flag sa compose file na ito, dahil dine-delete mo ang VM sa halip na linisin ito. Gayon din ang batayan ng ligtas na pagpapatakbo ng OpenClaw sa isang VPS at self-hosting ng Hermes agent sa isang VPS. Bahagi rin ng blast radius ang mga tool. Kapag binigyan ang agent ng web search, nagiging untrusted input ang bawat page na kinukuha nito. Kaya ang pagkonekta nito sa sarili mong SearXNG instance ay desisyon ukol sa prompt injection, hindi lamang sa plumbing. Gumagastos din ang scheduled work habang natutulog ka, dahil ginagamit ng inference sa Kiro backends ang Kiro plan mo. Itakda muna ang mga limitasyong inilalarawan sa pagkontrol sa gastos ng AI agent sa isang VPS bago magdagdag ng nightly job.
I-back up ang state volume bago ang bawat upgrade
Hanapin muna ang aktuwal na volume name. Nilalagyan ng Compose ng project name ang mga named volume. Bilang default, ito ang pangalan ng directory. Kaya ang volume na dineclare bilang kirocrew-home sa /opt/kirocrew/compose.yaml ay ginagawa bilang kirocrew_kirocrew-home:
docker volume lsI-stop ang gateway bago kumopya ng kahit ano. Ang memory.db at memory_index.db ay SQLite databases. Kapag kinopya ang database habang sinusulatan ito, maaaring makuha ang hindi pa kumpletong transaction. Kapag ni-restore ito, magiging corrupt ang file. Ganito rin ang sinasabi sa migration instructions ng project: ilipat lamang ang memory kapag naka-stop ang mga gateway. Hindi lang ito para sa KiroCrew. Kung may photo server ding gumagamit ng parehong server, nasa paghahambing ng PhotoPrism at Immich ang eksaktong backup commands na kailangan ng dalawang iyon.
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 kirocrewKopyahin ang archive palabas ng server. Pareho ang command para sa pag-restore, pero dapat naka-stop ang container at tar xzf ang gamitin sa halip na 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 kirocrewIba ang paglipat sa bagong host sa pag-restore sa kasalukuyang host, at may partikular na tagubilin ang project para rito. Maililipat ang chat history at project notes sa ilalim ng workspace/memory/, pati ang dalawang database file at config.json. Nakaugnay sa lumang host ang PID files, security event log, at .env. Iwan ang mga iyon at ilagay muli ang mga secret sa bagong server.
Paano mag-rollback ng maling upgrade
Maikli ang proseso ng upgrade, at ligtas lamang ito dahil nag-pin ka ng version. Kunin muna ang backup, pagkatapos ay palitan ang 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/healthKumukuha ang docker compose up -d ng image kung wala pa ito sa server, kaya ang pag-edit ng tag ang buong proseso ng upgrade. Pareho ang sequence sa rollback, pero gamitin ang dating number. Makukuha nito ang eksaktong image na ginamit mo dati dahil immutable ang version tags.
Malinis na nagro-rollback ang binary. Ang state ang maaaring magkaroon ng problema. Maaaring i-rewrite ng mas bagong gateway ang config.json o i-migrate ang memory database sa format na hindi mabasa ng mas lumang gateway. Wala ring documented na downgrade path para sa state hanggang 12 October 2026. Malinaw ang install guide tungkol sa isang kaso: walang rollback para sa data na inilipat mula sa legacy ~/.kirocrew home, at magsisimula nang walang laman ang release na mas luma sa ~/.kiro/crew. Kaya kung magsisimula ang mas lumang image ngunit kakaiba ang behavior nito, huwag itong i-debug. Ihinto ito, i-restore ang backup na kinuha mo bago ang upgrade, at magsimulang muli. Iyan ang buong dahilan kung bakit kailangang mauna ang backup, at kung bakit hindi gumagana sa isang proyektong ganito kabago ang nakagawiang mag-upgrade ngayon at mag-backup sa ibang pagkakataon.
Mga hindi napatunayan dito
Maging tapat sa edad ng software na ito. Na-release ang Version 0.1.3 noong 5 August 2026, at pagsapit ng 12 October 2026, umabot na sa 0.8.0 ang stable line. Karamihan sa release notes ay awtomatikong nabuong changelog pa rin; isinulat nang mano-mano ang mga note para sa 0.8.0 ngunit walang migration section, at humigit-kumulang tatlong buwan pa lamang ang pampublikong release history. Walang pangmatagalang resulta sa gabay na ito, kaya ituring ang memory growth, laki ng database, at reliability ng scheduler bilang mga bagay na dapat mong sukatin sa sarili mong box, hindi bilang mga bagay na dapat basta ipalagay.
May dalawang behavior na dapat mo munang subukan bago umasa sa mga ito. Una, alamin kung nababasa ng downgrade ang state na isinulat ng mas bagong version: subukan ito sa kopya ng volume habang hindi pa kritikal, hindi sa oras ng outage. Ikalawa, tingnan kung ano ang ginagawa ng gateway kapag nag-expire ang Kiro sign-in habang oras nang tumakbo ang isang scheduled job. Pareho itong mga edge case na maaaring tahimik na inaayos ng batang project sa pagitan ng mga release, at parehong madaling suriin ngayon.
FAQ
Bakit hindi bumubukas ang KiroCrew dashboard sa public IP ng server ko?
Dahil naka-bind sa loopback ang port sa inilathalang halimbawa. Ang -p 127.0.0.1:5476:5476 ay nagmamapa ng port ng container sa loopback address lamang ng host, at sinadya ito. Ma-access ito sa pamamagitan ng pag-forward ng port sa SSH gamit ang ssh -N -L 5476:127.0.0.1:5476 you@your-server, saka buksan ang http://localhost:5476/?token=<token> sa laptop mo. Kapag inalis ang prefix na 127.0.0.1: upang maging reachable ito, ilalantad ang gateway sa public internet. Hindi ito mapipigilan ng ufw dahil niruruta ng Docker's published-port DNAT rules ang traffic bago mailapat ang rules ng ufw. Gamitin ang DOCKER-USER chain ng Docker kasama ang iptables backend nito, o magkahiwalay na nftables base chain kasama ang nftables backend nito, upang i-filter ang mga published port. Mas simple na panatilihin ang loopback bind.
Saan iniimbak ng KiroCrew ang data nito, at ano ang dapat kong i-back up?
Nasa ilalim ng ~/.kiro/crew ang lahat. Ito ay /home/kirocrew/.kiro/crew sa loob ng container image, at inililipat ito ng KIROCREW_HOME. I-back up ang buong directory, o ang buong Docker volume, habang nakahinto ang gateway. Mga SQLite database ang memory.db at memory_index.db, kaya maaaring maging inconsistent ang kopyang ginawa habang nagsusulat ang gateway. Kapag lumilipat sa bagong host, naililipat ang workspace/memory/, ang dalawang database file, at ang config.json. Ang PID file, security event log, at .env ay para naman sa lumang host.
Dapat ko bang gamitin ang stable tag o isang version tag?
Gumamit ng version tag. Nagbabago ang stable sa tuwing may bagong release, kaya maaaring magbago ang bersyong pinapatakbo mo sa susunod na pull. Wala ring sinasabi ang tag mismo tungkol sa aktuwal na tumatakbo. Immutable ang mga version tag gaya ng 0.8.0. Ito mismo ang dahilan kung bakit gumagana ang rollback: ibinabalik mo ang lumang numero at nakukuha ang kaparehong image. Noong 1 November 2026, ang pinakabagong stable release ay 0.11.1.
Bakit tumatanggi ang agent kong magpatakbo ng anumang command?
Sinusuri ng container ang suporta sa sandbox sa unang pagsisimula nito. Kung hindi nito maihihiwalay ang mga subprocess ng agent at hindi nakatakda ang KIROCREW_ALLOW_UNSANDBOXED=1, tumatanggi itong magpatakbo ng mga ito sa halip na patakbuhin ang mga ito nang walang isolation. Dahil dito, mukhang maayos ang gateway habang natitigil ang bawat task. Ipinapakita ng docker logs kirocrew ang naging desisyon tungkol sa sandbox sa unang pagtakbo. Kapag itinakda ang variable, ang container ang nagiging tanging boundary sa pagitan ng agent at host. Kaya kung itatakda mo ito, huwag mag-mount ng anumang bagay na hindi mo direktang ipagkakatiwala sa agent.
Kailangan ko ba ng Kiro account para mag-self-host ng KiroCrew?
Para sa mga Kiro backend, oo, simula 1 November 2026. Libreng software ang KiroCrew sa ilalim ng Apache 2.0, ngunit ginagamit ng inference sa mga backend na iyon ang Kiro plan mo. Ang naka-pin na 0.8.0 container ay gumagamit ng Kiro CLI. Patakbuhin ang docker exec -it kirocrew kiro-cli login at aprubahan ang device code sa browser mo, o ipasa ang KIRO_API_KEY sa environment ng container para sa automated na paggamit. Hangga't hindi naka-configure ang authentication, nagsisimula ang gateway at naglo-load ang dashboard, ngunit walang modelong makausap ang default harness nito. Mula sa 0.10.0, mayroon ding built-in na KAS engine na hindi nangangailangan ng naka-install na kiro-cli. Ginawang default ng 0.11.0 ang KAS para sa mga bagong install na walang naka-save na harness choice, habang pinananatili ang mga tahasang piniling Kiro CLI. Sariling sign-in ng Crew ang ginagamit ng KAS sa halip na kiro-cli login. Sa custom backend guide ng proyekto, maaaring magpadala ang isang claude harness ng mga pangunahing model turn sa Anthropic-compatible endpoint na pipiliin mo. Gayunman, kailangan pa rin ang kiro-cli sign-in para sa mga feature na partikular sa Kiro.