VPS-এ KiroCrew হোস্ট করার নিয়ম ও গাইড
আপনার VPS-এ KiroCrew-কে Docker কন্টেইনার হিসেবে সেটআপ করুন। সিস্টেম রিবুট হলেও মেমোরি ও শিডিউল সচল রাখতে systemd সার্ভিস এবং ব্যাকআপ কনফিগারেশনের বিস্তারিত ধাপগুলো এখানে দেখুন।
ল্যাপটপের পরিবর্তে VPS-এ KiroCrew self-host করার কারণ
KiroCrew self-hosting তখনই কার্যকর, যখন এটি এমন একটি মেশিনে চলে যা কখনও sleep mode-এ যায় না। তাই 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-এ release হয়েছে। Gateway নামে একটি process state পরিচালনা করে এবং port 5476-এ web dashboard সরবরাহ করে। Dashboard, kirocrew CLI অথবা Slack-এর মতো chat channel থেকে ওই gateway-এ সংযোগ করেন। আপনি শুধু gateway-টিই self-host করছেন। তাই এই guide-এ gateway চালু রাখা, public Internet থেকে দূরে রাখা এবং কোনো খারাপ upgrade-এর পরে আগের অবস্থায় ফিরিয়ে আনার পদ্ধতি দেখানো হবে।
শুরু করার আগে দুটি বিষয় জানা দরকার। 0.11.0-এর পর থেকে saved harness choice না থাকা নতুন KiroCrew install-গুলো kiro-cli ছাড়াই KAS default হিসেবে ব্যবহার করে। আগে থেকে নির্দিষ্ট করা Kiro CLI selection অপরিবর্তিত থাকে। Kiro backend-এ inference আপনার Kiro plan ব্যবহার করে। তাই 1 November 2026 অনুযায়ী এই default setup offline নয়। Project-টিও নতুন এবং দ্রুত পরিবর্তিত হচ্ছে। Stable release 0.1.3 থেকে 5 August 2026-এ শুরু হয়ে 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 করুন, যাতে rollback করা যায়। Server-এ আগে agent না চালিয়ে থাকলে VPS-এ coding agent চালানো এই guide-এর ভিত্তি তৈরি করা নিয়মগুলো ব্যাখ্যা করে। Server-এর তুলনায় agent অংশটি আপনার কাছে নতুন হলে, আগে agent loop, এর tools এবং এর memory আসলে কী তা শেখা নিচের সিদ্ধান্তগুলোকে অস্পষ্ট নির্দেশের বদলে যুক্তিসঙ্গত সিদ্ধান্ত হিসেবে বুঝতে সাহায্য করবে।
KiroCrew-এর কী প্রয়োজন এবং এর state কোথায় থাকে
Native install-এর জন্য Python 3.12 বা পরের সংস্করণ প্রয়োজন। Source থেকে dashboard build করলে Node.js 22.12.0 বা পরের সংস্করণও প্রয়োজন হয়। Projectটি Node 24 LTS ব্যবহারের পরামর্শ দেয়। Kiro CLI backend-এর জন্য kiro-cli প্রয়োজন। এটিকে kiro-cli login দিয়ে authenticate করতে হয়, অথবা automated use-এর জন্য একটি API key ব্যবহার করতে হয়। 0.10.0 থেকে built-in KAS engine kiro-cli install না থাকলেও চলে। 0.11.0 এটিকে নতুন install-এ default করেছে, যদি কোনো saved harness choice না থাকে। 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/: 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-ও বড় হয়। প্রথম start-এ embedding model download হয়। তাই project-এর প্রথম কয়েক মাসে প্রকাশিত কোনো figure-এর ওপর নির্ভর না করে কয়েক সপ্তাহ পর du -sh ~/.kiro/crew দিয়ে নিজের server-এ মাপ নিন। এর বিপরীতে এমন একটি runtime রয়েছে যেখানে প্রতিটি worker-এর জন্য আলাদা container এবং আলাদা browser থাকে। সেখানে OpenBot-এর AI coworker self-host করা disk-এর আগে RAM-এর প্রশ্ন হয়ে দাঁড়ায়।
চারটি install path-এর মধ্যে কোনটি ব্যবহার করবেন
প্রকল্পটি চারটি বিকল্প প্রকাশ করে: desktop app, one-line wheel, source এবং Docker। one-line installer একটি wheel fetch করে এবং একটি kirocrew launcher তৈরি করে। এর directory যদি আপনার PATH-এ না থাকে, তাহলে এটি PATH-এ directory-টি যোগ করার নির্দেশ দেখায়:
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 ghcr.io/kirodotdev/kirocrew-এ প্রকাশিত হয়, প্রতিটি tag-এর অধীনে linux/amd64 এবং linux/arm64-এর জন্য। source build হলো git clone এবং make build, এবং এটি code পরিবর্তনকারীদের জন্য; এটি চালানোর জন্য নয়।
container ব্যবহার করুন। Native source install করলে Python package এবং Node আপনার অন্যান্য service চালানো একই host-এ যুক্ত হয়। Kiro CLI backend ব্যবহার করলে এর সঙ্গে kiro-cli-ও যুক্ত হয়। ফলে upgrade ব্যর্থ হলে আপনাকে এগুলো হাতে মেরামত করতে হয়। Container runtime-কে একটি image-এ এবং state-কে একটি volume-এ রাখে। তাই rollback করতে শুধু tag পরিবর্তন করে restart করলেই হয়।
ইমেজটি 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 পরিবর্তন করতে পারে। কোন version ব্যবহৃত হয়েছিল, tag-টি সে সম্পর্কেও কোনো তথ্য সংরক্ষণ করে না। Version tag অপরিবর্তনীয়, তাই একটি নির্দিষ্ট version pin করুন। 1 November 2026 অনুযায়ী সর্বশেষ stable release হলো 0.11.1। এটি 31 October 2026-এ প্রকাশিত হয়েছে এবং 0.11.0-এর memory integrity ও KAS সংশোধনের জন্য একটি hot patch। নিচের 0.8.0 উদাহরণে Kiro CLI ব্যবহার করা হয়েছে। এছাড়াও insider এবং nightly tag রয়েছে। nightly, main থেকে তৈরি build অনুসরণ করে।
/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-ও একইভাবে উত্তর দেয়, তাই এগুলো probe হিসেবে ব্যবহার করা যায়। অবস্থা starting-এ থেকে গেলে কিছু পরিবর্তন করার আগে docker logs kirocrew পড়ুন। প্রথমবার চালানোর সময় embedding model পটভূমিতে download হয়। এটি আসা পর্যন্ত memory search-এ keyword matching ব্যবহার করা হয়।
systemd দিয়ে সার্ভিস চালু রাখা
restart: unless-stopped ক্র্যাশ বা রিবুটের পর কন্টেইনারকে পুনরায় চালু করে, যদি Docker নিজে বুট হওয়ার সময় চালু হয়। একটি unit file এই নির্ভরতাকে স্পষ্ট করে এবং ব্যাকআপের আগে পুরো স্ট্যাক বন্ধ করার জন্য একটি কমান্ড প্রদান করে। বুট হওয়ার সময় Docker Compose স্ট্যাক চালু করা-তে সাধারণ নিয়মটি আলোচনা করা হয়েছে। /etc/systemd/system/kirocrew.service-এ KiroCrew-এর পদ্ধতিটি দেওয়া হলো:
[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) দেখা উচিত, যা এই ইউনিটের জন্য সঠিক ফলাফল। Type=oneshot-এর সাথে RemainAfterExit=yes এখানে ব্যবহার করা হয়েছে কারণ docker compose up -d কন্টেইনার চালু হওয়ার সাথে সাথেই ফিরে আসে: systemd এখানে ট্র্যাক করছে যে স্ট্যাকটি চালু আছে কি না, কোনো foreground প্রসেস নয়। এর পরিবর্তে Type=simple লিখলে systemd দেখবে কমান্ডটি সাথে সাথে বন্ধ হয়ে গেছে, সার্ভিসটিকে মৃত হিসেবে চিহ্নিত করবে এবং আপনার Restart= সেটিংস অনুযায়ী হয় হাল ছেড়ে দেবে অথবা রিস্টার্ট লুপে পড়বে। নেটিভ ইন্সটলেশনের জন্য প্রজেক্টটি নিজস্ব সমতুল্য ফাইল kirocrew service install প্রদান করে, যা /etc/systemd/system/kirocrew.service লেখে এবং আপনার ইউজার হিসেবে গেটওয়েটি চালায়। উভয় ইউনিট একসাথে চালাবেন না। এই বিষয়ের বিস্তারিত আলোচনা VPS-এ systemd সার্ভিস এবং টাইমার-এ রয়েছে। কোনো ইউনিট পুনরায় চালু হতে ব্যর্থ হলে তা নীরব থাকে যদি না আপনি সেটিকে সক্রিয় করেন, তাই একটি OnFailure= হ্যান্ডলার যোগ করুন যা আপনার নিজস্ব ntfy সার্ভারে অ্যালার্ট পাঠাবে। এতে কোনো শিডিউলড জব কাজ না করার পরিবর্তে গেটওয়ে ডাউন হওয়ার খবর আপনি সরাসরি আপনার ফোনে পাবেন।
প্রথম রান: sign in করুন এবং dashboard token সংগ্রহ করুন
Container gateway চালু করে, কিন্তু pinned 0.8.0 image-এ থাকা default Kiro CLI runtime-এর জন্য এখনও authentication প্রয়োজন। Container-এর ভেতরে sign in করুন, অথবা automated ব্যবহারের জন্য container environment-এর মাধ্যমে KIRO_API_KEY পাস করুন:
docker exec -it kirocrew kiro-cli loginএটি একটি device code এবং একটি URL দেখায়। নিজের browser-এ URL-টি খুলুন। এরপর dashboard token তৈরি করুন:
docker exec kirocrew kirocrew token --ttl 2hDashboard URL হলো http://localhost:5476/?token=<the token>। Token-এর মেয়াদ শেষ হয়: তৈরি করার পাঁচ মিনিটের মধ্যে দেখানো link-টি খুলতে হবে। এই command দুই ঘণ্টার access cookie চায়; নথিভুক্ত সর্বোচ্চ সময় হলো বিশ ঘণ্টা। Browser একটি refresh cookie-ও পায়, যার sliding idle window 30 দিন। তাই সক্রিয় session অন্য link ছাড়াই নবায়ন হয়। Dashboard ফাঁকা খুললে বা আপনাকে সরাসরি sign-in পৃষ্ঠায় ফিরিয়ে দিলে সাধারণত token-এর মেয়াদ শেষ হয়ে গেছে। নতুন token তৈরি করে সঙ্গে সঙ্গে link-টি খুলুন। Token কখনও ticket বা chat message-এ paste করবেন না। যার কাছে এটি থাকবে, সে আপনার agent নিয়ন্ত্রণ করতে পারবে।
SSH ব্যবহার করে dashboard-এ পৌঁছান এবং কখনো port 5476 প্রকাশ করবেন না
প্রজেক্টের উদাহরণে bind address আবার দেখুন: -p 127.0.0.1:5476:5476। Container-এর ভিতরে gateway 0.0.0.0-এ listen করে, কারণ port mapping-এর মাধ্যমে এটিকে পৌঁছানো সম্ভব হতে হবে। তবে mapping-টি host-এর loopback-এ কেবল প্রকাশিত হয়। 127.0.0.1: prefix মুছে দিলে port scan করা যে কেউ public internet থেকে gateway-এ পৌঁছাতে পারবে। ufw rule দিয়েও এটি আটকানো যাবে না। Docker DNAT rule লিখে port প্রকাশ করে এবং ufw-এর rule প্রয়োগ হওয়ার আগেই traffic route করে। তাই ufw deny 5476 প্রকাশিত port-এ কোনো প্রভাব ফেলে না। Docker-এর default iptables backend ব্যবহার করলে Docker-এর নিজস্ব সমাধান হলো তার DOCKER-USER chain-এ filtering rule যোগ করা। এটি কাজ করে। তবে conntrack extension দিয়ে match না করলে ওই rule-গুলো container-এর internal address ও port দেখতে পায়। তাই loopback bind-ই সহজ নিয়ন্ত্রণ এবং এতে ভুল হওয়ার সম্ভাবনাও কম। Docker-এর nftables backend custom filtering-এর জন্য আলাদা nftables table ও base chain ব্যবহার করে। ufw এড়িয়ে যাওয়া Docker port-এ এই প্রক্রিয়াটি ব্যাখ্যা করা হয়েছে।
আপনার laptop থেকে SSH-এর মাধ্যমে port forward করুন:
ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.comএটি চালু রাখুন এবং localভাবে 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=...-এ যান। অতিরিক্ত loopback-port setting বা container পুনরায় তৈরি করার প্রয়োজন নেই। loopback Origin request-এর নিজস্ব Host-এর সঙ্গে মিলে যায়, তাই CSRF check এটি গ্রহণ করে। দ্বিতীয় কোনো agent একই server ব্যবহার করলেই আপনি এভাবে একাধিক forward তৈরি করবেন। কারণ security scanning-এর জন্য open-kritt self-hosting একই server-এ port 5173-এ loopback-only আরেকটি dashboard চালায়।
দুটি নথিভুক্ত আচরণ নির্ধারণ করে যে dashboard থেকে কোন setting পরিবর্তন করা যাবে। প্রথমত, gateway যে কোনো forwarding header-সহ request-কে (Forwarded, X-Forwarded-* বা X-Real-IP) remote হিসেবে গণ্য করে। এর config-write এবং secret-reveal endpoint এই request প্রত্যাখ্যান করে। Reverse proxy এই header যোগ করে। সাধারণ ssh -L forward কোনো header যোগ করে না, তাই এই কারণে এটি local হিসেবে বিবেচিত হয় এবং প্রত্যাখ্যাত হয় না। দ্বিতীয়ত, container image-এ channel-credential page এবং secret-revealing view direct-local নয় এমন যেকোনো browser-এর জন্য read-only। Image-এ কোনো text editor-ও নেই। Dashboard থেকে কোনো 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 kirocrewPhone থেকে access-এর জন্য project Tailscale-এর tailscale serve ব্যবহারের পরামর্শ দেয়। এতে dashboard public hostname-এ না রেখে আপনার নিজস্ব tailnet-এর মধ্যে রাখা যায়। Public reverse proxy-এর বদলে এটি ব্যবহার করুন। Token URL-এর মধ্যে থাকে এবং সেই URL প্রতিটি সংশ্লিষ্ট access log-এ লেখা হয়। এই নিয়মটি port নিজে নয়, port-এর পেছনে থাকা service নিয়ে। যেমন যা Jellyfin library-কে browser-এ দেখা যায় এমন 90s-এর video store হিসেবে পুনর্গঠন করে, সেই Halcyon অন্যদের জন্য খোলার উপযোগী এবং reverse proxy-এর ভালো প্রার্থী। কিন্তু যে gateway আপনার server-এ command চালাতে পারে, সেটি নয়।
এজেন্টের বিস্তারের পরিধি যতটা সম্ভব ছোট রাখুন
প্রথমবার চালু হওয়ার সময় container sandbox support পরীক্ষা করে। এই ফলের ভিত্তিতে agent কোনো কিছু execute করতে পারবে কি না তা নির্ধারিত হয়। namespace isolation উপলভ্য থাকলে agent-এর subprocess-গুলো isolated অবস্থায় চলে। এটি উপলভ্য না থাকলে এবং KIROCREW_ALLOW_UNSANDBOXED=1 সেট করা না থাকলে execution unconfined অবস্থায় চালানোর পরিবর্তে প্রত্যাখ্যান করা হয়। তাই gateway healthy দেখালেও প্রতিটি task আটকে গেলে সাধারণত এটাই কারণ। প্রথম run থেকে সিদ্ধান্তটি docker logs kirocrew-এ থাকে। Project-টি একটি 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.jsonAppArmor enabled থাকা host-এ project-এর Docker guide seccomp profile-কে পরিবর্তনের কেবল অর্ধেক হিসেবে উল্লেখ করে। কারণ Docker তার docker-default AppArmor profile-ও সংযুক্ত করে এবং profile-টির সঙ্গে apparmor=unconfined ব্যবহার করে। ওই option শুধু AppArmor-এর per-container rule তুলে দেয়। seccomp profile, dropped capability এবং non-root user তখনও প্রযোজ্য থাকে।
আপনি যদি KIROCREW_ALLOW_UNSANDBOXED=1 সেট করেন, তাহলে কী পরিবর্তন হয়েছে তা স্পষ্টভাবে বুঝুন: এখন agent এবং আপনার server-এর মধ্যে একমাত্র boundary হলো container। Project-এর সতর্কতাটি সম্পূর্ণভাবে পুনরাবৃত্তি করা দরকার। এমন host path mount করবেন না, যা আপনি সরাসরি agent-এর হাতে দিতেন না। বাস্তবে এর ফলে Docker socket, /-এর কোনো bind mount এবং অন্য কোনো service-এর data থাকা directory বাদ পড়ে।
বাকি নিয়মগুলো command চালানোর অনুমতি পাওয়া প্রতিটি agent-এর ক্ষেত্রে প্রযোজ্য। এর credential শুধু প্রয়োজনীয় একটি repository বা একটি bucket-এর মধ্যে সীমাবদ্ধ রাখুন। account-wide অধিকারসহ personal token কখনো ব্যবহার করবেন না। এমন dedicated user হিসেবে এটি চালান, যার home-এ অন্য কিছু নেই। VPS-এ least privilege user ব্যবহার করার উদ্দেশ্য এটাই। Agent code লিখে সেই code চালালে এমন machine দিন, যা ভেঙে ফেললেও সমস্যা নেই: coding agent-এর জন্য disposable VM এই compose file-এর যেকোনো flag-এর চেয়ে শক্তিশালী boundary, কারণ পরিষ্কার করার পরিবর্তে VM-টি delete করে দিতে পারবেন। একই যুক্তি VPS-এ OpenClaw নিরাপদে চালানো এবং VPS-এ Hermes agent self-host করা-এর ক্ষেত্রেও প্রযোজ্য। Tool-ও বিস্তারের পরিধির অংশ। Agent-কে web search দিলে এটি fetch করা প্রতিটি page untrusted input-এ পরিণত হয়। তাই নিজের SearXNG instance ব্যবহার করা plumbing-এর পাশাপাশি prompt injection সম্পর্কিত সিদ্ধান্তও। Scheduled work আপনি ঘুমানোর সময়ও অর্থ ব্যয় করে, কারণ Kiro backend-এ inference আপনার Kiro plan ব্যবহার করে। তাই nightly job যোগ করার আগে VPS-এ AI agent-এর খরচ নিয়ন্ত্রণ-এ বর্ণিত limit সেট করুন।
প্রতিটি আপগ্রেডের আগে স্টেট ভলিউমের ব্যাকআপ নিন
প্রথমে ভলিউমের আসল নাম খুঁজে বের করুন। Compose প্রজেক্টের নামের সাথে ভলিউমের নাম যুক্ত করে, যা ডিফল্টভাবে ডিরেক্টরির নাম হয়। তাই /opt/kirocrew/compose.yaml ফাইলে kirocrew-home হিসেবে ঘোষিত ভলিউমটি kirocrew_kirocrew-home নামে তৈরি হয়:
docker volume lsযেকোনো কিছু কপি করার আগে গেটওয়ে বন্ধ করুন। memory.db এবং memory_index.db হলো SQLite ডাটাবেস। ডাটাবেসে লেখার সময় সেটি কপি করলে অসম্পূর্ণ ট্রানজ্যাকশন কপি হতে পারে, যা রিস্টোর করার সময় ফাইলটিকে নষ্ট করে দিতে পারে। প্রজেক্টের নিজস্ব মাইগ্রেশন নির্দেশনায়ও একই কথা বলা হয়েছে: গেটওয়ে বন্ধ থাকা অবস্থায় শুধুমাত্র মেমোরি স্থানান্তর করুন। এই 'আগে বন্ধ করুন' নিয়মটি শুধুমাত্র 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 পুরনো হোস্টের সাথে সম্পর্কিত, তাই এগুলো বাদ দিন এবং নতুন বক্সে সিক্রেটগুলো পুনরায় ইনপুট দিন।
ত্রুটিপূর্ণ upgrade কীভাবে rollback করবেন
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। পুরোনো number ব্যবহার করে একই sequence অনুসরণ করলেই rollback হবে। এতে আগের ব্যবহৃত exact image-টি ফিরে পাবেন, কারণ version tag অপরিবর্তনীয়।
Binary পরিষ্কারভাবে rollback হয়। সমস্যা হতে পারে state নিয়ে। নতুন gateway config.json পুনর্লিখতে পারে অথবা memory database-গুলো এমন format-এ migrate করতে পারে যা পুরোনো gateway পড়তে পারে না। 12 October 2026 পর্যন্ত state downgrade করার কোনো documented path নেই। Install guide একটি ক্ষেত্রে স্পষ্ট: legacy ~/.kirocrew home থেকে সরানো data rollback করা যায় না, এবং ~/.kiro/crew-এর আগের কোনো release চালু হলে সেটি empty অবস্থায় শুরু হবে। তাই পুরোনো image চালু হওয়ার পর অস্বাভাবিক আচরণ করলে সেটি debug করবেন না। এটি থামান, upgrade-এর আগে নেওয়া backup restore করুন এবং আবার শুরু করুন। Backup আগে নেওয়ার সম্পূর্ণ কারণ এটাই। এই কারণেই এত নতুন কোনো project-এ আগে upgrade করে পরে backup নেওয়ার অভ্যাস ব্যর্থ হয়।
এখানে যা প্রমাণিত নয়
এই software-এর বয়স সম্পর্কে সৎ থাকুন। Version 0.1.3 5 August 2026-এ release হয়েছিল, এবং 12 October 2026-এর মধ্যে stable line 0.8.0-এ পৌঁছেছিল। বেশিরভাগ release note এখনও automated changelog; 0.8.0-এর note-গুলো হাতে লেখা হলেও এতে কোনো migration section নেই, এবং public release history-এর দৈর্ঘ্য প্রায় তিন মাস। এই guide-এর কোনো তথ্যই দীর্ঘমেয়াদি ফলাফল নয়। তাই memory growth, database size এবং scheduler reliability নিজের box-এ মাপার বিষয় হিসেবে বিবেচনা করুন, ধরে নেওয়ার বিষয় হিসেবে নয়।
নির্ভর করার আগে দুটি আচরণ নিজে পরীক্ষা করা উচিত। প্রথমত, নতুন version-এ লেখা state downgrade পড়তে পারে কি না। কোনো সমস্যা না থাকা অবস্থায় volume-এর একটি copy-তে এটি পরীক্ষা করুন, outage চলাকালে নয়। দ্বিতীয়ত, scheduled job চালানোর সময় Kiro sign-in-এর মেয়াদ শেষ হলে gateway কী করে। এগুলো এমন সীমাবদ্ধতা, যা একটি নতুন project release-এর মধ্যবর্তী সময়ে নীরবে ঠিক করতে পারে। এখনই দুটিই পরীক্ষা করা সহজ।
FAQ
KiroCrew dashboard আমার server-এর public IP-তে খুলছে না কেন?
কারণ প্রকাশিত উদাহরণটি port-টি loopback-এ bind করে। -p 127.0.0.1:5476:5476 container-এর port-কে শুধু host-এর loopback address-এ map করে, এবং এটি ইচ্ছাকৃত। ssh -N -L 5476:127.0.0.1:5476 you@your-server দিয়ে SSH-এর মাধ্যমে port forward করে এতে পৌঁছান, তারপর আপনার laptop-এ http://localhost:5476/?token=<token> খুলুন। এটিকে reachable করতে 127.0.0.1: prefix সরিয়ে দিলে gateway public internet-এ উন্মুক্ত হবে। Docker-এর published-port DNAT rule-গুলো ufw-এর rule প্রয়োগের আগেই traffic route করে, তাই ufw এটিকে নিয়ন্ত্রণ করতে পারবে না। Published port filter করতে Docker-এর iptables backend-এর DOCKER-USER chain ব্যবহার করুন, অথবা nftables backend-এর সঙ্গে আলাদা nftables base chain ব্যবহার করুন। Loopback bind রাখা সহজতর।
KiroCrew কোথায় data সংরক্ষণ করে এবং কী backup নেওয়া উচিত?
সবকিছু ~/.kiro/crew-এর অধীনে থাকে। Container image-এর ভেতরে এটি /home/kirocrew/.kiro/crew। KIROCREW_HOME এটি অন্য স্থানে সরিয়ে দেয়। Gateway বন্ধ রেখে পুরো directory অথবা পুরো Docker volume backup নিন। memory.db এবং memory_index.db হলো SQLite database। তাই gateway লেখার সময় নেওয়া copy অসঙ্গত হতে পারে। নতুন host-এ স্থানান্তরের সময় workspace/memory/, দুটি database file এবং config.json সঙ্গে নিয়ে যান। PID file, security event log এবং .env পুরনো host-এর সঙ্গে সম্পর্কিত।
stable tag ব্যবহার করব, নাকি version tag?
Version tag ব্যবহার করুন। প্রতিবার release বের হলে stable পরিবর্তিত হয়। তাই পরের pull-এ আপনার চলমান version বদলে যেতে পারে। Tag-টি নিজে থেকে কোন version চলছে তা জানায় না। 0.8.0-এর মতো version tag অপরিবর্তনীয়। এ কারণেই rollback কাজ করে। পুরনো number ফিরিয়ে দিলে একই image পাওয়া যায়। 1 November 2026 অনুযায়ী সর্বশেষ stable release হলো 0.11.1।
আমার agent কোনো command চালাতে অস্বীকার করছে কেন?
Container প্রথমবার start হওয়ার সময় sandbox support পরীক্ষা করে। এটি agent subprocess-গুলোকে isolate করতে না পারলে এবং KIROCREW_ALLOW_UNSANDBOXED=1 set না থাকলে সেগুলো unconfined অবস্থায় চালানোর পরিবর্তে execution প্রত্যাখ্যান করে। ফলে gateway healthy দেখালেও প্রতিটি task আটকে থাকে। প্রথম run-এর sandbox সিদ্ধান্ত docker logs kirocrew দেখায়। এই variable set করলে agent ও host-এর মধ্যে একমাত্র boundary হয় container। তাই এটি set করলে agent-কে সরাসরি দিতে আপত্তি নেই—এমন জিনিস ছাড়া আর কিছু mount করবেন না।
KiroCrew self-host করতে কি Kiro account দরকার?
Kiro backend-এর জন্য, 1 November 2026 অনুযায়ী, হ্যাঁ। KiroCrew Apache 2.0-এর অধীনে free software। তবে ওই backend-গুলোতে inference আপনার Kiro plan ব্যবহার করে। Pinned 0.8.0 container Kiro CLI ব্যবহার করে। docker exec -it kirocrew kiro-cli login চালিয়ে browser-এ device code অনুমোদন করুন, অথবা automated use-এর জন্য container environment-এর মাধ্যমে KIRO_API_KEY দিন। Authentication configure না করা পর্যন্ত gateway start হবে এবং dashboard load হবে। তবে default harness-এর সঙ্গে কথা বলার জন্য কোনো model থাকবে না। 0.10.0 থেকে একটি built-in KAS engine-ও রয়েছে, যেটির জন্য kiro-cli installed থাকা দরকার নেই। কোনো saved harness choice না থাকলে 0.11.0 নতুন install-এ KAS-কে default করেছে, তবে explicit Kiro CLI selection অপরিবর্তিত রেখেছে। KAS, kiro-cli login-এর পরিবর্তে Crew-এর নিজস্ব sign-in ব্যবহার করে। প্রকল্পের custom backend guide অনুযায়ী একটি claude harness আপনার নির্বাচিত Anthropic-compatible endpoint-এ main model turn পাঠাতে পারে। তবে Kiro-specific feature-এর জন্য kiro-cli sign-in এখনও প্রয়োজন।