SSD Nodes Learn Hosting plans →
गाइड Matt Connorलेखक: Matt Connor

VPS पर KiroCrew को self-host कैसे करें: पूरी गाइड

अपने VPS पर KiroCrew को Docker container के रूप में सेटअप करें। यह गाइड आपको systemd कॉन्फ़िगरेशन, SSH एक्सेस और डेटा बैकअप के जरिए 24/7 एजेंट चलाने की सटीक प्रक्रिया सिखाती है।

Laptop के बजाय VPS पर KiroCrew को self-host क्यों करें

KiroCrew को self-host करने का लाभ केवल ऐसी मशीन पर मिलता है जो कभी बंद नहीं होती, इसलिए VPS इसके लिए सही स्थान है और laptop नहीं। KiroCrew session history, semantic memory, scheduled jobs और approval queue को disk पर रखता है, और process restart होने पर यह सब कुछ reload कर लेता है। यदि process 03:00 बजे नहीं चल रही है जब कोई scheduled job होनी है, तो इनमें से कोई भी चीज़ काम नहीं आएगी, और बंद laptop पर यह नहीं चल रहा होता।

KiroCrew, Kiro टीम द्वारा बनाया गया एक open source agent workspace है, जो Apache 2.0 license के तहत उपलब्ध है, और 0.1.0 को 22 July 2026 को release किया गया था। gateway नामक एक process state को नियंत्रित करती है और port 5476 पर एक web dashboard प्रदान करती है। आप उस gateway तक dashboard से, kirocrew CLI से, या Slack जैसे chat channel से पहुँचते हैं। gateway ही एकमात्र चीज़ है जिसे आप self-host कर रहे हैं, इसलिए यह guide उसे चालू रखने, उसे public internet से दूर रखने, और खराब upgrade के बाद उसे वापस ठीक करने के बारे में है।

शुरू करने से पहले दो बातें जान लें। 0.11.0 के बाद से, बिना किसी saved harness विकल्प वाले नए KiroCrew installs में kiro-cli की आवश्यकता के बिना KAS डिफ़ॉल्ट रूप से सेट हो जाता है; मौजूदा explicit Kiro CLI चयन सुरक्षित रहते हैं। Kiro backends पर inference आपके Kiro plan का उपयोग करता है, इसलिए 1 November 2026 से यह डिफ़ॉल्ट सेटअप offline नहीं है। यह project अभी नया है और तेज़ी से विकसित हो रहा है: इसके stable releases 5 August 2026 को 0.1.3 से बढ़कर 25 October 2026 को 0.10.0 हो गए, जिसके बीच में 9 October को 0.8.0 और 16 October को 0.9.0 आए, और 25 October को एक 0.11.0 release candidate पहले ही pre-release के रूप में उपलब्ध था। मानकर चलें कि आपको किसी बिंदु पर roll back करने की आवश्यकता होगी, और इसे इस तरह install करें कि आप ऐसा कर सकें। यदि आपने पहले कभी server पर agent नहीं चलाया है, तो running a coding agent on a VPS उन बुनियादी नियमों को कवर करता है जिन पर यह guide आधारित है। यदि आप server side की तुलना में agent side के लिए नए हैं, तो पहले learning what an agent loop, its tools and its memory actually are पढ़ने से नीचे दिए गए विकल्प आपको केवल निर्देशों के बजाय सोच-समझकर लिए गए निर्णय लगेंगे।

KiroCrew को क्या चाहिए, और इसका state कहाँ रहता है

यदि आप dashboard को source से build करते हैं, तो native install के लिए Python 3.12 या उससे नया और Node.js 22.12.0 या उससे नया version चाहिए (project Node 24 LTS की सलाह देता है)। Kiro CLI backend को kiro-cli की आवश्यकता होती है, जो kiro-cli login या automated उपयोग के लिए API key के साथ authenticated हो; 0.10.0 के बाद से, built-in KAS engine बिना kiro-cli install किए चलता है, और 0.11.0 ने इसे बिना किसी saved harness विकल्प वाले नए installs के लिए default बना दिया है। Container install के लिए host पर इनमें से किसी की आवश्यकता नहीं है। इसे केवल Docker चाहिए। यही इसे प्राथमिकता देने का मुख्य कारण है।

State ~/.kiro/crew में रहता है, और KIROCREW_HOME environment variable इसे कहीं और ले जाता है। इसके अंदर क्या होता है:

  • config.json: gateway settings और chat channel credentials।
  • .env: secrets।
  • workspace/memory/: preferences, project notes और chat history।
  • memory.db और memory_index.db: semantic और full-text indexes।
  • models/: embedding model, जो पहली बार run करने पर download होता है।
  • security_events.jsonl: security event log।

वह directory ही install है। इसे एक नए VPS पर copy करें और आपका agent move हो गया, इसीलिए नीचे दिया गया backup section install section से अधिक महत्वपूर्ण है।

RAM के बजाय disk के लिए plan करें। Gateway एक Python process है; जो वास्तव में box पर load डालता है वह वह है जिसे agent run करता है, जैसे कोई build या test suite। State directory chat history के साथ बढ़ती है, और embedding model पहली बार start करने पर आता है, इसलिए project के शुरुआती महीनों में प्रकाशित किसी भी आंकड़े पर भरोसा करने के बजाय, कुछ हफ्तों के बाद अपने box पर du -sh ~/.kiro/crew के साथ इसे मापें। इसकी तुलना एक ऐसे runtime से करें जो हर worker को अपना container और अपना browser देता है, जहाँ OpenBot के AI सहकर्मियों को self-host करना RAM के आकार का प्रश्न बन जाता है, इससे पहले कि वह disk का प्रश्न बने।

आपको चार install paths में से किसका उपयोग करना चाहिए

यह प्रोजेक्ट चार विकल्प प्रकाशित करता है: desktop app, one-line wheel, source और Docker। One-line installer एक wheel को fetch करता है और एक kirocrew launcher बनाता है; यदि इसकी directory आपके PATH पर नहीं है, तो यह इसे जोड़ने के निर्देश print करता है:

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

यह एक channel flag और एक 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.0

Container image ghcr.io/kirodotdev/kirocrew पर प्रकाशित की जाती है, जो हर tag के अंतर्गत linux/amd64 और linux/arm64 के लिए उपलब्ध है। Source build में git clone और make build शामिल हैं, और यह उन लोगों के लिए है जो code में बदलाव कर रहे हैं, न कि उन लोगों के लिए जो इसे चला रहे हैं।

Container का उपयोग करें। Native source install आपके अन्य services को चलाने वाले host पर ही Python packages और Node को डाल देता है, साथ ही Kiro CLI backend का उपयोग करते समय kiro-cli भी डालता है। इसलिए, यदि upgrade गलत हो जाता है, तो आपको उसे हाथ से ठीक करना पड़ेगा। Container runtime को एक image में और state को एक volume में रखता है, जिससे rollback केवल एक tag परिवर्तन और restart का काम रह जाता है।

इमेज को एक release tag पर पिन करें, न कि stable पर

प्रोजेक्ट का अपना उदाहरण 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 एक moving tag है, और latest भी, जो उसी release की ओर इशारा करता है। यह हमेशा नवीनतम stable release को दर्शाता है, इसलिए अगली बार pull करने पर आप बिना अपनी इच्छा के एक नया version चला सकते हैं, और tag में यह दर्ज नहीं होता कि वह कौन सा version था। Version tags immutable होते हैं, इसलिए किसी एक को पिन करें। 1 November 2026 तक नवीनतम stable release 0.11.1 है, जिसे 31 October 2026 को प्रकाशित किया गया था, जो 0.11.0 में memory integrity और KAS fixes के लिए एक hot patch है। नीचे दिया गया 0.8.0 उदाहरण Kiro CLI का उपयोग करता है। यहाँ insider और nightly tags भी उपलब्ध हैं; nightly, main से builds को फॉलो करता है।

/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 करें, फिर उस health endpoint की जाँच करें जिसका उपयोग इमेज अपने स्वयं के HEALTHCHECK के लिए भी करती है:

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

docker compose ps को एक मिनट के भीतर container को healthy रिपोर्ट करना चाहिए, और /api/health बिना token के जवाब देता है (जैसा कि /api/live और /api/ready करते हैं, जो उन्हें probes के रूप में उपयोग करने योग्य बनाता है)। यदि स्थिति starting पर बनी रहती है, तो कुछ भी बदलने से पहले docker logs kirocrew पढ़ें। पहली बार चलाने पर embedding model background में डाउनलोड होता है; जब तक यह नहीं आता, memory search कीवर्ड मिलान (keyword matching) का उपयोग करती है।

systemd के साथ इसे चालू रखें

restart: unless-stopped क्रैश होने के बाद या रीबूट के बाद कंटेनर को वापस ले आता है, बशर्ते Docker खुद बूट पर स्टार्ट हो जाए। एक unit file इस निर्भरता (dependency) को स्पष्ट करती है और आपको एक ही कमांड देती है जो बैकअप से पहले पूरे स्टैक को रोक देती है। बूट पर Docker Compose स्टैक शुरू करना इस सामान्य पैटर्न को कवर करता है। KiroCrew का इसका स्वरूप /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 को active (exited) पढ़ना चाहिए, जो इस यूनिट के लिए सही परिणाम है। RemainAfterExit=yes के साथ Type=oneshot यहाँ इसलिए है क्योंकि कंटेनर शुरू होते ही docker compose up -d वापस आ जाता है: systemd इस तथ्य को ट्रैक कर रहा है कि स्टैक चालू है, न कि किसी फोरग्राउंड प्रोसेस को। इसके बजाय Type=simple लिखें और systemd कमांड को तुरंत समाप्त होते हुए देखेगा, सर्विस को मृत (dead) चिह्नित करेगा, और फिर आपकी Restart= सेटिंग के आधार पर या तो प्रयास छोड़ देगा या रीस्टार्ट-लूप में चला जाएगा। नेटिव इंस्टॉलेशन के लिए प्रोजेक्ट अपना समकक्ष kirocrew service install प्रदान करता है, जो /etc/systemd/system/kirocrew.service लिखता है और गेटवे को आपके यूजर के रूप में चलाता है। दोनों यूनिट्स को एक साथ न चलाएं। इस विषय का विस्तृत संस्करण VPS पर systemd सर्विसेज और टाइमर्स में है। जो यूनिट वापस आने में विफल रहती है वह तब तक शांत रहती है जब तक आप उसे सूचित करने के लिए न कहें, इसलिए एक OnFailure= हैंडलर जोड़ें जो आपके अपने ntfy सर्वर पर अलर्ट भेजता है और आपको अपने फोन पर पता चल जाएगा कि गेटवे डाउन है, बजाय इसके कि किसी शेड्यूल किए गए जॉब के विफल होने पर पता चले जो कभी चला ही नहीं।

पहली बार चलाना: साइन इन करें और डैशबोर्ड टोकन प्राप्त करें

कंटेनर गेटवे को शुरू करता है, लेकिन पिन किए गए 0.8.0 इमेज में डिफ़ॉल्ट Kiro CLI रनटाइम को अभी भी प्रमाणीकरण की आवश्यकता होती है। कंटेनर के अंदर साइन इन करें, या स्वचालित उपयोग के लिए कंटेनर वातावरण के माध्यम से KIRO_API_KEY पास करें:

docker exec -it kirocrew kiro-cli login

यह एक डिवाइस कोड और एक URL प्रिंट करता है जिसे आप अपने ब्राउज़र में खोलते हैं। फिर एक डैशबोर्ड टोकन बनाएं:

docker exec kirocrew kirocrew token --ttl 2h

डैशबोर्ड URL http://localhost:5476/?token=<the token> है। टोकन की समय सीमा समाप्त हो जाती है: प्रिंट किए गए लिंक को बनाने के पांच मिनट के भीतर खोला जाना चाहिए, और यह कमांड दो घंटे के एक्सेस कुकी का अनुरोध करती है, जबकि प्रलेखित अधिकतम समय बीस घंटे है। ब्राउज़र को 30-दिन की स्लाइडिंग आइडल विंडो के साथ एक रिफ्रेश कुकी भी प्राप्त होती है, इसलिए एक सक्रिय सत्र बिना किसी अन्य लिंक के नवीनीकृत हो जाता है। यदि डैशबोर्ड खाली लोड होता है या आपको सीधे बाहर कर देता है, तो आमतौर पर इसका मतलब है कि टोकन समाप्त हो गया है, इसलिए दूसरा टोकन बनाएं और उसे तुरंत खोलें। कभी भी किसी टोकन को टिकट या चैट संदेश में पेस्ट न करें, क्योंकि जिसके पास यह होता है, उसके पास आपका एजेंट होता है।

SSH के माध्यम से डैशबोर्ड तक पहुँचें और port 5476 को कभी भी public न करें

प्रोजेक्ट के उदाहरण में bind address को फिर से देखें: -p 127.0.0.1:5476:5476। कंटेनर के अंदर gateway 0.0.0.0 पर listen करता है, क्योंकि इसे port mapping के माध्यम से पहुँचा जा सकने योग्य होना चाहिए, लेकिन mapping स्वयं host पर केवल loopback के लिए publish होती है। 127.0.0.1: prefix को हटा दें तो gateway public internet पर किसी भी ऐसे व्यक्ति के लिए उपलब्ध हो जाएगा जो उस port को scan करता है। ufw rule भी आपको नहीं बचाएगा: Docker ports को DNAT rules लिखकर publish करता है जो ufw के rules लागू होने से पहले traffic को route कर देते हैं, इसलिए ufw deny 5476 किसी published port पर कुछ नहीं करता है। Docker के डिफ़ॉल्ट iptables backend के साथ, Docker का अपना समाधान इसके DOCKER-USER chain में filtering rules डालना है। यह काम करता है, लेकिन जब तक आप conntrack extension के साथ match नहीं करते, तब तक ये rules कंटेनर के internal address और port को देखते हैं, इसलिए loopback bind ही सरल नियंत्रण बना रहता है और इसमें गलती होने की संभावना कम होती है। इसके बजाय Docker का nftables backend कस्टम filtering के लिए अलग nftables tables और base chains का उपयोग करता है। Docker ports bypassing ufw उस तंत्र के बारे में विस्तार से बताता है।

इसके बजाय अपने laptop से SSH के माध्यम से port को forward करें:

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

इसे चलते रहने दें और स्थानीय रूप से http://localhost:5476/?token=<the token> खोलें। हर connection पर forward को automatic बनाने के लिए, इसे ~/.ssh/config में डालें:

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

यदि port 5476 आपके laptop पर पहले से उपयोग में है, तो केवल बाईं ओर की संख्या बदलें: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com, फिर http://localhost:45476/?token=... पर browse करें। किसी अतिरिक्त loopback-port setting या कंटेनर को फिर से बनाने की आवश्यकता नहीं है: loopback Origin अनुरोध के स्वयं के Host से मेल खाता है, इसलिए CSRF check इसे स्वीकार कर लेता है। जैसे ही दूसरा agent box साझा करेगा, आप इस तरह के forwards को stack करना शुरू कर देंगे, क्योंकि self-hosting open-kritt for security scanning उसी सर्वर पर, port 5173 पर, एक और loopback-only डैशबोर्ड डालता है।

दो documented व्यवहार यह तय करते हैं कि आप डैशबोर्ड से कौन सी settings बदल सकते हैं। पहला, gateway forwarding headers (Forwarded, X-Forwarded-* या X-Real-IP) ले जाने वाले किसी भी अनुरोध को remote मानता है, और इसके config-write और secret-reveal endpoints उन अनुरोधों को अस्वीकार कर देते हैं। एक reverse proxy उन headers को जोड़ता है; एक साधारण ssh -L forward कोई header नहीं जोड़ता है, इसलिए यह local दिखता है और इस आधार पर अस्वीकार नहीं किया जाता है। दूसरा, कंटेनर image में channel-credential pages और secret-revealing views किसी भी ऐसे browser के लिए read-only होते हैं जो direct-local नहीं है, और image में कोई text editor नहीं होता है। एक channel credential जो डैशबोर्ड से save नहीं होगा, वह यही है, न कि कोई bug। इसके बजाय host पर config को edit करें:

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

Phone access के लिए प्रोजेक्ट Tailscale के tailscale serve की ओर इशारा करता है, जो डैशबोर्ड को public hostname के बजाय आपके अपने tailnet के अंदर रखता है। public reverse proxy की तुलना में इसे प्राथमिकता दें। token URL में यात्रा करता है, और URL उसके रास्ते में आने वाले हर access log में लिखा जाता है। वह नियम इस बारे में है कि port के पीछे क्या है, न कि स्वयं port के बारे में: Halcyon, which rebuilds a Jellyfin library as a browsable 90s video store जैसी चीज़ें दूसरों के खोलने के लिए मौजूद होती हैं और reverse proxy के लिए एक उचित उम्मीदवार हैं, जबकि एक gateway जो आपके सर्वर पर commands चला सकता है, वह नहीं है।

एजेंट को न्यूनतम संभव ब्लास्ट रेडियस दें

कंटेनर पहली बार स्टार्ट होने पर सैंडबॉक्स सपोर्ट की जाँच करता है, और परिणाम यह तय करता है कि एजेंट कुछ भी निष्पादित (execute) कर सकते हैं या नहीं। यदि namespace isolation उपलब्ध है, तो एजेंट के subprocesses अलग-थलग होकर चलते हैं। यदि यह उपलब्ध नहीं है और KIROCREW_ALLOW_UNSANDBOXED=1 सेट नहीं है, तो अनियंत्रित (unconfined) तरीके से चलाने के बजाय निष्पादन को अस्वीकार कर दिया जाता है। इसलिए, यदि गेटवे स्वस्थ दिखता है लेकिन सभी कार्य रुक जाते हैं, तो आमतौर पर यही कारण होता है। यह निर्णय उस पहले रन से docker logs kirocrew में दर्ज होता है। प्रोजेक्ट एक seccomp (secure computing mode) प्रोफाइल भी प्रकाशित करता है जिसे आप लागू कर सकते हैं:

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

AppArmor सक्षम वाले होस्ट पर, प्रोजेक्ट की Docker गाइड के अनुसार seccomp प्रोफाइल केवल आधा बदलाव है, क्योंकि Docker अपने docker-default AppArmor प्रोफाइल को भी जोड़ता है, और यह इसे apparmor=unconfined के साथ जोड़ता है। वह विकल्प केवल AppArmor के प्रति-कंटेनर नियमों को हटाता है; seccomp प्रोफाइल, हटाई गई capabilities और non-root user अभी भी लागू रहते हैं।

यदि आप KIROCREW_ALLOW_UNSANDBOXED=1 सेट करते हैं, तो स्पष्ट रहें कि क्या बदला है: अब कंटेनर ही एजेंट और आपके सर्वर के बीच एकमात्र सीमा है। प्रोजेक्ट की चेतावनी को पूरी तरह से दोहराना उचित है। ऐसे होस्ट पाथ माउंट न करें जिन्हें आप सीधे एजेंट को नहीं सौंपेंगे। व्यवहार में, इसका मतलब है कि Docker socket, / का कोई भी bind mount, और किसी अन्य सर्विस का डेटा रखने वाली कोई भी डायरेक्टरी इसमें शामिल नहीं होनी चाहिए।

बाकी वह ढांचा है जो कमांड चलाने की अनुमति वाले प्रत्येक एजेंट पर लागू होता है। इसके क्रेडेंशियल्स को केवल उस एक रिपॉजिटरी या बकेट तक सीमित रखें जिसकी उसे आवश्यकता है, कभी भी ऐसे पर्सनल टोकन का उपयोग न करें जिसमें पूरे अकाउंट के अधिकार हों। इसे एक समर्पित यूजर के रूप में चलाएं जिसके होम डायरेक्टरी में कुछ और न हो, जिसके लिए VPS पर least privilege users का उपयोग किया जाता है। जब एजेंट कोड लिखता है और फिर उस कोड को चलाता है, तो उसे ऐसी मशीन दें जिसे वह खराब कर सके: coding agents के लिए एक disposable VM इस compose फाइल के किसी भी फ्लैग की तुलना में एक मजबूत सीमा है, क्योंकि आप इसे साफ करने के बजाय डिलीट कर देते हैं। यही तर्क VPS पर सुरक्षित रूप से OpenClaw चलाना और VPS पर Hermes agent को self-host करना को आकार देता है। टूल्स भी ब्लास्ट रेडियस में गिने जाते हैं: एजेंट को वेब सर्च की सुविधा देने का मतलब है कि उसके द्वारा फेच किया गया हर पेज untrusted इनपुट बन जाता है, इसलिए इसे अपने स्वयं के SearXNG instance की ओर पॉइंट करना एक प्लंबिंग निर्णय के साथ-साथ प्रॉम्प्ट इंजेक्शन का भी निर्णय है। निर्धारित कार्य (scheduled work) आपके सोते समय भी पैसे खर्च करते हैं, क्योंकि Kiro backends पर इन्फरेंस आपके Kiro प्लान का उपयोग करता है, इसलिए कोई भी nightly job जोड़ने से पहले VPS पर AI agent की लागत को नियंत्रित करना में वर्णित सीमाएं सेट करें।

अपग्रेड से पहले state volume का बैकअप लें

सबसे पहले वास्तविक volume नाम का पता लगाएँ। Compose, project नाम के साथ volumes को prefix करता है, जो डिफ़ॉल्ट रूप से directory का नाम होता है। इसलिए /opt/kirocrew/compose.yaml में kirocrew-home के रूप में घोषित volume को kirocrew_kirocrew-home के रूप में बनाया जाता है:

docker volume ls

कुछ भी कॉपी करने से पहले gateway को रोकें। memory.db और memory_index.db SQLite databases हैं। यदि आप database को लिखते समय उसे कॉपी करते हैं, तो एक अधूरी transaction कॉपी हो सकती है, जो restore करने पर corrupt file बन जाएगी। project के अपने migration निर्देश भी यही कहते हैं: memory को केवल तभी move करें जब gateways बंद हों। यह 'पहले रोकें' वाला नियम केवल KiroCrew के लिए नहीं है। यदि कोई photo server उसी box पर चल रहा है, तो the PhotoPrism and Immich comparison में उन दोनों के लिए आवश्यक सटीक backup commands दी गई हैं।

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

archive को box से बाहर कॉपी करें। restore करने के लिए वही command इस्तेमाल होती है, बस container को बंद रखें और tar czf की जगह tar xzf का उपयोग करें:

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

नए host पर जाना, उसी स्थान पर restore करने से अलग काम है और project इस बारे में स्पष्ट है। workspace/memory/ के अंतर्गत chat history और project notes, साथ ही दोनों database files और config.json को ले जाया जा सकता है। PID files, security event log और .env पुराने host से जुड़े होते हैं, इसलिए उन्हें वहीं छोड़ दें और नए box पर secrets को फिर से दर्ज करें।

खराब अपग्रेड को रोल बैक कैसे करें

अपग्रेड की प्रक्रिया संक्षिप्त है, और यह केवल इसलिए सुरक्षित है क्योंकि आपने एक version को पिन किया है। पहले बैकअप लें, फिर 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 image को pull करता है यदि वह पहले से box पर मौजूद न हो, इसलिए tag में बदलाव ही पूरा अपग्रेड है। रोल बैक करना पुराने number के साथ वही प्रक्रिया है, और यह आपको वही exact image देता है जो आपके पास पहले थी, क्योंकि version tags अपरिवर्तनीय (immutable) होते हैं।

binary साफ-सुथरे तरीके से रोल बैक हो जाती है। state वह हिस्सा है जो शायद न हो। एक नया gateway config.json को rewrite कर सकता है या memory databases को ऐसे स्वरूप में migrate कर सकता है जिसे पुराना gateway न पढ़ सके, और 12 October 2026 तक state के लिए कोई downgrade path प्रलेखित (documented) नहीं है। install guide एक मामले के बारे में स्पष्ट है: legacy ~/.kirocrew home से बाहर ले जाया गया डेटा रोल बैक नहीं होता, और ~/.kiro/crew से पहले का कोई भी release खाली शुरू होगा। इसलिए यदि पुरानी image शुरू होती है और फिर अजीब व्यवहार करती है, तो उसे debug न करें। उसे रोकें, अपग्रेड से पहले लिए गए बैकअप को restore करें, और फिर से शुरू करें। यही एकमात्र कारण है कि बैकअप पहले लिया जाता है, और यही कारण है कि अभी अपग्रेड करने और बाद में बैकअप लेने की आदत इस तरह के नए प्रोजेक्ट पर विफल हो जाती है।

यहाँ क्या प्रमाणित नहीं है

इस सॉफ़्टवेयर की आयु के बारे में ईमानदार रहें। संस्करण 0.1.3 को 5 August 2026 को रिलीज़ किया गया था, और 12 October 2026 तक स्टेबल लाइन 0.8.0 तक पहुँच गई थी। अधिकांश रिलीज़ नोट्स अभी भी स्वचालित changelogs हैं; 0.8.0 नोट्स हाथ से लिखे गए हैं लेकिन उनमें कोई माइग्रेशन सेक्शन नहीं है, और सार्वजनिक रिलीज़ का इतिहास लगभग तीन महीने पुराना है। इस गाइड में कुछ भी दीर्घकालिक परिणाम नहीं है, इसलिए मेमोरी ग्रोथ, डेटाबेस का आकार और शेड्यूलर की विश्वसनीयता को अपने स्वयं के बॉक्स पर मापने वाली चीज़ों के रूप में मानें, न कि ऐसी चीज़ें जिन्हें मान लिया जाए।

दो व्यवहार ऐसे हैं जिन्हें आप पर निर्भर होने से पहले स्वयं टेस्ट करना उचित है। पहला, क्या डाउनग्रेड नए संस्करण द्वारा लिखे गए स्टेट को पढ़ पाता है: इसे वॉल्यूम की एक कॉपी पर तब आज़माएं जब यह महत्वपूर्ण न हो, न कि आउटेज के दौरान। दूसरा, जब कोई निर्धारित जॉब (scheduled job) ड्यू हो और उसी समय Kiro साइन-इन समाप्त हो जाए, तो गेटवे क्या करता है। ये दोनों ही ऐसी कमियां हैं जिन्हें एक नया प्रोजेक्ट रिलीज़ के बीच चुपचाप ठीक कर देता है, और इन दोनों की जांच अभी करना आसान है।

FAQ

KiroCrew डैशबोर्ड मेरे सर्वर के पब्लिक IP पर क्यों नहीं खुल रहा है?

क्योंकि प्रकाशित उदाहरण पोर्ट को लूपबैक (loopback) पर बाइंड करता है। -p 127.0.0.1:5476:5476 कंटेनर के पोर्ट को केवल होस्ट के लूपबैक एड्रेस पर मैप करता है, जो जानबूझकर किया गया है। इसे एक्सेस करने के लिए ssh -N -L 5476:127.0.0.1:5476 you@your-server के साथ पोर्ट को SSH के माध्यम से फॉरवर्ड करें, और फिर अपने लैपटॉप पर http://localhost:5476/?token=<token> खोलें। इसे पब्लिक इंटरनेट पर उपलब्ध कराने के लिए 127.0.0.1: प्रीफिक्स को हटाने से गेटवे पब्लिक इंटरनेट पर आ जाएगा, और ufw इसे सुरक्षित नहीं रख पाएगा, क्योंकि Docker के पब्लिश्ड-पोर्ट DNAT रूल्स ufw के रूल्स लागू होने से पहले ही ट्रैफिक को रूट कर देते हैं। पब्लिश्ड पोर्ट्स को फ़िल्टर करने के लिए Docker की DOCKER-USER चेन (iptables बैकएंड के साथ) या अलग nftables बेस चेन (nftables बैकएंड के साथ) का उपयोग करें; लूपबैक बाइंडिंग बनाए रखना अधिक सरल है।

KiroCrew अपना डेटा कहाँ स्टोर करता है, और मुझे किसका बैकअप लेना चाहिए?

सब कुछ ~/.kiro/crew के अंतर्गत स्थित है, जो कंटेनर इमेज के अंदर /home/kirocrew/.kiro/crew है, और KIROCREW_HOME इसे रिलोकेट करता है। गेटवे को रोककर पूरी डायरेक्टरी या पूरे Docker वॉल्यूम का बैकअप लें। memory.db और memory_index.db SQLite डेटाबेस हैं, इसलिए गेटवे के लिखते समय ली गई कॉपी असंगत (inconsistent) हो सकती है। नए होस्ट पर जाते समय, workspace/memory/, दोनों डेटाबेस फाइलें और config.json को साथ ले जाएं, जबकि PID फाइलें, सिक्योरिटी इवेंट लॉग और .env पुराने होस्ट के ही रहने चाहिए।

क्या मुझे stable टैग का उपयोग करना चाहिए या वर्जन टैग का?

वर्जन टैग का उपयोग करें। stable हर बार बदलता है जब कोई नया सॉफ्टवेयर रिलीज होता है, इसलिए अगली बार 'pull' करने पर आपके द्वारा चलाया जा रहा वर्जन बदल सकता है, और टैग खुद यह नहीं बताता कि क्या चल रहा है। 0.8.0 जैसे वर्जन टैग अपरिवर्तनीय (immutable) होते हैं, और यही कारण है कि रोलबैक काम करता है: आप पुराना नंबर वापस डालते हैं और आपको वही इमेज मिल जाती है। 1 नवंबर 2026 तक नवीनतम स्टेबल रिलीज 0.11.1 है।

मेरा एजेंट कोई भी कमांड चलाने से मना क्यों कर रहा है?

कंटेनर अपनी पहली शुरुआत पर सैंडबॉक्स सपोर्ट की जांच करता है। यदि यह एजेंट सब-प्रोसेस को आइसोलेट नहीं कर पाता है और KIROCREW_ALLOW_UNSANDBOXED=1 सेट नहीं है, तो यह उन्हें अनकन्फाइंड (unconfined) चलाने के बजाय निष्पादित करने से मना कर देता है, जिससे गेटवे स्वस्थ दिखता है लेकिन हर टास्क रुक जाता है। docker logs kirocrew उस पहली रन से सैंडबॉक्स का निर्णय दिखाता है। इस वेरिएबल को सेट करने से कंटेनर एजेंट और होस्ट के बीच एकमात्र सीमा बन जाता है, इसलिए यदि आप इसे सेट करते हैं, तो ऐसी कोई भी चीज माउंट न करें जिसे आप सीधे एजेंट को नहीं देना चाहते।

क्या KiroCrew को self-host करने के लिए Kiro अकाउंट की आवश्यकता है?

1 नवंबर 2026 तक, Kiro बैकएंड के लिए हाँ। KiroCrew Apache 2.0 के तहत फ्री सॉफ्टवेयर है, लेकिन उन बैकएंड्स पर इन्फरेंस (inference) आपके Kiro प्लान का उपयोग करता है। पिन किया गया 0.8.0 कंटेनर Kiro CLI का उपयोग करता है: docker exec -it kirocrew kiro-cli login चलाएं और अपने ब्राउज़र में डिवाइस कोड को अप्रूव करें, या स्वचालित उपयोग के लिए कंटेनर एनवायरनमेंट के माध्यम से KIRO_API_KEY पास करें। जब तक ऑथेंटिकेशन कॉन्फ़िगर नहीं होता, तब तक गेटवे स्टार्ट हो जाता है और डैशबोर्ड लोड हो जाता है, लेकिन इसके डिफ़ॉल्ट हार्नेस के पास बात करने के लिए कोई मॉडल नहीं होता। 0.10.0 के बाद से इसमें एक इन-बिल्ट KAS इंजन भी है जिसे kiro-cli इंस्टॉल करने की आवश्यकता नहीं है; 0.11.0 ने KAS को बिना किसी सेव्ड हार्नेस विकल्प वाले नए इंस्टॉलेशन के लिए डिफ़ॉल्ट बना दिया है, जबकि स्पष्ट Kiro CLI चयन को सुरक्षित रखा है। KAS kiro-cli login के बजाय Crew के अपने साइन-इन का उपयोग करता है। प्रोजेक्ट की कस्टम बैकएंड गाइड एक claude हार्नेस को मुख्य मॉडल टर्न्स को आपके द्वारा चुने गए Anthropic-संगत एंडपॉइंट पर भेजने की अनुमति देती है, लेकिन Kiro-विशिष्ट सुविधाओं के लिए kiro-cli साइन-इन अभी भी आवश्यक है।

क्या यह लेख उपयोगी था?