SSD Nodes Learn Hosting plans →
मार्गदर्शक Matt Connorद्वारे Matt Connor

VPS वर KiroCrew कसे होस्ट करावे: संपूर्ण मार्गदर्शक

तुमच्या VPS वर KiroCrew ला Docker कंटेनर म्हणून कसे सेट करावे ते शिका. यामुळे सिमेंटिक मेमरी आणि शेड्युल केलेली कामे रीबूटनंतरही सुरक्षित राहतात. systemd आणि बॅकअपसह सेटअप करा.

लॅपटॉपऐवजी VPS वर KiroCrew self-host का करावे

KiroCrew self-host करण्याचा फायदा केवळ कधीही sleep न होणाऱ्या मशीनवर होतो. त्यामुळे त्यासाठी VPS योग्य आहे; laptop योग्य नाही. KiroCrew session history, semantic memory, scheduled jobs आणि approval queue डिस्कवर ठेवते आणि process पुन्हा सुरू झाल्यावर ही सर्व माहिती पुन्हा load करते. Scheduled job ची वेळ 03:00 वाजता आली तेव्हा process चालू नसेल, तर यापैकी कशाचाही उपयोग होत नाही. बंद laptop वर process चालू नसतो.

KiroCrew हे Kiro team कडून विकसित केलेले open source agent workspace आहे. ते Apache 2.0 परवान्याखाली उपलब्ध आहे आणि 0.1.0 22 July 2026 रोजी release झाले. gateway नावाचा एक process state व्यवस्थापित करतो आणि port 5476 वर web dashboard उपलब्ध करून देतो. या gateway पर्यंत dashboard, kirocrew CLI किंवा Slack सारख्या chat channel मधून पोहोचता येते. तुम्ही self-host करत असलेली एकमेव गोष्ट gateway आहे. त्यामुळे हा मार्गदर्शक ते सतत चालू ठेवणे, public internet पासून दूर ठेवणे आणि एखाद्या खराब upgrade नंतर पुन्हा स्थापित करता येणे यावर केंद्रित आहे.

सुरू करण्यापूर्वी दोन गोष्टी जाणून घ्या. 0.11.0 पासून, saved harness choice नसलेल्या नवीन KiroCrew installation मध्ये kiro-cli आवश्यक नसते; त्याऐवजी default म्हणून KAS निवडले जाते. आधी स्पष्टपणे केलेल्या Kiro CLI निवडी जशाच्या तशा राखल्या जातात. Kiro backends वरील inference तुमचा Kiro plan वापरते. त्यामुळे 1 November 2026 पर्यंत ही default setup offline नाही. हा project अजून सुरुवातीच्या टप्प्यात आहे आणि वेगाने बदलत आहे. त्याच्या stable releases 0.1.3 पासून 5 August 2026 रोजी 0.10.0 पर्यंत 25 October 2026 रोजी पोहोचल्या. या काळात 9 October रोजी 0.8.0 आणि 16 October रोजी 0.9.0 release झाले. तसेच 0.11.0 release candidate 25 October रोजी pre-release म्हणून उपलब्ध झाला होता. एखाद्या टप्प्यावर rollback करावे लागेल असे गृहीत धरा आणि ते शक्य होईल अशा पद्धतीने installation करा. तुम्ही यापूर्वी server वर agent चालवला नसेल, तर VPS वर coding agent चालवणे हा मार्गदर्शक ज्या मूलभूत नियमांवर आधारित आहे ते स्पष्ट करतो. Server पेक्षा agent side तुमच्यासाठी नवीन असेल, तर आधी agent loop, त्याची tools आणि त्याची memory प्रत्यक्षात काय आहेत हे समजून घेणे उपयुक्त ठरेल. त्यामुळे खालील निवडी केवळ incantations न वाटता निर्णय म्हणून समजतील.

KiroCrew ला काय आवश्यक आहे आणि त्याची स्थिती कुठे साठवली जाते

Native install साठी Python 3.12 किंवा त्यानंतरची आवृत्ती आवश्यक आहे. Dashboard source मधून build करत असल्यास Node.js 22.12.0 किंवा त्यानंतरची आवृत्ती आवश्यक आहे. Project Node 24 LTS ची शिफारस करते. Kiro CLI backend साठी kiro-cli आवश्यक आहे. Automated वापरासाठी ते kiro-cli login किंवा API key ने authenticate करावे लागते. 0.10.0 पासून built-in KAS engine kiro-cli install केल्याशिवाय चालतो. 0.11.0 ने saved harness choice नसलेल्या नवीन installs साठी त्याला default केले. Container install साठी host वर यापैकी काहीही आवश्यक नाही. त्यासाठी Docker आवश्यक आहे. Container install पसंत करण्याचे हे मुख्य कारण आहे.

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/: पहिल्यांदा चालू केल्यावर download केले जाणारे embedding model.
  • security_events.jsonl: security event log.

ही directory म्हणजेच पूर्ण install आहे. ती नवीन VPS वर copy केल्यास तुमचा agent तिथे हलतो. म्हणून खालील backup section ला install section पेक्षा अधिक महत्त्व आहे.

RAM ऐवजी disk साठी नियोजन करा. Gateway ही Python process आहे. मात्र मशीनवरचा प्रत्यक्ष भार agent चालवत असलेल्या गोष्टी, build किंवा test suite मुळे येतो. Chat history वाढत गेल्याने state directory मोठी होते. पहिल्यांदा सुरू केल्यावर embedding model download होते. त्यामुळे project च्या सुरुवातीच्या महिन्यांत प्रकाशित केलेल्या कोणत्याही आकड्यावर अवलंबून राहू नका. काही आठवड्यांनंतर स्वतःच्या मशीनवर du -sh ~/.kiro/crew वापरून तिचा आकार मोजा. प्रत्येक worker साठी स्वतंत्र container आणि स्वतंत्र browser देणाऱ्या runtime च्या तुलनेत हा फरक लक्षात घ्या. अशा runtime मध्ये OpenBot चे AI coworkers self-host करणे हे disk पेक्षा आधी RAM चा प्रश्न बनते.

तुम्ही चार install paths पैकी कोणता वापरावा

प्रकल्प चार पर्याय प्रकाशित करतो: desktop app, one-line wheel, source आणि Docker. one-line installer एक wheel fetch करतो आणि kirocrew launcher तयार करतो. त्याची directory तुमच्या PATH मध्ये नसल्यास, तो ती जोडण्यासाठी सूचना दाखवतो:

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 बदलणाऱ्या लोकांसाठी आहे, तो फक्त code चालवणाऱ्या लोकांसाठी नाही.

container वापरा. Native source install केल्यास Python packages आणि Node तुमच्या इतर services चालवणाऱ्या त्याच host वर स्थापित होतात. Kiro CLI backend वापरताना kiro-cli देखील त्याच host वर येतो. त्यामुळे upgrade अयशस्वी झाल्यास ही व्यवस्था manually दुरुस्त करावी लागते. Container runtime एका image मध्ये आणि state एका volume मध्ये ठेवतो. त्यामुळे rollback करण्यासाठी tag बदलून restart करणे पुरेसे असते.

प्रतिमा stable वर नव्हे, तर release tag वर निश्चित करा

प्रकल्पाच्या स्वतःच्या उदाहरणात 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 हा बदलणारा tag आहे. latest देखील बदलणारा tag आहे आणि तो त्याच release कडे निर्देश करतो. तो त्या वेळी उपलब्ध असलेल्या नवीनतम stable release कडे निर्देश करतो. त्यामुळे पुढील pull वेळी तुमची निवड नसतानाही चालू असलेली आवृत्ती बदलू शकते. तसेच, कोणती आवृत्ती वापरली गेली हे tag वरून समजत नाही. Version tags अपरिवर्तनीय असतात. त्यामुळे त्यापैकी एक tag निश्चित करा. 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:

ते सुरू करा. त्यानंतर image स्वतःच्या HEALTHCHECK साठी वापरत असलेला health endpoint तपासा:

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 देखील token शिवाय प्रतिसाद देतात. त्यामुळे ते probes म्हणून वापरता येतात. स्थिती starting वरच राहिल्यास, काहीही बदलण्यापूर्वी docker logs kirocrew वाचा. पहिल्या run वेळी embedding model पार्श्वभूमीत download होते. ते उपलब्ध होईपर्यंत 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) असे असावे, जे या युनिटसाठी योग्य परिणाम आहे. Type=oneshot सह RemainAfterExit=yes चा वापर येथे योग्य आहे कारण कंटेनर सुरू होताच docker compose up -d लगेच परत येते: systemd हे स्टॅक सुरू आहे की नाही हे ट्रॅक करत आहे, कोणताही foreground process नाही. त्याऐवजी Type=simple लिहिल्यास, systemd ला कमांड लगेच बंद झाल्याचे दिसते, ती सेवा 'dead' म्हणून चिन्हांकित केली जाते आणि तुमच्या Restart= सेटिंगनुसार ती एकतर प्रयत्न करणे थांबवते किंवा restart-loop मध्ये जाते. नेटिव्ह इन्स्टॉलेशनसाठी हा प्रोजेक्ट स्वतःची समतुल्य फाईल, kirocrew service install, प्रदान करतो, जी /etc/systemd/system/kirocrew.service लिहिते आणि गेटवे तुमच्या युजरच्या नावाने चालवते. दोन्ही युनिट्स एकाच वेळी चालवू नका. या विषयाची अधिक विस्तृत माहिती VPS वरील systemd सर्व्हिसेस आणि टायमर्स मध्ये दिली आहे. एखादी सेवा पुन्हा सुरू होण्यास अपयशी ठरल्यास ती शांत राहते, जोपर्यंत तुम्ही तिला सूचित करण्यास सांगत नाही. म्हणून, एक OnFailure= हँडलर जोडा जो तुमच्या स्वतःच्या ntfy सर्व्हरवर अलर्ट पाठवेल, ज्यामुळे गेटवे बंद असल्याची माहिती तुम्हाला तुमच्या फोनवर मिळेल, त्याऐवजी ती माहिती कधीही न चाललेल्या शेड्युल्ड जॉबकडून मिळण्याची वाट पाहावी लागणार नाही.

पहिला वापर: साइन इन करा आणि dashboard token मिळवा

Container gateway सुरू करतो; मात्र pinned 0.8.0 image मधील default Kiro CLI runtime साठी अजून authentication आवश्यक आहे. Container मध्ये साइन इन करा किंवा स्वयंचलित वापरासाठी container environment मधून KIRO_API_KEY द्या:

docker exec -it kirocrew kiro-cli login

यामुळे device code आणि URL दिसतो. तो URL तुमच्या स्वतःच्या browser मध्ये उघडा. त्यानंतर dashboard token तयार करा:

docker exec kirocrew kirocrew token --ttl 2h

Dashboard URL http://localhost:5476/?token=<the token> आहे. Tokens ची मुदत संपते. Token तयार केल्यानंतर दाखवलेली link पाच मिनिटांच्या आत उघडावी लागते. या command मधून दोन तासांचा access cookie मागितला जातो; documented maximum वीस तासांचा आहे. Browser ला 30 दिवसांची sliding idle window असलेला refresh cookie देखील मिळतो. त्यामुळे active session दुसरी link न उघडता renew होते. Dashboard रिकामा दिसत असेल किंवा उघडल्यानंतर लगेच तुम्हाला पुन्हा बाहेर पाठवत असेल, तर token ची मुदत संपलेली असण्याची शक्यता असते. नवीन token तयार करा आणि तो लगेच उघडा. Token ticket किंवा chat message मध्ये कधीही paste करू नका, कारण token ज्याच्याकडे असेल त्याला तुमच्या agent वर नियंत्रण मिळते.

SSH वरून dashboard पर्यंत पोहोचा आणि port 5476 कधीही सार्वजनिक करू नका

प्रकल्पाच्या उदाहरणातील 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 काढून टाकल्यास, तो port scan करणाऱ्या कोणत्याही व्यक्तीसाठी gateway सार्वजनिक internet वर उपलब्ध होतो. ufw rule देखील तुम्हाला वाचवणार नाही. Docker port publish करण्यासाठी DNAT rules लिहितो आणि त्या traffic ला ufw चे rules लागू होण्यापूर्वी route करतात. त्यामुळे ufw deny 5476 published port वर काहीही परिणाम करत नाही. Docker च्या default iptables backend मध्ये filtering rules त्याच्या DOCKER-USER chain मध्ये ठेवणे हा Docker चा स्वतःचा उपाय आहे. हा उपाय कार्य करतो. मात्र conntrack extension वापरून match केल्याशिवाय त्या rules ना container चा internal address आणि port दिसतात. त्यामुळे loopback bind हे अधिक सोपे आणि चुकून चुकीचे configure होण्याची शक्यता कमी असलेले नियंत्रण राहते. Docker चे nftables backend त्याऐवजी custom filtering साठी स्वतंत्र nftables tables आणि base chains वापरते. ufw ला bypass करणारे Docker ports त्या यंत्रणेचे स्पष्टीकरण देते.

त्याऐवजी तुमच्या 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 आपोआप सुरू करण्यासाठी तो ~/.ssh/config मध्ये जोडा:

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

तुमच्या laptop वर port 5476 आधीच वापरात असल्यास, फक्त डावीकडील संख्या बदला: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com. त्यानंतर http://localhost:45476/?token=... वर browse करा. Loopback-port setting बदलण्याची किंवा container पुन्हा तयार करण्याची आवश्यकता नाही. Loopback Origin हा request च्या स्वतःच्या Host शी जुळतो, त्यामुळे CSRF check तो स्वीकारतो. दुसरा agent त्याच server वर share करू लागल्यावर तुम्ही अशा forwards चे stacking कराल, कारण security scanning साठी self-hosting open-kritt त्याच server वर port 5173 वर loopback-only दुसरे dashboard चालवते.

Dashboard मधून कोणती settings बदलता येतात, हे दोन documented behaviours ठरवतात. प्रथम, forwarding headers (Forwarded, X-Forwarded-* किंवा X-Real-IP) असलेली कोणतीही request gateway remote समजतो आणि त्याचे config-write तसेच secret-reveal endpoints अशा requests नाकारतात. Reverse proxy हे headers जोडतो. साधा ssh -L forward कोणतेही headers जोडत नाही, त्यामुळे त्या कारणावरून तो local दिसतो आणि नाकारला जात नाही. दुसरे म्हणजे, container image मध्ये direct-local नसलेल्या कोणत्याही browser साठी channel-credential pages आणि secret-revealing views read-only असतात. तसेच image मध्ये text editor दिलेला नाही. Dashboard मधून channel credential save होत नसेल, तर ते bug नसून याच कारणामुळे आहे. त्याऐवजी host वर configuration 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 कडे निर्देश करतो. त्यामुळे dashboard public hostname वर ठेवण्याऐवजी ते तुमच्या स्वतःच्या tailnet मध्येच राहते. Public reverse proxy पेक्षा हा पर्याय वापरा. Token URL मध्ये पाठवला जातो आणि त्या URL कडे जाणाऱ्या प्रत्येक access log मध्ये तो URL लिहिला जातो. हा नियम port स्वतःबद्दल नसून त्या port मागे असलेल्या सेवेबद्दल आहे. उदाहरणार्थ, Jellyfin library browsable 90s video store म्हणून पुन्हा तयार करणारे Halcyon इतर लोकांनी उघडण्यासाठी उपलब्ध असते आणि ते reverse proxy साठी योग्य उमेदवार आहे. मात्र तुमच्या server वर commands चालवू शकणारा gateway reverse proxy मागे ठेवू नका.

तुम्ही agent ला शक्य तितकी मर्यादित हानीची व्याप्ती द्या

कंटेनर पहिल्यांदा सुरू होताना sandbox समर्थनाची तपासणी करतो. त्या तपासणीच्या निकालावर agent काहीही execute करू शकतो की नाही हे ठरते. Namespace isolation उपलब्ध असल्यास agent चे subprocesses isolated पद्धतीने चालतात. ते उपलब्ध नसल्यास आणि KIROCREW_ALLOW_UNSANDBOXED=1 सेट केलेले नसल्यास, execution unconfined पद्धतीने चालवण्याऐवजी नाकारले जाते. त्यामुळे gateway निरोगी दिसत असताना प्रत्येक task अडकत असेल, तर हेच बहुतेकदा कारण असते. हा निर्णय पहिल्या run मधील docker logs kirocrew मध्ये नोंदवला जातो. प्रकल्प seccomp (secure computing mode) profile देखील प्रकाशित करतो. तो तुम्ही लागू करू शकता:

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 सक्षम असलेल्या host वर, प्रकल्पाच्या Docker guide नुसार seccomp profile हा बदलाचा फक्त अर्धा भाग आहे. Docker त्याचा docker-default AppArmor profile देखील जोडतो आणि तो profile apparmor=unconfined सोबत वापरतो. हा option केवळ AppArmor चे प्रत्येक container वरील नियम शिथिल करतो. seccomp profile, काढून टाकलेल्या capabilities आणि non-root user लागूच राहतात.

तुम्ही KIROCREW_ALLOW_UNSANDBOXED=1 सेट करत असाल, तर काय बदलले आहे हे स्पष्टपणे समजा: आता agent आणि तुमच्या server मधील एकमेव boundary कंटेनर आहे. प्रकल्पाचा इशारा पूर्णपणे पुन्हा सांगणे महत्त्वाचे आहे. ज्या host paths तुम्ही agent ला थेट देणार नाही, ते mount करू नका. प्रत्यक्षात यामुळे Docker socket, / चा कोणताही bind mount आणि इतर service चा data असलेली कोणतीही directory वगळली जाते.

उर्वरित उपाययोजना commands चालवण्याची परवानगी असलेल्या प्रत्येक agent ला लागू होतात. त्याची credentials त्याला आवश्यक असलेल्या एकाच repository किंवा एकाच bucket पुरती मर्यादित ठेवा. account-wide अधिकार असलेला वैयक्तिक token कधीही वापरू नका. अशा dedicated user म्हणून ते चालवा ज्याच्या home मध्ये इतर कोणतीही सामग्री नाही. VPS वरील किमान-अधिकार असलेले users याच उद्देशासाठी आहेत. Agent code लिहून तोच code चालवत असल्यास, तो बिघडवू शकतो अशा machine वर त्याला चालवा. coding agents साठी disposable VM ही या compose file मधील कोणत्याही flag पेक्षा मजबूत boundary आहे, कारण साफसफाई करण्याऐवजी तुम्ही ती delete करू शकता. हाच विचार VPS वर OpenClaw सुरक्षितपणे चालवणे आणि VPS वर Hermes agent self-host करणे यांनाही लागू होतो. Tools मुळेही हानीची व्याप्ती वाढते. Agent ला web search दिल्यास, त्याने fetch केलेले प्रत्येक page untrusted input बनते. त्यामुळे तुमच्या स्वतःच्या SearXNG instance कडे agent निर्देशित करणे हा plumbing इतकाच prompt injection शी संबंधित निर्णय आहे. Scheduled work मुळे तुम्ही झोपेत असतानाही खर्च होतो, कारण Kiro backends वरील inference तुमचा Kiro plan वापरते. त्यामुळे nightly job जोडण्यापूर्वी VPS वर AI agent चा खर्च नियंत्रित करणे येथे वर्णन केलेल्या मर्यादा सेट करा.

प्रत्येक अपग्रेडपूर्वी स्टेट व्हॉल्यूमचा बॅकअप घ्या

प्रथम प्रत्यक्ष व्हॉल्यूमचे नाव शोधा. Compose प्रोजेक्टच्या नावासह व्हॉल्यूमना उपसर्ग जोडते, जे डीफॉल्टनुसार डिरेक्टरीचे नाव असते. त्यामुळे /opt/kirocrew/compose.yaml मध्ये kirocrew-home म्हणून घोषित केलेला व्हॉल्यूम kirocrew_kirocrew-home म्हणून तयार होतो:

docker volume ls

काहीही कॉपी करण्यापूर्वी गेटवे थांबवा. memory.db आणि memory_index.db या SQLite डेटाबेस फाइल्स आहेत. डेटाबेसमध्ये माहिती लिहिली जात असताना तो कॉपी केल्यास अर्धवट व्यवहार (transaction) कॉपी होऊ शकतो, ज्यामुळे रिस्टोर करताना फाइल करप्ट होऊ शकते. प्रोजेक्टच्या स्वतःच्या मायग्रेशन सूचनांमध्येही हेच सांगितले आहे: गेटवे थांबवलेले असतानाच मेमरी हलवा. हा 'प्रथम थांबवा' नियम फक्त KiroCrew साठीच नाही, तर जर एखादा फोटो सर्व्हर त्याच बॉक्सवर असेल, तर PhotoPrism आणि Immich तुलना या लेखात त्या प्रत्येकासाठी आवश्यक असलेल्या अचूक बॅकअप कमांड्स दिल्या आहेत.

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

बॉक्सवरून आर्काइव्ह बाहेर कॉपी करा. रिस्टोर करण्याची प्रक्रिया हीच कमांड वापरून केली जाते, फक्त कंटेनर थांबवलेला असावा आणि 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

नवीन होस्टवर स्थलांतर करणे हे त्याच ठिकाणी रिस्टोर करण्यापेक्षा वेगळे काम आहे आणि त्याबद्दल प्रोजेक्टमध्ये स्पष्ट सूचना आहेत. workspace/memory/ अंतर्गत असलेला चॅट इतिहास आणि प्रोजेक्ट नोट्स तसेच दोन्ही डेटाबेस फाइल्स आणि config.json नवीन होस्टवर नेले जाऊ शकतात. PID फाइल्स, सिक्युरिटी इव्हेंट लॉग आणि .env हे जुन्या होस्टशी संबंधित असतात, त्यामुळे त्यांना तिथेच सोडून द्या आणि नवीन बॉक्सवर सिक्रेट्स पुन्हा प्रविष्ट करा.

चुकीचे अपग्रेड रोलबॅक कसे करावे

अपग्रेड करण्याची प्रक्रिया जलद असते आणि ती सुरक्षित असते कारण तुम्ही एक विशिष्ट व्हर्जन पिन केलेले असते. प्रथम बॅकअप घ्या आणि त्यानंतर टॅग बदला:

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 ती पुल करते, त्यामुळे टॅग बदलणे हीच संपूर्ण अपग्रेड प्रक्रिया आहे. रोलबॅक करण्यासाठी जुन्या नंबरसह हीच प्रक्रिया पुन्हा करा. यामुळे तुम्हाला पूर्वीचीच तंतोतंत इमेज मिळते, कारण व्हर्जन टॅग्स हे immutable (अपरिवर्तनीय) असतात.

बायनरी व्यवस्थित रोलबॅक होते. मात्र, स्टेट (state) रोलबॅक न होण्याची शक्यता असते. नवीन गेटवे config.json मध्ये बदल करू शकतो किंवा मेमरी डेटाबेसचे अशा स्वरूपात स्थलांतर करू शकतो जे जुन्या गेटवेला वाचता येत नाही. 12 ऑक्टोबर 2026 पर्यंत, स्टेटसाठी कोणताही डाउनग्रेड मार्ग दस्तऐवजीकरण केलेला नाही. इन्स्टॉल गाइड एका गोष्टीबाबत स्पष्ट आहे: जुन्या ~/.kirocrew होममधून हलवलेला डेटा रोलबॅक करता येत नाही आणि ~/.kiro/crew च्या आधीचे रिलीज रिकाम्या स्थितीत सुरू होईल. त्यामुळे जर जुनी इमेज सुरू झाली आणि विचित्र वागू लागली, तर त्याचे डीबगिंग करू नका. ती थांबवा, अपग्रेड करण्यापूर्वी घेतलेला बॅकअप रिस्टोर करा आणि पुन्हा सुरुवात करा. बॅकअप प्रथम घेण्याचे हेच मुख्य कारण आहे आणि म्हणूनच 'आधी अपग्रेड आणि नंतर बॅकअप' घेण्याची सवय इतक्या नवीन प्रोजेक्टवर अपयशी ठरते.

येथे काय सिद्ध झालेले नाही

या सॉफ्टवेअरचे वय स्पष्टपणे लक्षात घ्या. Version 0.1.3 5 August 2026 रोजी प्रसिद्ध झाले आणि 12 October 2026 पर्यंत stable line 0.8.0 पर्यंत पोहोचली होती. बहुतेक release notes अजूनही automated changelogs आहेत; 0.8.0 notes हाताने लिहिलेल्या आहेत, परंतु त्यात migration section नाही. सार्वजनिक release history सुमारे तीन महिन्यांची आहे. या मार्गदर्शकातील कोणताही निष्कर्ष दीर्घकालीन वापरावर आधारित नाही. त्यामुळे memory growth, database size आणि scheduler reliability या गोष्टी गृहीत न धरता स्वतःच्या box वर मोजून तपासा.

तुम्ही त्यांच्यावर अवलंबून राहण्यापूर्वी दोन behaviours स्वतः तपासणे योग्य ठरेल. पहिले, downgrade नवीन version ने लिहिलेली state वाचतो का ते तपासा. outage दरम्यान नव्हे, तर परिणाम महत्त्वाचा नसताना volume च्या copy वर ही चाचणी करा. दुसरे, scheduled job ची वेळ आलेली असताना Kiro sign-in expire झाल्यास gateway काय करतो ते तपासा. तरुण project मध्ये releases दरम्यान अशा rough edges शांतपणे दुरुस्त केल्या जातात. त्यामुळे या दोन्ही गोष्टी आत्ताच तपासणे सोपे आणि कमी खर्चाचे आहे.

FAQ

KiroCrew डॅशबोर्ड माझ्या सर्व्हरच्या सार्वजनिक IP वर का उघडत नाही?

प्रकाशित उदाहरणात पोर्ट loopback वर bind केलेला आहे. -p 127.0.0.1:5476:5476 कंटेनरचा पोर्ट फक्त host च्या loopback address वर map करते; हे जाणीवपूर्वक केलेले आहे. ssh -N -L 5476:127.0.0.1:5476 you@your-server वापरून SSH द्वारे पोर्ट forward करा आणि तुमच्या laptop वर http://localhost:5476/?token=<token> उघडा. तो पोर्ट सार्वजनिकरीत्या उपलब्ध करण्यासाठी 127.0.0.1: prefix काढल्यास gateway सार्वजनिक internet वर उघडतो. Docker चे published-port DNAT rules, ufw चे rules लागू होण्यापूर्वीच traffic route करतात. त्यामुळे ufw तो traffic नियंत्रित करू शकत नाही. Published ports filter करण्यासाठी Docker ची DOCKER-USER chain तिच्या iptables backend सह, किंवा स्वतंत्र nftables base chains तिच्या nftables backend सह वापरा. Loopback bind ठेवणे अधिक सोपे आहे.

KiroCrew त्याचा data कुठे साठवते आणि मी कशाचा backup घ्यावा?

सर्व data ~/.kiro/crew अंतर्गत असतो. Container image मध्ये हा path /home/kirocrew/.kiro/crew आहे आणि KIROCREW_HOME तो relocate करते. Gateway थांबवून संपूर्ण directory किंवा संपूर्ण Docker volume चा backup घ्या. memory.db आणि memory_index.db हे SQLite databases आहेत. त्यामुळे gateway लिहित असताना घेतलेली copy inconsistent असू शकते. नवीन host वर स्थलांतर करताना workspace/memory/, दोन्ही database files आणि config.json सोबत नेले जातात. मात्र PID files, security event log आणि .env हे जुन्या host शी संबंधित असतात.

मी stable tag वापरावा की version tag?

Version tag वापरा. stable प्रत्येक release झाल्यावर बदलतो. त्यामुळे पुढील pull वेळी तुम्ही चालवत असलेली version बदलू शकते आणि सध्या कोणती version चालू आहे हे tag वरून कळत नाही. 0.8.0 सारखे version tags immutable असतात. त्यामुळे rollback करता येतो: जुना number पुन्हा ठेवला की अगदी तोच image मिळतो. 1 November 2026 रोजी नवीनतम stable release 0.11.1 आहे.

माझा agent कोणतीही command चालवण्यास नकार का देतो?

Container पहिल्यांदा सुरू होताना sandbox support तपासतो. Agent subprocesses isolate करता आले नाहीत आणि KIROCREW_ALLOW_UNSANDBOXED=1 set केलेले नसल्यास, container ते subprocesses unconfined पद्धतीने चालवण्याऐवजी नकार देतो. त्यामुळे gateway healthy दिसतो, पण प्रत्येक task अडकतो. docker logs kirocrew पहिल्या run मधील sandbox decision दाखवते. हे variable set केल्यास agent आणि host यांच्यातील एकमेव boundary container राहते. त्यामुळे हे variable set करताना agent ला थेट देणार नसलेली कोणतीही गोष्ट mount करू नका.

KiroCrew self-host करण्यासाठी Kiro account आवश्यक आहे का?

Kiro backends साठी, 1 November 2026 रोजीच्या स्थितीनुसार, होय. KiroCrew हे Apache 2.0 अंतर्गत उपलब्ध free software आहे. मात्र या backends वरील inference साठी तुमचा Kiro plan वापरला जातो. Pinned 0.8.0 container Kiro CLI वापरते. docker exec -it kirocrew kiro-cli login चालवून browser मध्ये device code मंजूर करा, किंवा automated use साठी KIRO_API_KEY container environment मधून pass करा. Authentication configure करेपर्यंत gateway सुरू होतो आणि dashboard load होते. मात्र त्याच्या default harness कडे संवाद साधण्यासाठी model नसतो. 0.10.0 पासून अंगभूत KAS engine देखील उपलब्ध आहे. ते kiro-cli installed असण्याची गरज ठेवत नाही. Saved harness choice नसलेल्या नवीन installs साठी 0.11.0 ने KAS ला default केले आहे. Explicit Kiro CLI selections मात्र कायम ठेवले आहेत. KAS, kiro-cli login ऐवजी Crew चे स्वतःचे sign-in वापरते. Project च्या custom backend guide मुळे claude harness ने तुम्ही निवडलेल्या Anthropic-compatible endpoint कडे मुख्य model turns पाठवता येतात. मात्र Kiro-specific features साठी kiro-cli sign-in आवश्यकच राहते.

हा लेख उपयुक्त होता का?