Jinsi ya kuweka KiroCrew kwenye VPS kwa usahihi
Jifunze kuendesha KiroCrew kama container ya Docker inayodumu kwenye VPS. Mwongozo huu unaelezea usanidi wa systemd, usimamizi wa port 5476, na mbinu za kuhifadhi data.
Kwa nini ujisimamie KiroCrew kwenye VPS badala ya laptop
Kujisimamia KiroCrew kunaleta faida kwenye mashine isiyowahi kulala pekee, kwa hiyo VPS ndiyo mahali panapofaa na laptop haifai. KiroCrew huhifadhi historia ya session, memory ya kisemantiki, jobs zilizopangwa na foleni ya approvals kwenye diski, na hupakia yote hayo mchakato unapoanzishwa upya. Hakuna kati ya hayo inayosaidia ikiwa mchakato hauendeshi saa 03:00 wakati job iliyopangwa inapaswa kuanza, na laptop iliyofungwa haiendeshi mchakato huo.
KiroCrew ni workspace ya agent ya open source kutoka kwa timu ya Kiro, yenye leseni ya Apache 2.0, ikiwa na 0.1.0 iliyotolewa tarehe 22 Julai 2026. Mchakato mmoja, unaoitwa gateway, humiliki state na hutoa dashboard ya wavuti kwenye port 5476. Unafikia gateway hiyo kupitia dashboard, kupitia kirocrew CLI, au kupitia channel ya mawasiliano kama Slack. Gateway ndiyo kitu pekee unachojisimamia, kwa hiyo mwongozo huu unahusu kuiweka ikiendelea kufanya kazi, kuizuia isipatikane kwenye Internet ya umma, na kuweza kuirejesha baada ya upgrade yenye hitilafu.
Kuna mambo mawili ya kujua kabla ya kuanza. Tangu 0.11.0, usakinishaji mpya wa KiroCrew usio na harness choice iliyohifadhiwa hutumia KAS kwa default bila kuhitaji kiro-cli; chaguo zilizowekwa wazi za Kiro CLI kwenye usakinishaji uliopo huhifadhiwa. Inference kwenye Kiro backends hutumia mpango wako wa Kiro, kwa hiyo kufikia 1 Novemba 2026 usanidi huu wa default hauko offline. Mradi huu pia bado ni mpya na unasonga haraka: stable releases zake zilitoka 0.1.3 tarehe 5 Agosti 2026 hadi 0.10.0 tarehe 25 Oktoba 2026, huku 0.8.0 ikiwa tarehe 9 Oktoba na 0.9.0 tarehe 16 Oktoba katikati, na 0.11.0 release candidate ilikuwa tayari imetolewa kama pre-release tarehe 25 Oktoba. Tarajia kuhitaji kufanya rollback wakati fulani, na usakinishe kwa njia itakayokuwezesha kufanya hivyo. Ikiwa hujawahi kuendesha agent kwenye seva, kuendesha coding agent kwenye VPS kunaeleza kanuni za msingi ambazo mwongozo huu unatumia. Ikiwa upande wa agent ni mpya kwako kuliko upande wa seva, kujifunza kwanza agent loop, tools zake na memory yake ni nini hasa kutafanya chaguo zilizo hapa chini zisomeke kama maamuzi badala ya incantations.
KiroCrew inahitaji nini, na hali yake huhifadhiwa wapi
Usakinishaji wa moja kwa moja unahitaji Python 3.12 au mpya zaidi na Node.js 22.12.0 au mpya zaidi ikiwa utaunda dashboard kutoka kwenye source (mradi unapendekeza Node 24 LTS). Backend ya Kiro CLI inahitaji kiro-cli, iliyo-authenticate kwa kiro-cli login au API key kwa matumizi ya kiotomatiki; tangu 0.10.0, engine ya KAS iliyojengewa ndani huendesha bila kiro-cli kusakinishwa, na 0.11.0 iliifanya iwe chaguo-msingi kwa usakinishaji mpya ambao hauna chaguo la harness lililohifadhiwa. Usakinishaji wa container hauhitaji chochote kati ya hivyo kwenye host. Unahitaji Docker. Hiyo ndiyo sababu kuu ya kuupendelea.
Hali huhifadhiwa katika ~/.kiro/crew, na environment variable ya KIROCREW_HOME huihamisha hadi mahali pengine. Yaliyomo ndani yake ni:
config.json: mipangilio ya gateway na credentials za chat channels..env: secrets.workspace/memory/: preferences, project notes na chat history.memory.dbnamemory_index.db: semantic indexes na full-text indexes.models/: embedding model, inayopakuliwa wakati wa first run.security_events.jsonl: security event log.
Directory hiyo ndiyo install. Iinakili kwenye VPS mpya na utakuwa umehamisha agent yako. Ndiyo maana sehemu ya backup hapa chini ni muhimu zaidi kuliko sehemu ya install.
Panga matumizi ya disk badala ya RAM. Gateway ni process ya Python; kinachopakia mashine kwa kweli ni chochote agent anachoendesha, build au test suite. State directory hukua kadiri chat history inavyoongezeka, na embedding model huwasili wakati wa first start. Kwa hiyo, ipime kwenye mashine yako kwa kutumia du -sh ~/.kiro/crew baada ya wiki kadhaa, badala ya kutegemea takwimu zilizochapishwa katika miezi ya mwanzo ya mradi. Linganisha hilo na runtime inayompa kila worker container yake na browser yake, ambapo kujiendeshea OpenBot's AI coworkers hufanya sizing iwe suala la RAM kabla halijawa suala la disk.
Ni ipi kati ya njia nne za usakinishaji unayopaswa kutumia
Mradi huu hutoa njia nne: programu ya desktop, wheel ya mstari mmoja, source na Docker. Kisakinishi cha mstari mmoja huchukua wheel na huunda launcher ya kirocrew; ikiwa directory yake haipo kwenye PATH yako, huonyesha maelekezo ya kuiongeza:
curl -fsSL https://download.crew.kiro.dev/cli.sh | shHuchukua flag ya channel na flag ya version:
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.0Image ya container inachapishwa kwenye ghcr.io/kirodotdev/kirocrew, kwa linux/amd64 na linux/arm64 chini ya kila tag. Build ya source ni git clone pamoja na make build, na imekusudiwa watu wanaobadilisha code, si watu wanaoiendesha.
Tumia container. Usakinishaji wa native source huweka Python packages na Node kwenye host ileile inayoendesha huduma zako nyingine, pamoja na kiro-cli unapotumia Kiro CLI backend. Kwa hiyo, upgrade ikifeli, utalazimika kurekebisha hali hiyo kwa mkono. Container huweka runtime kwenye image moja na state kwenye volume moja. Hivyo, rollback huwa kubadilisha tag na kuanzisha upya.
Funga picha kwenye tag ya release, si kwenye stable
Mfano wa mradi wenyewe unatumia tag ya stable:
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stablestable ni tag inayobadilika, na hivyo pia ni latest, ambayo inaelekeza kwenye release hiyo hiyo. Inaelekeza kwenye release mpya zaidi iliyo stable wakati huo, kwa hiyo pull inayofuata inaweza kubadilisha version unayoendesha bila wewe kuichagua, na tag hiyo haihifadhi taarifa ya version iliyotumika. Version tags hazibadiliki, kwa hiyo funga picha kwenye moja. Release mpya zaidi iliyo stable kufikia 1 November 2026 ni 0.11.1, iliyochapishwa tarehe 31 October 2026, ikiwa ni hot patch ya memory integrity na marekebisho ya KAS katika 0.11.0. Mfano wa 0.8.0 hapa chini unatumia Kiro CLI. Pia kuna tags za insider na nightly; nightly hufuata builds kutoka main.
Andika /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:Iwashe, kisha kagua health endpoint ambayo picha hiyo pia hutumia kwa HEALTHCHECK yake:
cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/healthdocker compose ps inapaswa kuripoti container kuwa healthy ndani ya takribani dakika moja, na /api/health hujibu bila tokeni (vivyo hivyo /api/live na /api/ready, jambo linalozifanya zifae kama probes). Ikiwa hali itabaki kuwa starting, soma docker logs kirocrew kabla ya kubadilisha chochote. Mara ya kwanza command inapotekelezwa, hupakua embedding model kwa nyuma; memory search hutumia ulinganishaji wa keywords hadi model hiyo ifike.
Kudumisha huduma kwa kutumia systemd
restart: unless-stopped huirejesha container baada ya crash na baada ya reboot, mradi tu Docker yenyewe ianze wakati wa boot. Faili la unit hufanya utegemezi huo kuwa wazi na kukupa amri moja ya kusimamisha stack nzima kabla ya kufanya backup. Kuanzisha Docker Compose stack wakati wa boot inaelezea muundo huu kwa ujumla. Hii ndiyo namna ya KiroCrew ya kuifanya, katika /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 kirocrewsystemctl status kirocrew inapaswa kusomeka active (exited), ambayo ndiyo matokeo sahihi kwa unit hii. Type=oneshot pamoja na RemainAfterExit=yes imewekwa hapa kwa sababu docker compose up -d inamaliza kazi yake mara tu container inapoanzishwa: systemd hufuatilia ukweli kwamba stack iko juu, si mchakato wa foreground. Andika Type=simple badala yake na systemd itaona amri hiyo ikimaliza kazi mara moja, itaashiria huduma hiyo imekufa, kisha itaacha au kuanza mzunguko wa restart kulingana na mpangilio wako wa Restart=. Kwa usakinishaji wa asili, mradi huu hutoa kitu chake sawa, kirocrew service install, ambayo huandika /etc/systemd/system/kirocrew.service na kuendesha gateway kama mtumiaji wako. Usiendeshe unit zote mbili. Toleo pana zaidi la mada hii liko katika systemd services na timers kwenye VPS. Unit inayoshindwa kurejea huwa kimya isipokuwa ukiifanya izungumze, kwa hivyo ongeza handler ya OnFailure= ambayo hutuma tahadhari kwenye seva yako ya ntfy na utasikia kuwa gateway iko chini kupitia simu yako badala ya kusubiri kazi iliyopangwa ambayo haikuwahi kufanyika.
Kuanza: ingia na upate tokeni ya dashboard
Container huanzisha gateway, lakini runtime chaguo-msingi ya Kiro CLI katika image ya 0.8.0 iliyowekwa toleo bado inahitaji uthibitishaji. Ingia ndani ya container, au pitisha KIRO_API_KEY kupitia mazingira ya container kwa matumizi ya kiotomatiki:
docker exec -it kirocrew kiro-cli loginHii huchapisha msimbo wa kifaa na URL unayofungua kwenye browser yako. Kisha tengeneza tokeni ya dashboard:
docker exec kirocrew kirocrew token --ttl 2hURL ya dashboard ni http://localhost:5476/?token=<the token>. Tokeni zinaisha muda: kiungo kilichochapishwa lazima kifunguliwe ndani ya dakika tano baada ya tokeni kutengenezwa, na amri hii huomba cookie ya ufikiaji ya saa mbili; kiwango cha juu kilichoandikwa ni saa ishirini. Browser pia hupokea refresh cookie yenye muda wa siku 30 wa kutokuwa na shughuli unaojirekebisha, hivyo session inayotumika huendelea kufanywa upya bila kiungo kingine. Dashboard inayofunguka ikiwa tupu au kukurudisha moja kwa moja nje kwa kawaida husababishwa na tokeni iliyoisha muda. Tengeneza tokeni nyingine na uifungue mara moja. Usibandike tokeni kwenye ticket au ujumbe wa chat, kwa sababu mtu yeyote anayeimiliki anamiliki agent yako.
Fikia dashibodi kupitia SSH, na usichapishe port 5476 kamwe
Angalia tena bind address katika mfano wa mradi: -p 127.0.0.1:5476:5476. Ndani ya container, gateway inasikiliza kwenye 0.0.0.0, kwa sababu lazima ifikiwe kupitia port mapping. Hata hivyo, mapping yenyewe inachapisha port hiyo kwenye loopback ya host pekee. Futa prefix ya 127.0.0.1:, na gateway itapatikana kwenye public internet kwa mtu yeyote anayechanganua port hiyo. Kanuni ya ufw pia haitakulinda: Docker huchapisha ports kwa kuandika DNAT rules zinazoelekeza traffic kabla rules za ufw hazijatumika, kwa hiyo ufw deny 5476 haifanyi chochote kwa port iliyochapishwa. Kwa Docker's default iptables backend, jibu la Docker ni kuweka filtering rules katika chain yake ya DOCKER-USER. Hilo linafanya kazi, lakini rules hizo huona internal address na port ya container isipokuwa ulinganishe kwa kutumia conntrack extension. Kwa hiyo, bind ya loopback hubaki kuwa control rahisi zaidi na yenye uwezekano mdogo wa kusanidiwa vibaya. Docker's nftables backend badala yake hutumia nftables tables na base chains tofauti kwa custom filtering. Docker ports zinazopita ufw inaeleza utaratibu huo hatua kwa hatua.
Forward port kupitia SSH kutoka kwenye laptop yako badala yake:
ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.comIache ikiendelea na ufungue http://localhost:5476/?token=<the token> locally. Ili forward ijitengeneze kiotomatiki kwenye kila connection, iweke katika ~/.ssh/config:
Host your-server.example.com
LocalForward 5476 127.0.0.1:5476Ikiwa port 5476 tayari inatumika kwenye laptop yako, badilisha namba ya upande wa kushoto pekee: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com, kisha fungua http://localhost:45476/?token=... kwenye browser. Hakuna setting nyingine ya loopback-port au recreation ya container inayohitajika: Origin ya loopback inalingana na Host ya request yenyewe, kwa hiyo CSRF check huikubali. Utakuwa ukiweka forwards kama hii mara tu agent wa pili atakaposhiriki box, kwa sababu self-hosting open-kritt kwa security scanning huweka dashibodi nyingine inayopatikana kupitia loopback pekee kwenye server hiyo hiyo, kwenye port 5173.
Tabia mbili zilizoandikwa kwenye nyaraka huamua ni settings zipi unaweza kubadilisha kutoka kwenye dashibodi. Kwanza, gateway huchukulia request yoyote iliyo na forwarding headers (Forwarded, X-Forwarded-* au X-Real-IP) kuwa remote, na endpoints zake za config-write na secret-reveal hukataa requests hizo. Reverse proxy huongeza headers hizo; ssh -L forward ya kawaida haiongezi headers hizo, kwa hiyo huonekana kuwa local na haikataliwi kwa sababu hiyo. Pili, katika container image, channel-credential pages na secret-revealing views huwa read-only kwa browser yoyote ambayo si direct-local, na image hiyo haina text editor. Channel credential ambayo haiwezi kuhifadhiwa kutoka kwenye dashibodi husababishwa na hali hii, si bug. Hariri config kwenye host badala yake:
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 kirocrewKwa matumizi ya simu, mradi unaelekeza kwenye tailscale serve ya Tailscale, ambayo huiweka dashibodi ndani ya tailnet yako badala ya kuiweka kwenye public hostname. Pendelea hiyo kuliko public reverse proxy. Token husafiri ndani ya URL, na URL huandikwa katika kila access log iliyo kwenye njia yake. Kanuni hiyo inahusu huduma iliyo nyuma ya port, si port yenyewe: kitu kama Halcyon, inayounda upya Jellyfin library kuwa 90s video store inayoweza kuvinjariwa kimekusudiwa kufunguliwa na watu wengine na ni mgombea anayefaa kwa reverse proxy, lakini gateway inayoweza kuendesha commands kwenye server yako si hivyo.
Mpe wakala eneo dogo zaidi la madhara unaloweza
Container hukagua kama sandbox inaungwa mkono inapoanzishwa mara ya kwanza. Matokeo huamua kama mawakala wanaweza kutekeleza chochote. Ikiwa utenganishaji wa namespace unapatikana, subprocess za mawakala huendeshwa zikiwa zimetengwa. Ikiwa haupatikani na KIROCREW_ALLOW_UNSANDBOXED=1 haijawekwa, utekelezaji hukataliwa badala ya kuendeshwa bila vizuizi. Kwa hiyo, gateway inayoonekana kuwa na afya huku kila kazi ikikwama mara nyingi husababishwa na hali hii. Uamuzi huo huhifadhiwa katika docker logs kirocrew kuanzia uendeshaji huo wa kwanza. Mradi pia hutoa profile ya seccomp (secure computing mode) unayoweza kutumia:
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.jsonKwenye host iliyo na AppArmor, mwongozo wa Docker wa mradi unasema kuwa profile ya seccomp ni nusu tu ya mabadiliko. Hii ni kwa sababu Docker pia huambatisha profile yake ya AppArmor ya docker-default, na huiunganisha na apparmor=unconfined. Chaguo hilo huondoa tu sheria za AppArmor za kila container. Profile ya seccomp, capabilities zilizoondolewa na mtumiaji asiye wa root bado hutumika.
Ukiweka KIROCREW_ALLOW_UNSANDBOXED=1, eleza wazi kilichobadilika: container sasa ndiyo mpaka pekee kati ya wakala na server yako. Onyo la mradi linafaa kurudiwa lote. Usimount path za host ambazo usingempa wakala moja kwa moja. Kwa vitendo, hii inakataza Docker socket, bind mount yoyote ya /, na directory yoyote iliyo na data ya service nyingine.
Mengine ni mfumo wa msingi unaotumika kwa kila wakala anayeruhusiwa kuendesha commands. Weka credentials zake ziwe na scope ya repository moja au bucket moja tu inayohitaji. Usitumie token ya kibinafsi yenye ruhusa za akaunti nzima. Muendeshe kama mtumiaji maalum ambaye home yake haina kitu kingine. Hilo ndilo lengo la watumiaji wenye ruhusa ndogo kwenye VPS. Wakala anapoandika code kisha kuiendesha, mpe mashine ambayo anaruhusiwa kuiharibu: VM ya muda kwa mawakala wa coding ni mpaka imara zaidi kuliko flag yoyote katika compose file hii, kwa sababu unaifuta badala ya kuisafisha. Mantiki hiyo hiyo ndiyo msingi wa kuendesha OpenClaw kwa usalama kwenye VPS na kujihost Hermes agent kwenye VPS. Tools nazo huchangia eneo la madhara. Ukimpa wakala web search, kila ukurasa anaouchukua huwa input isiyoaminika. Kwa hiyo, kumwelekeza kwenye SearXNG instance yako ni uamuzi wa prompt injection, na pia wa muunganisho wa huduma. Kazi zilizopangwa pia hutumia fedha unapolala, kwa sababu inference kwenye Kiro backends hutumia Kiro plan yako. Kwa hiyo, weka limits zilizoelezwa katika kudhibiti gharama ya AI agent kwenye VPS kabla ya kuongeza nightly job.
Hifadhi nakala ya volume ya state kabla ya kila upgrade
Tafuta jina halisi la volume kwanza. Compose huweka viambishi awali kwenye named volumes kwa kutumia jina la project, ambalo kwa kawaida ni jina la saraka, kwa hivyo volume iliyotangazwa kama kirocrew-home katika /opt/kirocrew/compose.yaml hutengenezwa kama kirocrew_kirocrew-home:
docker volume lsSimamisha gateway kabla ya kunakili chochote. memory.db na memory_index.db ni database za SQLite, na kunakili database wakati inaandikiwa kunaweza kunasa transaction iliyoandikwa nusu, ambayo ikirejeshwa itakuwa faili lililoharibika. Maelekezo ya migration ya project yenyewe yanasema vivyo hivyo: hamisha kumbukumbu tu wakati gateways zimesimamishwa. Kanuni hiyo ya kusimamisha kwanza si mahususi kwa KiroCrew, na ikiwa seva ya picha inashiriki seva hiyo, ulinganisho wa PhotoPrism na Immich unatoa amri kamili za backup ambazo kila moja ya hizo mbili inahitaji.
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 kirocrewNakili archive nje ya seva. Kurejesha (restoring) ni amri ileile huku container ikiwa imesimamishwa na tar xzf ikichukua nafasi ya 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 kirocrewKuhamia kwenye host mpya ni kazi tofauti na kurejesha kwenye sehemu ileile, na project inatoa maelekezo mahususi kuhusu hilo. Historia ya chat na madokezo ya project chini ya workspace/memory/ huhamishwa, na vivyo hivyo kwa faili mbili za database na config.json. Faili za PID, log ya matukio ya usalama na .env zimefungwa kwenye host ya zamani, kwa hivyo ziache na uweke upya siri (secrets) kwenye seva mpya.
Jinsi ya kurudisha toleo la awali baada ya upgrade mbaya
Upgrade ni fupi, na inakuwa salama tu kwa sababu umefunga (pin) toleo fulani. Chukua backup kwanza, kisha badilisha 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/healthdocker compose up -d huvuta image kama haipo kwenye seva, kwa hivyo kuhariri tag ndiyo upgrade nzima. Kurudisha toleo la awali ni mfuatano uleule kwa kutumia namba ya zamani, na inakupa image ileile uliyokuwa nayo awali, kwa sababu version tags haziwezi kubadilika.
Binary hurudi kwenye hali ya awali bila matatizo. Hali ya data (state) ndiyo sehemu inayoweza kupata shida. Gateway mpya inaweza kuandika upya config.json au kuhamisha database za kumbukumbu kwenye umbo ambalo gateway ya zamani haisomi, na hakuna njia ya downgrade ya state iliyoandikwa kufikia 12 October 2026. Mwongozo wa usakinishaji uko wazi kuhusu kisa kimoja: data iliyohamishwa kutoka kwenye ~/.kirocrew ya zamani haina njia ya kurudishwa, na toleo lililotangulia ~/.kiro/crew litaanza likiwa tupu. Kwa hivyo, kama image ya zamani ikianza na kisha ikafanya kazi isivyo kawaida, usijaribu kuitatua. Iisimamishe, rudisha backup uliyochukua kabla ya upgrade, na uanze upya. Hiyo ndiyo sababu nzima ya kuchukua backup kwanza, na ndiyo maana tabia ya kufanya upgrade sasa na kuchukua backup baadaye hushindwa kwenye mradi mchanga kama huu.
Yasiyothibitishwa hapa
Kuwa mkweli kuhusu umri wa programu hii. Toleo 0.1.3 lilitoka tarehe 5 Agosti 2026, na kufikia tarehe 12 Oktoba 2026 mstari wa toleo thabiti (stable line) ulikuwa umefikia 0.8.0. Nyingi ya taarifa za matoleo (release notes) bado ni changelogs za kiotomatiki; taarifa za 0.8.0 zimeandikwa kwa mkono lakini hazina sehemu ya uhamiaji (migration section), na historia ya matoleo ya umma ina urefu wa miezi mitatu hivi. Hakuna kitu katika mwongozo huu ambacho ni matokeo ya muda mrefu, kwa hivyo chukulia ukuaji wa kumbukumbu, ukubwa wa database na uthabiti wa scheduler kama mambo ya kupima kwenye seva yako mwenyewe badala ya mambo ya kudhani.
Tabia mbili zinastahili kujaribiwa na wewe mwenyewe kabla ya kuzitegemea. Kwanza, kama kushusha toleo (downgrade) kunaweza kusoma hali iliyoandikwa na toleo jipya zaidi: jaribu hili kwenye nakala ya volume wakati ambapo hakuna madhara, si wakati wa hitilafu. Pili, kile ambacho gateway hufanya wakati Kiro sign-in inapoisha muda wake huku kazi iliyopangwa (scheduled job) ikiwa inatakiwa kufanyika. Zote mbili ni aina ya changamoto ambazo mradi mchanga huzitatua kimyakimya kati ya matoleo, na zote mbili ni rahisi kuzikagua sasa.
FAQ
Kwa nini dashibodi ya KiroCrew haifunguki kwenye IP ya umma ya seva yangu?
Kwa sababu mfano uliochapishwa hufunga port kwenye loopback. -p 127.0.0.1:5476:5476 huunganisha port ya container na anwani ya loopback ya host pekee, na hilo limekusudiwa. Ifikie kwa kupeleka port kupitia SSH kwa kutumia ssh -N -L 5476:127.0.0.1:5476 you@your-server, kisha ufungue http://localhost:5476/?token=<token> kwenye laptop yako. Kuondoa kiambishi awali 127.0.0.1: ili iweze kufikiwa huweka gateway kwenye Internet ya umma, na ufw hautaizuia, kwa sababu sheria za Docker za DNAT za port zilizochapishwa huelekeza traffic kabla ya sheria za ufw kutumika. Tumia chain ya Docker ya DOCKER-USER pamoja na iptables backend yake, au base chains tofauti za nftables pamoja na nftables backend yake, ili kuchuja port zilizochapishwa; kuendelea kutumia loopback bind ni rahisi zaidi.
KiroCrew huhifadhi data yake wapi, na ninapaswa kuhifadhi nakala ya nini?
Kila kitu kiko chini ya ~/.kiro/crew, ambayo ni /home/kirocrew/.kiro/crew ndani ya container image, na KIROCREW_HOME huihamisha. Hifadhi nakala ya directory nzima, au Docker volume nzima, gateway ikiwa imesimamishwa. memory.db na memory_index.db ni SQLite databases, kwa hiyo nakala inayochukuliwa gateway ikiandika inaweza kutokuwa thabiti. Unapohamia host mpya, workspace/memory/, faili mbili za database na config.json huhamishwa, huku PID files, security event log na .env zikibaki za host ya zamani.
Je, nitumie tag ya stable au tag ya version?
Tumia tag ya version. stable hubadilika kila release inapotolewa, kwa hiyo version unayoendesha inaweza kubadilika wakati wa pull inayofuata, na tag yenyewe haikuambii kinachoendesha. Version tags kama 0.8.0 hazibadiliki, na hilo ndilo linalowezesha rollback: unaweka tena namba ya zamani na kupata image ile ile. Kufikia 1 November 2026, release thabiti mpya zaidi ni 0.11.1.
Kwa nini agent yangu inakataa kuendesha command yoyote?
Container huchunguza kama sandbox inatumika wakati wa kuanza kwake kwa mara ya kwanza. Ikiwa haiwezi kutenga subprocesses za agent na KIROCREW_ALLOW_UNSANDBOXED=1 haijawekwa, inakataa kuziendesha badala ya kuziendesha bila ulinzi, kwa hiyo gateway huonekana kuwa na afya huku kila task ikikwama. docker logs kirocrew huonyesha uamuzi wa sandbox kutoka kwenye jaribio hilo la kwanza. Kuweka variable hiyo hufanya container kuwa mpaka pekee kati ya agent na host, kwa hiyo ukiweka variable hiyo, usimount kitu chochote ambacho usingemkabidhi agent moja kwa moja.
Je, ninahitaji akaunti ya Kiro ili kujihost KiroCrew?
Kwa Kiro backends, ndiyo, kufikia 1 November 2026. KiroCrew ni free software chini ya Apache 2.0, lakini inference kwenye backends hizo hutumia mpango wako wa Kiro. Container ya 0.8.0 iliyowekwa version hutumia Kiro CLI: endesha docker exec -it kirocrew kiro-cli login na uthibitishe device code kwenye browser yako, au pitisha KIRO_API_KEY kupitia mazingira ya container kwa matumizi ya kiotomatiki. Hadi authentication isanidiwe, gateway hiyo huanza na dashibodi hupakia, lakini harness yake ya kawaida haina model ya kuwasiliana nayo. Tangu 0.10.0, pia kuna KAS engine iliyojengwa ndani ambayo haihitaji kiro-cli iwe imesakinishwa; 0.11.0 iliifanya KAS kuwa chaguo-msingi kwa install mpya zisizo na harness choice iliyohifadhiwa, huku ikihifadhi chaguo za Kiro CLI zilizowekwa wazi. KAS hutumia sign-in ya Crew yenyewe badala ya kiro-cli login. Mwongozo wa custom backend wa mradi huruhusu claude harness kutuma model turns kuu kwenye endpoint inayooana na Anthropic utakayochagua, lakini sign-in ya kiro-cli bado inahitajika kwa vipengele maalum vya Kiro.