SSD Nodes Learn Hosting plans →

VPSలో KiroCrewను సెల్ఫ్ హోస్ట్ చేయడం ఎలా?

KiroCrewను VPSలో Docker కంటైనర్‌గా రన్ చేయడం ద్వారా మెమరీ మరియు షెడ్యూల్డ్ పనులు నిరంతరం ఆన్‌లో ఉండేలా చూడండి. systemd కాన్ఫిగరేషన్, SSH యాక్సెస్ మరియు బ్యాకప్ పద్ధతులను తెలుసుకోండి.

ల్యాప్‌టాప్‌కు బదులుగా VPSపై KiroCrewను self-host ఎందుకు చేయాలి

నిద్రించని మెషీన్‌పైనే KiroCrewను self-host చేయడం ఉపయోగకరంగా ఉంటుంది. అందువల్ల దానికి VPS సరైన స్థానం, ల్యాప్‌టాప్ కాదు. KiroCrew session history, semantic memory, scheduled jobs, approval queueలను diskపై ఉంచుతుంది. Process మళ్లీ ప్రారంభమైనప్పుడు ఇవన్నీ తిరిగి load చేస్తుంది. Scheduled job అమలు కావాల్సిన 03:00 సమయంలో process నడవకపోతే వీటిలో ఏదీ ఉపయోగపడదు. మూసివేసిన ల్యాప్‌టాప్‌లో process నడవదు.

KiroCrew అనేది Kiro team రూపొందించిన open source agent workspace. దీనికి Apache 2.0 license ఉంది. 0.1.0 ను 22 July 2026న విడుదల చేశారు. Gateway అని పిలిచే ఒక process stateను నిర్వహించి, port 5476పై web dashboard అందిస్తుంది. Dashboard, kirocrew CLI లేదా Slack వంటి chat channel ద్వారా ఆ gatewayను చేరుకోవచ్చు. మీరు self-host చేయాల్సింది gateway మాత్రమే. అందువల్ల ఈ guide దాన్ని నిరంతరం నడుస్తూ ఉంచడం, public internetకు అందుబాటులో లేకుండా చేయడం, చెడు upgrade తర్వాత మళ్లీ పాత స్థితికి తీసుకురావడం గురించి వివరిస్తుంది.

ప్రారంభించే ముందు రెండు విషయాలు తెలుసుకోవాలి. 0.11.0 నుంచి, saved harness choice లేని కొత్త KiroCrew installsలో kiro-cli అవసరం లేకుండానే KAS defaultగా ఉంటుంది. ఇప్పటికే స్పష్టంగా ఎంచుకున్న Kiro CLI ఎంపికలు అలాగే ఉంచబడతాయి. 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 ఆధారపడే ప్రాథమిక నియమాలను వివరిస్తుంది. Server భాగం కంటే agent భాగం మీకు కొత్తగా ఉంటే, agent loop, దాని tools, దాని memory వాస్తవంగా ఏమిటో తెలుసుకోవడం ముందుగా చదవండి. అప్పుడు కింది ఎంపికలు అర్థంలేని ఆదేశాలుగా కాకుండా నిర్ణయాలుగా కనిపిస్తాయి.

KiroCrew కు అవసరమైనవి, దాని స్థితి ఎక్కడ నిల్వ అవుతుంది

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 ద్వారా authentication చేయాలి లేదా automated use కోసం API key ఉపయోగించాలి. 0.10.0 నుంచి, kiro-cli install చేయకుండానే built-in KAS engine నడుస్తుంది. 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/: మొదటి run సమయంలో download అయ్యే embedding model.
  • security_events.jsonl: security event log.

ఆ directory నే install. దాన్ని కొత్త VPS కు copy చేస్తే మీ agent కూడా అక్కడికి తరలుతుంది. అందుకే దిగువ backup section, install section కంటే ముఖ్యమైనది.

RAM కంటే disk కోసం ముందుగా ప్రణాళిక చేయండి. Gateway ఒక Python process. అయితే machine పై వాస్తవ load agent నడిపే పని, build లేదా test suite వల్ల వస్తుంది. Chat history పెరిగే కొద్దీ state directory పరిమాణం పెరుగుతుంది. మొదటి start సమయంలో embedding model download అవుతుంది. కాబట్టి project ప్రారంభమైన మొదటి నెలల్లో ప్రచురించిన ఏ అంచనాన్నీ నమ్మకుండా, కొన్ని వారాల తర్వాత మీ స్వంత machine పై du -sh ~/.kiro/crew తో పరిమాణాన్ని కొలవండి. దీనికి భిన్నంగా, ప్రతి worker కు దాని స్వంత container మరియు browser ఇచ్చే runtime లో OpenBot యొక్క AI సహచరులను self-hosting చేయడం disk కంటే ముందుగా RAM ప్రశ్నగా మారుతుంది.

నాలుగు install మార్గాల్లో దేనిని ఉపయోగించాలి

ఈ project నాలుగు మార్గాలను అందిస్తుంది: desktop app, one-line wheel, source మరియు Docker. one-line installer ఒక wheel ను fetch చేసి kirocrew launcher ను సృష్టిస్తుంది. దాని directory మీ PATH లో లేకపోతే, దాన్ని 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 వద్ద publish చేయబడుతుంది. ప్రతి tag కింద linux/amd64 మరియు linux/arm64 కోసం ఇది అందుబాటులో ఉంటుంది. source build కు git clone మరియు make build అవసరం. కోడ్ మార్చేవారికి ఇది ఉపయోగకరం; application ను run చేసేవారికి కాదు.

container ను ఉపయోగించండి. Native source install చేస్తే, మీ ఇతర services నడుస్తున్న అదే host పై Python packages మరియు Node install అవుతాయి. Kiro CLI backend ను ఉపయోగించినప్పుడు kiro-cli కూడా అదే host పై install అవుతుంది. అందువల్ల upgrade విఫలమైతే, ఆ మార్పులను చేతితో సరిచేయాల్సి వస్తుంది. container runtime ను ఒకే image లో, state ను ఒకే volume లో ఉంచుతుంది. దీంతో rollback కోసం tag మార్చి service ను restart చేస్తే సరిపోతుంది.

release tag కు image ను pin చేయండి, 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 కూడా moving tagే; అది అదే release ను సూచిస్తుంది. ఇది ప్రస్తుతం ఉన్న newest stable release ను సూచిస్తుంది. అందువల్ల మీరు ఎంచుకోకుండానే తదుపరి pull సమయంలో నడుస్తున్న version మారవచ్చు. ఆ tag ఏ version ను సూచించిందో కూడా దానిలో నమోదు ఉండదు. Version tags immutable గా ఉంటాయి. కాబట్టి వాటిలో ఒకదాన్ని pin చేయండి. 1 November 2026 నాటికి newest 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 కూడా అలాగే సమాధానం ఇస్తాయి. అందువల్ల వీటిని probes గా ఉపయోగించవచ్చు. స్థితి starting గానే ఉంటే, ఏదైనా మార్చే ముందు docker logs kirocrew చదవండి. మొదటి run సమయంలో embedding model background లో download అవుతుంది. అది అందుబాటులోకి వచ్చే వరకు memory search keyword matching ను ఉపయోగిస్తుంది.

systemd తో సేవలను నిరంతరాయంగా ఉంచడం

restart: unless-stopped అనేది క్రాష్ అయినప్పుడు లేదా రీబూట్ తర్వాత Docker ఆటోమేటిక్‌గా ప్రారంభమైతే, కంటైనర్‌ను తిరిగి పునరుద్ధరిస్తుంది. ఒక unit file ఈ డిపెండెన్సీని స్పష్టంగా తెలియజేస్తుంది మరియు బ్యాకప్ చేయడానికి ముందు మొత్తం stack ను ఆపడానికి ఒకే కమాండ్‌ను అందిస్తుంది. 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.target
sudo systemctl daemon-reload
sudo systemctl enable --now kirocrew
systemctl status kirocrew

systemctl status kirocrew అనేది active (exited) అని చూపించాలి, ఇది ఈ unit కి ఆరోగ్యకరమైన ఫలితం. Type=oneshot తో పాటు RemainAfterExit=yes ఇక్కడ అవసరం, ఎందుకంటే కంటైనర్ ప్రారంభం కాగానే docker compose up -d కమాండ్ ముగుస్తుంది: systemd ఇక్కడ ఫోర్‌గ్రౌండ్ ప్రాసెస్‌ను కాకుండా, stack రన్ అవుతుందనే విషయాన్ని ట్రాక్ చేస్తుంది. దీనికి బదులుగా Type=simple అని రాస్తే, కమాండ్ వెంటనే ముగిసినట్లు systemd భావిస్తుంది, సేవను dead గా గుర్తిస్తుంది, ఆపై మీ Restart= సెట్టింగ్‌ను బట్టి ప్రయత్నాన్ని వదిలేస్తుంది లేదా restart-loop లో పడుతుంది. నేటివ్ ఇన్‌స్టాలేషన్ కోసం ప్రాజెక్ట్ సొంతంగా kirocrew service install ను అందిస్తుంది, ఇది /etc/systemd/system/kirocrew.service ను రాసి, గేట్‌వేను మీ యూజర్ ద్వారా రన్ చేస్తుంది. ఈ రెండు unit లను ఒకేసారి రన్ చేయవద్దు. ఈ అంశంపై మరింత సమాచారం VPS లో systemd services మరియు timers లో ఉంది. ఒక unit తిరిగి ప్రారంభం కాకపోతే, మీరు దానికి హెచ్చరికలను జోడించకపోతే అది మౌనంగా ఉంటుంది. కాబట్టి ఒక OnFailure= హ్యాండ్లర్‌ను జోడించండి, ఇది మీ సొంత ntfy సర్వర్‌కు అలర్ట్‌ను పంపుతుంది. దీనివల్ల గేట్‌వే డౌన్ అయినప్పుడు, రన్ అవ్వని షెడ్యూల్డ్ జాబ్ ద్వారా కాకుండా, మీ ఫోన్ ద్వారానే మీకు సమాచారం అందుతుంది.

మొదటిసారి: sign in చేసి dashboard token పొందండి

Container gateway ను ప్రారంభిస్తుంది. అయితే pinned 0.8.0 image లోని default Kiro CLI runtime కు ఇంకా authentication అవసరం. Container లో sign in చేయండి. లేదా automated use కోసం container environment ద్వారా KIRO_API_KEY పంపండి:

docker exec -it kirocrew kiro-cli login

ఇది device code మరియు URL ను చూపిస్తుంది. ఆ URL ను మీ స్వంత browser లో open చేయాలి. తరువాత dashboard token ను సృష్టించండి:

docker exec kirocrew kirocrew token --ttl 2h

Dashboard URL http://localhost:5476/?token=<the token>. Tokens కు expiry ఉంటుంది. చూపించిన link ను mint చేసిన ఐదు నిమిషాల్లో open చేయాలి. ఈ command రెండు గంటల access cookie ను request చేస్తుంది. Document చేసిన గరిష్ఠ వ్యవధి ఇరవై గంటలు. Browser కు 30-day sliding idle window కలిగిన refresh cookie కూడా అందుతుంది. అందువల్ల active session మరో link లేకుండానే renew అవుతుంది. Dashboard ఖాళీగా load అవుతున్నా లేదా వెంటనే మిమ్మల్ని బయటకు పంపుతున్నా, సాధారణంగా token expired అయి ఉంటుంది. కొత్త token ను mint చేసి వెంటనే open చేయండి. Token ను ticket లేదా chat message లో ఎప్పుడూ paste చేయవద్దు. దాన్ని కలిగి ఉన్న వ్యక్తికి మీ agent పై నియంత్రణ ఉంటుంది.

SSH ద్వారా dashboardను తెరవండి; port 5476ను ఎప్పుడూ public చేయవద్దు

Project exampleలోని 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ను తొలగిస్తే, ఆ portను scan చేసే ఎవరికైనా gateway public internetలో అందుబాటులోకి వస్తుంది. ufw rule కూడా మిమ్మల్ని రక్షించదు. Docker DNAT rules రాయడం ద్వారా portsను publish చేస్తుంది. ఈ 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ను దాటే Docker ports ఈ విధానం గురించి వివరిస్తుంది.

మీ laptop నుంచి SSH ద్వారా portను forward చేయండి:

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

ఈ commandను runningగా ఉంచి, స్థానికంగా http://localhost:5476/?token=<the token>ను open చేయండి. ప్రతి 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 recreation అవసరం లేదు. Loopback Origin request యొక్క స్వంత Hostతో match అవుతుంది, కాబట్టి CSRF check దాన్ని అంగీకరిస్తుంది. రెండో agent అదే boxను share చేసిన వెంటనే మీరు ఇలాంటి forwardsను వరుసగా ఉపయోగిస్తారు. ఎందుకంటే security scanning కోసం open-krittను self-host చేయడం అదే serverలో port 5173పై మరో loopback-only dashboardను ఉంచుతుంది.

Dashboard నుంచి ఏ settingsను మార్చవచ్చో రెండు documented behaviours నిర్ణయిస్తాయి. మొదట, forwarding headers ఉన్న ఏ requestనైనా gateway remote requestగా పరిగణిస్తుంది (Forwarded, X-Forwarded-* లేదా X-Real-IP). దాని config-write మరియు secret-reveal endpoints అలాంటి requestsను నిరాకరిస్తాయి. Reverse proxy ఈ headersను జోడిస్తుంది. సాధారణ ssh -L forward ఏ headersనూ జోడించదు. అందువల్ల అది local requestగా కనిపిస్తుంది, ఈ కారణంతో నిరాకరించబడదు. రెండవది, container imageలో channel-credential pages మరియు secret-revealing views direct-local కాని ఏ browserకైనా read-onlyగా ఉంటాయి. Imageలో text editor కూడా ఉండదు. Dashboard నుంచి channel credential 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 kirocrew

Phone access కోసం project Tailscale యొక్క tailscale serveను సూచిస్తుంది. ఇది dashboardను public hostnameపై కాకుండా మీ స్వంత tailnetలోనే ఉంచుతుంది. Public reverse proxyకి బదులుగా దీన్నే ఉపయోగించండి. Token URLలో ప్రయాణిస్తుంది. ఆ URL దాని మార్గంలోని ప్రతి access logలో రాయబడుతుంది. ఈ నియమం port గురించి కాకుండా, ఆ port వెనుక ఉన్న సేవ గురించి. ఉదాహరణకు Jellyfin libraryను browse చేయగల 90s video storeగా తిరిగి నిర్మించే Halcyonను ఇతరులు open చేయడానికి ఉద్దేశించవచ్చు. కాబట్టి అది reverse proxyకి సరైన అభ్యర్థి. కానీ మీ serverపై commands run చేయగల gatewayకు reverse proxy ఉపయోగించకండి.

ఏజెంట్‌కు సాధ్యమైనంత చిన్న ప్రభావ పరిధిని ఇవ్వండి

కంటైనర్ మొదటి ప్రారంభంలో sandbox మద్దతు ఉందో లేదో పరీక్షిస్తుంది. ఆ ఫలితం ఏజెంట్లు ఏదైనా అమలు చేయగలరా లేదా అనేది నిర్ణయిస్తుంది. namespace isolation అందుబాటులో ఉంటే, ఏజెంట్ 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 యొక్క per-container rules ను మాత్రమే ఎత్తివేస్తుంది. seccomp profile, తొలగించిన capabilities మరియు non-root user మాత్రం కొనసాగుతాయి.

మీరు KIROCREW_ALLOW_UNSANDBOXED=1 సెట్ చేస్తే, ఏమి మారిందో స్పష్టంగా గుర్తించండి: ఇప్పుడు agent మరియు మీ server మధ్య ఉన్న ఏకైక boundary కంటైనర్ మాత్రమే. ప్రాజెక్ట్ ఇచ్చిన హెచ్చరికను పూర్తిగా పునరుద్ఘాటించాలి. మీరు agent‌కు నేరుగా ఇవ్వడానికి సిద్ధంగా లేని host paths ను mount చేయవద్దు. ఆచరణలో దీని వల్ల Docker socket, / యొక్క ఏదైనా bind mount, అలాగే మరొక service data ను కలిగి ఉన్న ఏ directory అయినా ఉపయోగించకూడదు.

మిగిలినది commands అమలు చేయడానికి అనుమతించిన ప్రతి agent‌కు వర్తించే ప్రాథమిక భద్రతా నిర్మాణం. దాని credentials ను అవసరమైన ఒక repository లేదా ఒక bucket కు మాత్రమే పరిమితం చేయండి. account-wide హక్కులు ఉన్న personal token ను ఎప్పుడూ ఉపయోగించవద్దు. ప్రత్యేక user గా దాన్ని నడపండి. ఆ user యొక్క home లో మరే ఇతర data ఉండకూడదు. VPSలో least privilege users ఉద్దేశం ఇదే. Agent code రాసి, ఆ code ను అమలు చేసినప్పుడు, దెబ్బతీయడానికి అనుమతించబడిన machine ను దానికి ఇవ్వండి: coding agents కోసం disposable VM ఈ compose file లోని ఏ flag కంటే బలమైన boundary. ఎందుకంటే దాన్ని శుభ్రం చేయడానికి బదులుగా తొలగించవచ్చు. ఇదే ఆలోచన VPSపై OpenClawను సురక్షితంగా నడపడం మరియు VPSపై Hermes agentను self-hosting చేయడం ను కూడా నిర్దేశిస్తుంది. Tools కూడా blast radius లో భాగమే. Agent‌కు web search ఇస్తే, అది fetch చేసే ప్రతి page untrusted input అవుతుంది. అందువల్ల మీ స్వంత SearXNG instance‌కు దాన్ని అనుసంధానించడం అనేది plumbing నిర్ణయం మాత్రమే కాదు; prompt injection కు సంబంధించిన నిర్ణయం కూడా. Scheduled work మీరు నిద్రిస్తున్నప్పుడు కూడా డబ్బు ఖర్చు చేస్తుంది. Kiro backends పై inference మీ Kiro plan ను ఉపయోగిస్తుంది. కాబట్టి nightly job జోడించే ముందు VPSపై AI agent ఖర్చును నియంత్రించడం లో వివరించిన limits ను సెట్ చేయండి.

ప్రతి అప్‌గ్రేడ్‌కు ముందు స్టేట్ వాల్యూమ్‌ను బ్యాకప్ చేయండి

ముందుగా అసలైన వాల్యూమ్ పేరును కనుగొనండి. 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 పాత హోస్ట్‌కు సంబంధించినవి, కాబట్టి వాటిని వదిలేసి, కొత్త బాక్స్‌లో సీక్రెట్స్‌ను మళ్లీ ఎంటర్ చేయండి.

విఫలమైన అప్‌గ్రేడ్‌ను వెనక్కి (roll back) ఎలా తీసుకోవాలి

అప్‌గ్రేడ్ చేయడం చాలా తక్కువ సమయం తీసుకుంటుంది, మీరు ఒక వెర్షన్‌ను పిన్ (pin) చేశారు కాబట్టి ఇది సురక్షితం. ముందుగా బ్యాకప్ తీసుకోండి, ఆపై ట్యాగ్‌ను మార్చండి:

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 October 2026 నాటికి, స్టేట్ కోసం ఎటువంటి డౌన్‌గ్రేడ్ మార్గం డాక్యుమెంట్ చేయబడలేదు. ఇన్‌స్టాల్ గైడ్ ఒక సందర్భం గురించి స్పష్టంగా చెబుతోంది: పాత ~/.kirocrew హోమ్ నుండి తరలించిన డేటాకు రోల్‌బ్యాక్ ఉండదు, మరియు ~/.kiro/crew కంటే ముందున్న రిలీజ్ ఖాళీగా ప్రారంభమవుతుంది. కాబట్టి పాత ఇమేజ్ ప్రారంభమై వింతగా ప్రవర్తిస్తే, దానిని డీబగ్ చేయకండి. దానిని ఆపివేసి, అప్‌గ్రేడ్‌కు ముందు మీరు తీసుకున్న బ్యాకప్‌ను రీస్టోర్ చేసి, మళ్ళీ ప్రారంభించండి. బ్యాకప్ ముందుగా తీసుకోవడానికి కారణం ఇదే. అందుకే ముందుగా అప్‌గ్రేడ్ చేసి తర్వాత బ్యాకప్ తీసుకునే అలవాటు ఇంత కొత్త ప్రాజెక్ట్‌లలో విఫలమవుతుంది.

ఇక్కడ ఏది నిరూపితం కాలేదు

ఈ software ఎంత కొత్తదో వాస్తవంగా పరిగణించండి. 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 లేదు. Public release history సుమారు మూడు నెలలదే. ఈ guide లోని ఏ విషయం కూడా దీర్ఘకాలిక ఫలితంపై ఆధారపడలేదు. అందువల్ల memory growth, database size, scheduler reliability వంటి అంశాలను ఊహించకుండా మీ స్వంత serverలో కొలవండి.

మీరు వాటిపై ఆధారపడే ముందు రెండు ప్రవర్తనలను స్వయంగా పరీక్షించడం మంచిది. మొదటిది, కొత్త version రాసిన state ను downgrade చదవగలదా అనేది. సమస్య వచ్చిన సమయంలో కాకుండా, అవసరం లేని సమయంలో volume యొక్క copyపై దీన్ని పరీక్షించండి. రెండవది, scheduled job అమలు కావాల్సిన సమయంలో Kiro sign-in గడువు ముగిస్తే gateway ఎలా ప్రవర్తిస్తుందో చూడండి. ఇవి కొత్త projectలలో releases మధ్య నిశ్శబ్దంగా సరిచేయబడే పరిమితుల వంటివి. ఇప్పుడు వీటిని తనిఖీ చేయడం సులభం మరియు తక్కువ ఖర్చుతో కూడుకున్నది.

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 forwarding చేసి, మీ laptopలో http://localhost:5476/?token=<token> తెరవండి. అందరికీ అందుబాటులో ఉండేలా చేయడానికి 127.0.0.1: prefix ను తొలగిస్తే gateway public internet పైకి బహిర్గతమవుతుంది. Docker యొక్క published-port DNAT rules, ufw rules అమలుకాకముందే traffic ను route చేస్తాయి కాబట్టి ufw దాన్ని నియంత్రించదు. Published ports ను filter చేయడానికి, iptables backend ఉన్న Docker యొక్క DOCKER-USER chain ను లేదా 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 ఉపయోగించండి. Release వచ్చిన ప్రతిసారీ stable మారుతుంది. అందువల్ల తదుపరి pull సమయంలో మీరు నడుపుతున్న version మారవచ్చు. అలాగే, ప్రస్తుతం ఏది నడుస్తుందో ఆ tag మాత్రమే తెలియజేయదు. 0.8.0 వంటి version tags immutable గా ఉంటాయి. Rollback పనిచేయడానికి ఇదే కారణం. పాత number ను మళ్లీ ఉంచితే అదే image లభిస్తుంది. 1 November 2026 నాటికి తాజా stable release 0.11.1.

నా agent ఏ command ను అమలు చేయడానికి ఎందుకు నిరాకరిస్తుంది?

Container మొదటిసారి start అయినప్పుడు sandbox support ను పరీక్షిస్తుంది. Agent subprocesses ను isolate చేయలేకపోతే, అలాగే KIROCREW_ALLOW_UNSANDBOXED=1 set అయి లేకపోతే, వాటిని unconfined గా నడపడం బదులుగా container వాటిని అమలు చేయడానికి నిరాకరిస్తుంది. అందువల్ల gateway ఆరోగ్యంగా కనిపించినా ప్రతి task నిలిచిపోతుంది. ఆ మొదటి run లో తీసుకున్న sandbox నిర్ణయాన్ని docker logs kirocrew చూపిస్తుంది. ఈ variable ను set చేస్తే agent మరియు host మధ్య ఏకైక boundary container అవుతుంది. అందువల్ల దాన్ని set చేసినప్పుడు, agent కు నేరుగా అప్పగించని ఏదీ mount చేయవద్దు.

KiroCrew ను self-host చేయడానికి Kiro account అవసరమా?

Kiro backends కోసం 1 November 2026 నాటికి అవసరం. KiroCrew Apache 2.0 కింద లభించే free software. అయితే ఆ backends పై inference కోసం మీ Kiro plan ఉపయోగించబడుతుంది. Pin చేసిన 0.8.0 container Kiro CLI ను ఉపయోగిస్తుంది. docker exec -it kirocrew kiro-cli login అమలు చేసి మీ browserలో device code ను approve చేయండి. లేదా automated use కోసం container environment ద్వారా KIRO_API_KEY ను pass చేయండి. Authentication configure చేసే వరకు gateway start అవుతుంది మరియు dashboard load అవుతుంది. కానీ దాని default harness కు మాట్లాడేందుకు model ఉండదు. 0.10.0 నుంచి kiro-cli install చేయాల్సిన అవసరం లేని built-in KAS engine కూడా ఉంది. 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 కు main model turns ను పంపగలదు. అయితే Kiro-specific features కోసం kiro-cli sign-in ఇంకా అవసరమే.

ఈ వ్యాసం ఉపయోగకరంగా ఉందా?