VPS پر KiroCrew self-host کریں، agent ہمیشہ آن رکھیں
KiroCrew کو اپنے VPS پر pinned Docker container کے طور پر چلائیں۔ systemd، SSH، backups اور rollback کے ساتھ memory اور schedules reboot کے بعد بھی محفوظ رہیں۔
لیپ ٹاپ کے بجائے VPS پر KiroCrew کو self-host کیوں کریں
KiroCrew کو self-host کرنے کا فائدہ صرف ایسی مشین پر ہوتا ہے جو کبھی sleep نہ ہو، اس لیے VPS اس کے لیے درست جگہ ہے اور لیپ ٹاپ نہیں۔ KiroCrew session history، semantic memory، scheduled jobs اور approval queue کو disk پر محفوظ رکھتا ہے، اور process restart ہونے پر یہ سب دوبارہ load کر لیتا ہے۔ اگر scheduled job کے مقررہ وقت 03:00 پر process چل ہی نہ رہا ہو تو ان میں سے کوئی چیز مدد نہیں کرتی، اور بند لیپ ٹاپ پر process نہیں چلتا۔
KiroCrew، Kiro team کا open source agent workspace ہے، جسے Apache 2.0 کے تحت license کیا گیا ہے، اور 0.1.0 کو 22 July 2026 کو جاری کیا گیا تھا۔ ایک process، جسے gateway کہا جاتا ہے، state کا مالک ہوتا ہے اور port 5476 پر web dashboard فراہم کرتا ہے۔ آپ dashboard، kirocrew CLI، یا Slack جیسے chat channel سے اس gateway تک پہنچتے ہیں۔ آپ صرف gateway کو self-host کرتے ہیں، اس لیے یہ guide اسے فعال رکھنے، public internet سے دور رکھنے، اور خراب upgrade کے بعد اسے بحال کرنے کے طریقے پر مبنی ہے۔
شروع کرنے سے پہلے دو باتیں جان لیں۔ 0.11.0 کے بعد، محفوظ harness choice کے بغیر نئی KiroCrew installations بطور default KAS استعمال کرتی ہیں اور انہیں kiro-cli کی ضرورت نہیں ہوتی؛ پہلے سے واضح طور پر منتخب کیے گئے Kiro CLI options برقرار رہتے ہیں۔ Kiro backends پر inference آپ کے Kiro plan کو استعمال کرتا ہے، اس لیے 1 November 2026 تک یہ default setup 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 جاری ہوئے، اور 0.11.0 release candidate پہلے ہی 25 October کو pre-release کے طور پر دستیاب تھا۔ فرض کریں کہ کسی مرحلے پر آپ کو rollback کرنا پڑے گا، اور اسے ایسے طریقے سے install کریں جس سے یہ ممکن ہو۔ اگر آپ نے پہلے server پر agent نہیں چلایا، تو VPS پر coding agent چلانا ان بنیادی اصولوں کی وضاحت کرتا ہے جن پر یہ guide قائم ہے۔ اگر agent کا پہلو server کے مقابلے میں آپ کے لیے نیا ہے، تو پہلے سمجھیں کہ agent loop، اس کے tools اور اس کی memory حقیقت میں کیا ہیں؛ اس کے بعد درج ذیل فیصلے محض incantations کے بجائے واضح انتظامی فیصلے محسوس ہوں گے۔
KiroCrew کو کن چیزوں کی ضرورت ہے، اور اس کی state کہاں محفوظ رہتی ہے
Native install کے لیے Python 3.12 یا اس سے نیا ورژن درکار ہے۔ اگر آپ dashboard کو source سے build کرتے ہیں تو Node.js 22.12.0 یا اس سے نیا ورژن بھی درکار ہے۔ Project، Node 24 LTS استعمال کرنے کی سفارش کرتا ہے۔ Kiro CLI backend کے لیے kiro-cli درکار ہے، جسے kiro-cli login کے ذریعے authenticate کیا جاتا ہے، یا automated استعمال کے لیے API key درکار ہوتی ہے۔ 0.10.0 کے بعد built-in KAS engine، kiro-cli کے installed ہونے کے بغیر چلتا ہے۔ 0.11.0 نے اسے نئی installs کے لیے default بنا دیا، جب کوئی harness choice محفوظ نہ ہو۔ Container install کے لیے host پر ان میں سے کسی چیز کی ضرورت نہیں ہوتی۔ صرف Docker درکار ہے۔ Container install کو ترجیح دینے کی یہی بنیادی وجہ ہے۔
State ~/.kiro/crew میں محفوظ رہتی ہے، اور KIROCREW_HOME environment variable اسے کسی دوسری جگہ منتقل کر دیتا ہے۔ اس directory میں یہ چیزیں شامل ہوتی ہیں:
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 منتقل ہو جائے گا۔ اسی لیے نیچے دیا گیا backup section، install section سے زیادہ اہم ہے۔
RAM کے بجائے disk کے لیے منصوبہ بندی کریں۔ Gateway ایک Python process ہے۔ Server پر اصل load وہ چیز ڈالتی ہے جو agent چلاتا ہے، مثلاً build یا test suite۔ Chat history کے ساتھ state directory بڑھتی جاتی ہے، اور embedding model پہلی بار start ہونے پر download ہوتا ہے۔ اس لیے project کے ابتدائی مہینوں میں شائع کیے گئے کسی بھی عدد پر انحصار کرنے کے بجائے، چند ہفتوں بعد اپنے server پر du -sh ~/.kiro/crew سے اس کا حجم ناپیں۔ اس کا موازنہ ایسے runtime سے کریں جو ہر worker کے لیے الگ container اور الگ browser فراہم کرتا ہے، جہاں OpenBot کے AI ساتھیوں کی self-hosting میں disk سے پہلے RAM کی گنجائش کا سوال پیدا ہوتا ہے۔
چار installation paths میں سے کون سا استعمال کریں
پروجیکٹ چار طریقے فراہم کرتا ہے: desktop app، one-line wheel، source، اور Docker۔ one-line installer ایک wheel حاصل کر کے 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.0container image ہر tag کے تحت linux/amd64 اور linux/arm64 کے لیے ghcr.io/kirodotdev/kirocrew پر شائع کی جاتی ہے۔ source build میں git clone اور make build شامل ہیں، اور یہ code میں تبدیلی کرنے والے افراد کے لیے ہے، اسے چلانے والے افراد کے لیے نہیں۔
container استعمال کریں۔ native source install کے ذریعے Python packages اور Node اسی host پر install ہوتے ہیں جہاں آپ کی دیگر services چل رہی ہوتی ہیں۔ Kiro CLI backend استعمال کرتے وقت kiro-cli بھی اسی host پر شامل ہوتا ہے۔ اس لیے غلط upgrade کے بعد آپ کو یہ تبدیلیاں دستی طور پر واپس درست کرنا پڑتی ہیں۔ container runtime کو ایک image اور state کو ایک volume میں رکھتا ہے۔ اس سے rollback صرف tag تبدیل کرنے اور restart کرنے تک محدود رہتا ہے۔
image کو stable کے بجائے release tag سے pin کریں
پروجیکٹ کی اپنی مثال میں stable tag استعمال کیا گیا ہے:
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stablestable ایک moving tag ہے، اور latest بھی ایسا ہی ہے، جو اسی release کی طرف اشارہ کرتا ہے۔ یہ اس وقت دستیاب تازہ ترین stable release کی طرف اشارہ کرتا ہے۔ اس لیے اگلا pull آپ کی اجازت کے بغیر چلنے والے version کو تبدیل کر سکتا ہے، اور tag یہ ریکارڈ نہیں کرتا کہ وہ version کون سا تھا۔ Version tags ناقابلِ تبدیلی ہوتے ہیں، اس لیے ایک version tag pin کریں۔ 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 follow کرتا ہے۔
/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:اسے شروع کریں، پھر health endpoint چیک کریں جسے image اپنے HEALTHCHECK کے لیے بھی استعمال کرتی ہے:
cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/healthdocker compose ps کو تقریباً ایک منٹ کے اندر container کو healthy رپورٹ کرنا چاہیے، اور /api/health بغیر token کے جواب دیتا ہے۔ /api/live اور /api/ready بھی ایسا ہی کرتے ہیں، اسی وجہ سے انہیں probes کے طور پر استعمال کیا جا سکتا ہے۔ اگر state starting پر برقرار رہے تو کچھ تبدیل کرنے سے پہلے docker logs kirocrew پڑھیں۔ پہلی بار چلانے پر embedding model پس منظر میں download ہوتا ہے؛ اس کے دستیاب ہونے تک memory search keyword matching استعمال کرتی ہے۔
systemd کے ساتھ اسے چلتا رکھیں
restart: unless-stopped crash کے بعد اور reboot کے بعد container کو دوبارہ شروع کرتا ہے، بشرطیکہ Docker خود boot کے وقت شروع ہو۔ ایک unit file اس dependency کو واضح کرتی ہے اور آپ کو ایک ایسی command دیتی ہے جو backup سے پہلے پورے stack کو روک دیتی ہے۔ boot کے وقت Docker Compose stack شروع کرنا عمومی طریقہ بیان کرتا ہے۔ 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.targetsudo systemctl daemon-reload
sudo systemctl enable --now kirocrew
systemctl status kirocrewsystemctl status kirocrew کو active (exited) دکھانا چاہیے، جو اس unit کے لیے صحت مند نتیجہ ہے۔ یہاں Type=oneshot کے ساتھ RemainAfterExit=yes درست ہے، کیونکہ container شروع ہوتے ہی docker compose up -d واپس آ جاتا ہے: systemd اس حقیقت کو track کر رہا ہے کہ stack چل رہا ہے، نہ کہ کسی foreground process کو۔ اس کے بجائے Type=simple لکھیں تو systemd دیکھتا ہے کہ command فوراً exit ہو گئی، service کو dead mark کر دیتا ہے، اور پھر آپ کی Restart= setting کے مطابق یا تو کوشش ترک کر دیتا ہے یا restart loop میں چلا جاتا ہے۔ native install کے لیے project اپنا مساوی unit، kirocrew service install، فراہم کرتا ہے، جو /etc/systemd/system/kirocrew.service لکھتا ہے اور gateway کو آپ کے user کے طور پر چلاتا ہے۔ دونوں units نہ چلائیں۔ اس موضوع کی وسیع تر وضاحت VPS پر systemd services اور timers میں ہے۔ جو unit دوبارہ شروع ہونے میں ناکام ہو، وہ خاموش رہتی ہے جب تک آپ اسے اطلاع دینے کا طریقہ نہ دیں؛ اس لیے OnFailure= handler شامل کریں جو آپ کے اپنے ntfy server پر alert بھیجتا ہے۔ یوں آپ کو فون سے معلوم ہو جائے گا کہ gateway down ہے، نہ کہ ایسے scheduled job سے جو کبھی چلا ہی نہیں۔
پہلی بار چلانا: سائن اِن کریں اور 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 2hDashboard URL http://localhost:5476/?token=<the token> ہے۔ Tokens کی میعاد ختم ہو جاتی ہے۔ Mint کرنے کے بعد printed link کو پانچ منٹ کے اندر کھولنا ضروری ہے۔ یہ command دو گھنٹے کی access cookie طلب کرتی ہے، جبکہ دستاویزی زیادہ سے زیادہ مدت بیس گھنٹے ہے۔ Browser کو 30 دن کی sliding idle window والی refresh cookie بھی ملتی ہے، اس لیے فعال session کسی نئے link کے بغیر renew ہو جاتا ہے۔ اگر dashboard خالی کھلے یا آپ کو فوراً واپس باہر بھیج دے تو عموماً token کی میعاد ختم ہو چکی ہوتی ہے۔ نیا token mint کریں اور اسے فوراً کھولیں۔ Token کو کبھی ticket یا chat message میں paste نہ کریں، کیونکہ جس کے پاس یہ ہو، اس کے پاس آپ کا agent بھی ہوتا ہے۔
SSH کے ذریعے dashboard تک پہنچیں، اور port 5476 کو کبھی public نہ کریں
پروجیکٹ کی مثال میں bind address دوبارہ دیکھیں: -p 127.0.0.1:5476:5476۔ container کے اندر gateway، 0.0.0.0 پر listen کرتا ہے، کیونکہ port mapping کے ذریعے اس تک پہنچنا ضروری ہے، لیکن mapping خود host پر صرف loopback کے لیے publish ہوتی ہے۔ 127.0.0.1: prefix حذف کرتے ہی gateway اس port کو scan کرنے والے ہر شخص کے لیے public internet پر دستیاب ہو جاتا ہے۔ ufw کا rule بھی آپ کو نہیں بچائے گا: Docker، DNAT rules لکھ کر ports publish کرتا ہے۔ یہ rules traffic کو ufw کے rules لاگو ہونے سے پہلے route کرتے ہیں، اس لیے ufw deny 5476، published port پر کوئی اثر نہیں کرتا۔ Docker کے default iptables backend میں Docker کا اپنا طریقہ یہ ہے کہ filtering rules اس کی DOCKER-USER chain میں رکھے جائیں۔ یہ طریقہ کام کرتا ہے، لیکن جب تک آپ conntrack extension کے ساتھ match نہ کریں، ان rules کو container کا داخلی address اور port نظر آتا ہے۔ اس لیے loopback bind زیادہ سادہ اور غلطی سے محفوظ control رہتا ہے۔ Docker کا nftables backend اس کے بجائے custom filtering کے لیے الگ nftables tables اور base chains استعمال کرتا ہے۔ Docker ports کا ufw کو bypass کرنا اس mechanism کی وضاحت کرتا ہے۔
اپنے 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اگر port 5476 آپ کے laptop پر پہلے ہی استعمال ہو رہا ہو تو صرف بائیں طرف کا number تبدیل کریں: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com، پھر http://localhost:45476/?token=... پر جائیں۔ کسی اضافی loopback-port setting یا container کو دوبارہ بنانے کی ضرورت نہیں ہے: loopback Origin درخواست کے اپنے Host سے match کرتا ہے، اس لیے CSRF check اسے قبول کر لیتا ہے۔ دوسرے agent کے اسی box پر کام شروع کرتے ہی آپ ایسے forwards تہہ در تہہ استعمال کریں گے، کیونکہ security scanning کے لیے open-kritt کو self-host کرنا اسی server پر port 5173 پر ایک اور loopback-only dashboard چلاتا ہے۔
دو documented behaviours طے کرتے ہیں کہ dashboard سے کون سی settings تبدیل کی جا سکتی ہیں۔ اول، gateway کسی بھی ایسی request کو remote سمجھتا ہے جس میں forwarding headers (Forwarded، X-Forwarded-* یا X-Real-IP) موجود ہوں، اور اس کے config-write اور secret-reveal endpoints ایسی requests مسترد کر دیتے ہیں۔ reverse proxy یہ headers شامل کرتا ہے؛ سادہ ssh -L forward کوئی header شامل نہیں کرتا، اس لیے یہ local نظر آتا ہے اور اس بنیاد پر مسترد نہیں ہوتا۔ دوم، container image میں channel-credential pages اور secret-revealing views ایسے ہر browser کے لیے read-only ہوتے ہیں جو direct-local نہ ہو، اور image میں کوئی text editor شامل نہیں ہے۔ اگر channel credential dashboard سے save نہ ہو تو یہ متوقع رویہ ہے، bug نہیں۔ config کو host پر 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 kirocrewphone سے access کے لیے project، Tailscale کے tailscale serve کی طرف اشارہ کرتا ہے۔ یہ dashboard کو public hostname کے بجائے آپ کے اپنے tailnet کے اندر رکھتا ہے۔ اسے public reverse proxy پر ترجیح دیں۔ token URL میں منتقل ہوتا ہے، اور اس راستے پر موجود ہر access log میں URL لکھا جاتا ہے۔ یہ اصول port کے بجائے اس کے پیچھے موجود سروس سے متعلق ہے: Halcyon، جو Jellyfin library کو browsable 90s video store میں دوبارہ بناتا ہے جیسی سروس دوسرے لوگ کھولنے کے لیے موجود ہوتی ہے اور reverse proxy کے لیے مناسب امیدوار ہے، جبکہ ایسا gateway جو آپ کے server پر commands چلا سکتا ہو، مناسب نہیں ہے۔
ایجنٹ کو ممکنہ حد تک محدود blast radius دیں
container پہلی بار start ہونے پر sandbox support کی جانچ کرتا ہے، اور نتیجہ طے کرتا ہے کہ agents کچھ execute کر سکتے ہیں یا نہیں۔ اگر namespace isolation دستیاب ہو تو agent subprocesses isolated ماحول میں run ہوتے ہیں۔ اگر یہ دستیاب نہ ہو اور KIROCREW_ALLOW_UNSANDBOXED=1 set نہ ہو تو execution کو unconfined run کرنے کے بجائے refuse کر دیا جاتا ہے۔ اس لیے اگر gateway بظاہر healthy ہو لیکن ہر task stall ہو جائے تو عموماً وجہ یہی ہوتی ہے۔ یہ فیصلہ پہلے run کے دوران docker logs kirocrew میں محفوظ ہوتا ہے۔ project ایک seccomp (secure computing mode) profile بھی فراہم کرتا ہے جسے آپ apply کر سکتے ہیں:
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جس host پر AppArmor enabled ہو، وہاں project کی Docker guide کے مطابق seccomp profile تبدیلی کا صرف نصف حصہ ہے، کیونکہ Docker اپنا docker-default AppArmor profile بھی attach کرتا ہے، اور profile کے ساتھ apparmor=unconfined استعمال کیا جاتا ہے۔ یہ option صرف AppArmor کے per-container rules کو ختم کرتا ہے؛ seccomp profile، dropped capabilities اور non-root user بدستور لاگو رہتے ہیں۔
اگر آپ KIROCREW_ALLOW_UNSANDBOXED=1 set کرتے ہیں تو واضح رہیں کہ کیا تبدیل ہوا ہے: اب agent اور آپ کے server کے درمیان واحد boundary container ہے۔ project کی warning مکمل طور پر دہرانا ضروری ہے۔ host کے وہ paths mount نہ کریں جو آپ agent کو براہ راست نہیں دیتے۔ عملی طور پر اس میں Docker socket، / کا کوئی bind mount، اور کسی دوسری service کا data رکھنے والی directory شامل ہیں۔
باقی اصول ہر اس agent پر لاگو ہوتا ہے جسے commands run کرنے کی اجازت ہو۔ اس کے credentials صرف اسی ایک repository یا bucket تک محدود رکھیں جس کی اسے ضرورت ہے؛ account-wide rights رکھنے والا personal token کبھی استعمال نہ کریں۔ اسے ایک dedicated user کے طور پر run کریں جس کے home میں کوئی اور چیز موجود نہ ہو۔ یہی مقصد VPS پر least privilege users کا ہے۔ جب agent code لکھ کر اسے run بھی کرتا ہو تو اسے ایسی machine دیں جسے خراب کرنے کی اجازت ہو: coding agents کے لیے disposable VM اس compose file کے کسی بھی flag سے زیادہ مضبوط boundary ہے، کیونکہ آپ اسے صاف کرنے کے بجائے delete کر دیتے ہیں۔ یہی اصول VPS پر OpenClaw کو محفوظ طریقے سے چلانے اور VPS پر Hermes agent کو self-host کرنے پر بھی لاگو ہوتا ہے۔ Tools بھی blast radius کا حصہ ہیں۔ agent کو web search دینے سے اس کے fetch کیے گئے ہر page کو untrusted input سمجھنا پڑتا ہے۔ اس لیے اسے اپنی SearXNG instance کی طرف point کرنا prompt injection سے متعلق فیصلہ بھی ہے، صرف plumbing کا معاملہ نہیں۔ Scheduled work آپ کے سونے کے دوران بھی رقم خرچ کرتا ہے، کیونکہ Kiro backends پر inference آپ کا Kiro plan استعمال کرتا ہے۔ اس لیے nightly job شامل کرنے سے پہلے VPS پر AI agent کی لاگت کو کنٹرول کرنا میں بیان کردہ limits set کریں۔
ہر upgrade سے پہلے state volume کا backup لیں
پہلے اصل volume name معلوم کریں۔ Compose named volumes کے نام کے شروع میں project name لگاتا ہے۔ یہ نام default طور پر directory name ہوتا ہے۔ اس لیے /opt/kirocrew/compose.yaml میں kirocrew-home کے طور پر declare کیا گیا volume kirocrew_kirocrew-home کے نام سے create ہوتا ہے:
docker volume lsکچھ بھی copy کرنے سے پہلے gateway کو stop کریں۔ memory.db اور memory_index.db SQLite databases ہیں۔ database کے write ہونے کے دوران اسے copy کرنے سے half-written transaction شامل ہو سکتی ہے، جسے restore کرنے پر file corrupt ہو جاتی ہے۔ Project کی اپنی migration instructions بھی یہی کہتی ہیں: memory صرف اس وقت منتقل کریں جب gateways stopped ہوں۔ یہ stop-first rule صرف KiroCrew کے لیے مخصوص نہیں ہے۔ اگر اسی box پر photo server بھی ہو تو PhotoPrism اور Immich کا موازنہ ان دونوں کے لیے درکار exact 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 kirocrewArchive کو box سے باہر copy کریں۔ Restore کے لیے container stopped ہو اور tar czf کی جگہ tar xzf موجود ہو تو یہی command استعمال کریں:
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 پر منتقل کرنا in-place restore سے مختلف کام ہے، اور project اس بارے میں واضح ہدایات دیتا ہے۔ workspace/memory/ کے اندر chat history اور project notes منتقل ہو جاتے ہیں۔ دونوں database files اور config.json بھی منتقل ہوتے ہیں۔ PID files، security event log اور .env پرانے host سے وابستہ ہیں، اس لیے انہیں منتقل نہ کریں اور نئے box پر secrets دوبارہ درج کریں۔
خراب upgrade کو کیسے واپس کریں
Upgrade مختصر ہے، اور یہ صرف اس لیے محفوظ ہے کہ آپ نے version pin کیا ہوا ہے۔ پہلے backup لیں، پھر 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 اگر image پہلے سے اس box پر موجود نہ ہو تو اسے pull کرتا ہے، اس لیے tag میں ترمیم ہی پورا upgrade ہے۔ Rollback بھی پرانے number کے ساتھ یہی sequence ہے، اور اس سے آپ کو بالکل وہی image ملتی ہے جو پہلے استعمال ہو رہی تھی، کیونکہ version tags immutable ہوتے ہیں۔
Binary صاف طور پر rollback ہو جاتی ہے۔ مسئلہ state میں ہو سکتا ہے۔ نیا gateway config.json کو دوبارہ لکھ سکتا ہے یا memory databases کو ایسی structure میں migrate کر سکتا ہے جسے پرانا gateway پڑھ نہ سکے، اور 12 October 2026 تک state کے لیے کوئی downgrade path documented نہیں ہے۔ Install guide ایک معاملے میں واضح ہے: legacy ~/.kirocrew home سے باہر منتقل کیا گیا data rollback نہیں ہو سکتا، اور ~/.kiro/crew سے پہلے کا release empty state کے ساتھ شروع ہوگا۔ اس لیے اگر پرانی image start ہونے کے بعد غیر معمولی برتاؤ کرے تو اسے debug نہ کریں۔ اسے stop کریں، upgrade سے پہلے لیا گیا backup restore کریں، اور دوبارہ start کریں۔ Backup پہلے لینے کی پوری وجہ یہی ہے، اور اسی لیے upgrade ابھی اور backup بعد میں لینے کی عادت اتنے نئے project پر ناکام ہوتی ہے۔
یہاں کیا ثابت نہیں ہوا
اس software کی عمر کے بارے میں حقیقت پسند رہیں۔ Version 0.1.3 5 August 2026 کو release ہوا تھا، اور 12 October 2026 تک stable line 0.8.0 تک پہنچ چکی تھی۔ زیادہ تر release notes اب بھی خودکار changelogs ہیں؛ 0.8.0 کے notes ہاتھ سے لکھے گئے ہیں، لیکن ان میں migration section شامل نہیں۔ عوامی release history تقریباً تین ماہ پر محیط ہے۔ اس guide میں کوئی بھی نتیجہ طویل مدت کے استعمال پر مبنی نہیں۔ اس لیے memory growth، database size اور scheduler reliability کو ایسی چیزیں سمجھیں جنہیں اپنے box پر خود measure کرنا ہے، نہ کہ ایسی چیزیں جن کے بارے میں پہلے سے مفروضہ قائم کیا جا سکے۔
دو رویے ایسے ہیں جن پر انحصار کرنے سے پہلے خود testing کر لینی چاہیے۔ اول، یہ جانچیں کہ کیا downgrade کسی newer version کے لکھے ہوئے state کو پڑھ سکتا ہے۔ یہ اس volume کی copy پر اس وقت آزمائیں جب ناکامی سے کوئی فرق نہ پڑے، outage کے دوران نہیں۔ دوم، یہ دیکھیں کہ جب scheduled job کا وقت آ جائے اور Kiro sign-in expire ہو چکا ہو تو gateway کیا کرتا ہے۔ یہ دونوں ایسے rough edges ہیں جنہیں کوئی نیا project releases کے درمیان خاموشی سے درست کر سکتا ہے، اور دونوں کی ابھی جانچ کرنا آسان ہے۔
FAQ
KiroCrew dashboard میرے سرور کے public IP پر کیوں نہیں کھلتا؟
کیونکہ شائع کردہ مثال port کو loopback سے bind کرتی ہے۔ -p 127.0.0.1:5476:5476 container کے port کو صرف host کے loopback address سے map کرتا ہے، اور یہ جان بوجھ کر ایسا کیا گیا ہے۔ port کو SSH کے ذریعے ssh -N -L 5476:127.0.0.1:5476 you@your-server سے forward کریں، پھر اپنے laptop پر http://localhost:5476/?token=<token> کھولیں۔ اسے قابل رسائی بنانے کے لیے 127.0.0.1: prefix ہٹانے سے gateway public internet پر آ جاتا ہے، اور ufw اسے محدود نہیں کرے گا، کیونکہ Docker کے published-port DNAT rules، ufw کے rules کے لاگو ہونے سے پہلے ہی traffic کو route کر دیتے ہیں۔ Published ports کو filter کرنے کے لیے Docker کی DOCKER-USER chain اس کے iptables backend کے ساتھ، یا nftables backend کے ساتھ الگ nftables base chains استعمال کریں؛ loopback bind برقرار رکھنا زیادہ سادہ ہے۔
KiroCrew اپنا data کہاں محفوظ کرتا ہے، اور مجھے کس چیز کا backup لینا چاہیے؟
تمام data ~/.kiro/crew کے تحت موجود ہوتا ہے، جو container image کے اندر /home/kirocrew/.kiro/crew ہے، اور KIROCREW_HOME اسے دوسری جگہ منتقل کرتا ہے۔ 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 میں تبدیلی آ سکتی ہے، اور tag خود یہ نہیں بتاتا کہ اس وقت کیا چل رہا ہے۔ 0.8.0 جیسے version tags immutable ہوتے ہیں، اور rollback اسی وجہ سے کام کرتا ہے: پرانا number واپس رکھیں اور بالکل وہی image حاصل کریں۔ 1 November 2026 تک newest stable release 0.11.1 ہے۔
میرا agent کوئی بھی command چلانے سے انکار کیوں کرتا ہے؟
Container پہلی مرتبہ start ہوتے وقت sandbox support کی جانچ کرتا ہے۔ اگر یہ agent subprocesses کو isolate نہ کر سکے اور KIROCREW_ALLOW_UNSANDBOXED=1 set نہ ہو، تو یہ subprocesses کو غیر محدود حالت میں چلانے کے بجائے execute کرنے سے انکار کر دیتا ہے۔ اس صورت میں gateway صحت مند دکھائی دیتا ہے، لیکن ہر task رک جاتا ہے۔ docker logs kirocrew پہلی run کے sandbox فیصلے کو دکھاتا ہے۔ یہ variable set کرنے سے agent اور host کے درمیان واحد boundary container رہ جاتا ہے، اس لیے اگر آپ اسے set کریں تو وہ چیز mount نہ کریں جو آپ agent کو براہ راست دینے کے لیے تیار نہ ہوں۔
کیا 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 approve کریں، یا automated استعمال کے لیے KIRO_API_KEY کو container environment کے ذریعے فراہم کریں۔ Authentication configure ہونے تک gateway start ہو جاتا ہے اور dashboard load ہو جاتا ہے، لیکن اس کے default harness کے پاس بات کرنے کے لیے کوئی model نہیں ہوتا۔ 0.10.0 کے بعد built-in KAS engine بھی موجود ہے، جس کے لیے kiro-cli installed ہونا ضروری نہیں؛ 0.11.0 نے ان نئی installations کے لیے KAS کو default بنا دیا ہے جن میں harness کا کوئی saved انتخاب موجود نہ ہو، جبکہ Kiro CLI کے explicit selections برقرار رہتے ہیں۔ KAS، kiro-cli login کے بجائے Crew کا اپنا sign-in استعمال کرتا ہے۔ Project کی custom backend guide، claude harness کو اجازت دیتی ہے کہ main model turns آپ کے منتخب کردہ Anthropic-compatible endpoint کو بھیجے، لیکن Kiro-specific features کے لیے kiro-cli sign-in پھر بھی درکار رہتا ہے۔