SSD Nodes Learn Hosting plans →

VPS-ல் KiroCrew-ஐ self-host செய்வது எப்படி?

VPS-ல் KiroCrew-ஐ Docker container ஆக நிறுவி, எப்போதும் இயங்க வைக்கும் முறையை அறியுங்கள். systemd மூலம் தானியங்கி மறுதொடக்கத்தை அமைத்தல் மற்றும் தரவு பாதுகாப்பு முறைகளை இதில் காணலாம்.

லேப்டாப்பிற்குப் பதிலாக VPS-ல் KiroCrew-ஐ ஏன் self-host செய்ய வேண்டும்

KiroCrew-ஐ எப்போதும் இயங்கிக்கொண்டிருக்கும் ஒரு கணினியில் self-host செய்வது மட்டுமே பலன் தரும், எனவே இதற்கு VPS பொருத்தமானது, லேப்டாப் அல்ல. KiroCrew தனது session history, semantic memory, scheduled jobs மற்றும் approval queue ஆகியவற்றை disk-ல் சேமித்து வைக்கிறது; process restart ஆகும்போது இவை அனைத்தையும் மீண்டும் ஏற்றிக்கொள்கிறது. ஒரு scheduled job-க்கான நேரம் 03:00 மணிக்கு வரும்போது process இயங்கவில்லை என்றால், இந்த வசதிகள் எதற்கும் பயன்படாது; மூடியிருக்கும் லேப்டாப்பில் process இயங்காது.

KiroCrew என்பது Kiro குழுவினரின் open source agent workspace ஆகும், இது Apache 2.0 உரிமம் பெற்றது, மேலும் 0.1.0 22 July 2026 அன்று வெளியிடப்பட்டது. gateway என்று அழைக்கப்படும் ஒரு process, நிலையை (state) நிர்வகித்து port 5476-ல் web dashboard-ஐ வழங்குகிறது. நீங்கள் இந்த gateway-ஐ dashboard மூலமாகவோ, kirocrew CLI மூலமாகவோ அல்லது Slack போன்ற chat channel மூலமாகவோ அணுகலாம். நீங்கள் self-host செய்வது இந்த gateway-ஐ மட்டுமே, எனவே இந்த வழிகாட்டி அதை எப்போதும் இயங்க வைப்பது, பொது இணையத்திலிருந்து பாதுகாப்பது மற்றும் தவறான upgrade-க்குப் பிறகு மீண்டும் பழைய நிலைக்குக் கொண்டு வருவது பற்றியது.

நீங்கள் தொடங்குவதற்கு முன் இரண்டு விஷயங்களை அறிந்து கொள்ள வேண்டும். 0.11.0-லிருந்து, சேமிக்கப்பட்ட harness தேர்வு இல்லாத புதிய KiroCrew நிறுவல்கள், kiro-cli தேவையின்றி இயல்பாகவே KAS-க்கு முன்னுரிமை அளிக்கும்; ஏற்கனவே உள்ள explicit Kiro CLI தேர்வுகள் அப்படியே இருக்கும். Kiro backends-ல் inference உங்கள் Kiro plan-ஐப் பயன்படுத்துகிறது, எனவே 1 November 2026 நிலவரப்படி, இந்த default அமைப்பு offline-ல் இயங்காது. இந்தத் திட்டம் புதியது மற்றும் வேகமாக வளர்ந்து வருகிறது: இதன் stable releases 5 August 2026-ல் 0.1.3-லிருந்து 25 October 2026-ல் 0.10.0-க்கு மாறியது, இடையில் 9 October அன்று 0.8.0 மற்றும் 16 October அன்று 0.9.0 வெளியானது, மேலும் 25 October அன்று 0.11.0 release candidate ஏற்கனவே pre-release-ஆக வெளிவந்தது. ஏதோ ஒரு கட்டத்தில் நீங்கள் roll back செய்ய வேண்டியிருக்கும் என்பதை உணர்ந்து, அதற்கு வசதியான முறையில் இதை நிறுவவும். நீங்கள் இதற்கு முன் server-ல் agent-ஐ இயக்கியதில்லை என்றால், VPS-ல் coding agent-ஐ இயக்குவது என்ற பகுதி இந்த வழிகாட்டிக்குத் தேவையான அடிப்படை விதிகளை விளக்குகிறது. உங்களுக்கு server-ஐ விட agent பக்கம் புதியது என்றால், முதலில் agent loop, அதன் கருவிகள் மற்றும் அதன் memory என்றால் என்ன என்பதைப் புரிந்துகொள்வது, கீழே உள்ள தேர்வுகளை வெறும் மந்திரங்களாகப் பார்க்காமல், தெளிவான முடிவுகளாகப் பார்க்க உதவும்.

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 அல்லது தானியங்கி பயன்பாட்டிற்கான API key மூலம் அங்கீகரிக்கப்பட வேண்டும்; 0.10.0-லிருந்து, உள்ளமைக்கப்பட்ட KAS engine ஆனது kiro-cli நிறுவப்படாமலேயே இயங்குகிறது, மேலும் 0.11.0-ன் மூலம், சேமிக்கப்பட்ட harness தேர்வு இல்லாத புதிய நிறுவல்களுக்கு இதுவே இயல்புநிலையாக மாற்றப்பட்டது. container install-க்கு host-ல் இவை எதுவும் தேவையில்லை. அதற்கு Docker மட்டுமே தேவை. இதனால்தான் container install-ஐப் பயன்படுத்துவது சிறந்தது.

இதன் நிலை (state) ~/.kiro/crew-ல் சேமிக்கப்படுகிறது, மேலும் KIROCREW_HOME environment variable மூலம் இதை வேறு இடத்திற்கு மாற்றலாம். அந்த directory-க்குள் இருப்பவை:

  • config.json: gateway அமைப்புகள் மற்றும் chat channel நற்சான்றிதழ்கள் (credentials).
  • .env: ரகசியங்கள் (secrets).
  • workspace/memory/: விருப்பத்தேர்வுகள், project குறிப்புகள் மற்றும் chat வரலாறு.
  • memory.db மற்றும் memory_index.db: semantic மற்றும் full-text indexes.
  • models/: embedding model, இது முதல்முறை இயக்கும்போது தரவிறக்கம் செய்யப்படும்.
  • security_events.jsonl: பாதுகாப்பு நிகழ்வுப் பதிவு (security event log).

அந்த directory-யே முழுமையான install ஆகும். அதை ஒரு புதிய VPS-க்கு நகலெடுப்பதன் மூலம் உங்கள் agent-ஐ நீங்கள் இடம்பெயர்த்தலாம், இதனால்தான் install பகுதியை விட கீழே உள்ள backup பகுதி முக்கியமானது.

RAM-ஐ விட disk-க்குத் திட்டமிடுங்கள். gateway என்பது ஒரு Python process; உண்மையில் கணினியின் சுமையை அதிகரிப்பது agent இயக்கும் காரியங்களே, அதாவது ஒரு build அல்லது test suite. chat வரலாறு அதிகரிக்க அதிகரிக்க state directory-யின் அளவும் வளரும், மேலும் embedding model முதல்முறை இயக்கும்போதுதான் தரவிறக்கம் செய்யப்படும். எனவே, project-ன் ஆரம்ப மாதங்களில் வெளியிடப்படும் எந்தவொரு புள்ளிவிவரத்தையும் நம்புவதை விட, சில வாரங்களுக்குப் பிறகு உங்கள் சொந்த கணினியில் du -sh ~/.kiro/crew மூலம் அளவிடுங்கள். ஒவ்வொரு worker-க்கும் தனித்தனி container மற்றும் browser-ஐ வழங்கும் runtime-உடன் இதை ஒப்பிட்டுப் பாருங்கள்; அத்தகைய சூழலில் OpenBot-ன் AI பணியாளர்களை self-hosting செய்தல் என்பது disk-ஐ விட RAM-ஐக் கணக்கிடும் ஒரு கேள்வியாகிறது.

நான்கு நிறுவல் வழிகளில் எதைப் பயன்படுத்த வேண்டும்

இந்தத் திட்டம் நான்கு வழிகளை வெளியிடுகிறது: 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.0

Container image ghcr.io/kirodotdev/kirocrew-ல் வெளியிடப்படுகிறது, இது ஒவ்வொரு tag-ன் கீழும் linux/amd64 மற்றும் linux/arm64-க்குக் கிடைக்கிறது. Source build என்பது git clone மற்றும் make build ஆகும், இது குறியீட்டை மாற்றும் நபர்களுக்கானது, அதை இயக்கும் நபர்களுக்கானது அல்ல.

Container-ஐப் பயன்படுத்தவும். ஒரு native source நிறுவல், உங்கள் பிற சேவைகளை இயக்கும் அதே host-ல் Python packages மற்றும் Node-ஐ நிறுவுகிறது, மேலும் Kiro CLI backend-ஐப் பயன்படுத்தும்போது kiro-cli-ஐயும் நிறுவுகிறது. எனவே, ஒரு upgrade தவறாக நடந்தால், அதை நீங்கள் கைமுறையாகச் சரிசெய்ய வேண்டியிருக்கும். Container, runtime-ஐ ஒரே image-லும், state-ஐ ஒரே volume-லும் வைத்திருக்கிறது. இதனால், rollback செய்வது என்பது ஒரு tag மாற்றமாகவும், restart செய்வதாகவும் மட்டுமே அமையும்.

Image-ஐ 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-ம் அதே release-ஐக் குறிக்கிறது. இது தற்போதைய புதிய stable release எதுவோ அதைக் குறிக்கும். எனவே, நீங்கள் தேர்வு செய்யாமலேயே அடுத்த pull-ல் நீங்கள் இயக்கும் version மாறக்கூடும், மேலும் அந்த tag எந்த version-ஐப் பயன்படுத்தினீர்கள் என்ற தகவலைப் பதிவு செய்யாது. Version tags மாற்ற முடியாதவை, எனவே ஏதேனும் ஒன்றை மட்டும் 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-ம் அவ்வாறே பதிலளிக்கும், இதுவே அவற்றை probes-ஆகப் பயன்படுத்த உதவுகிறது). நிலை starting என்றே இருந்தால், எதையும் மாற்றும் முன் docker logs kirocrew-ஐப் படிக்கவும். முதல்முறை இயக்கும்போது embedding model பின்னணியில் தரவிறக்கம் செய்யப்படும்; அது வரும் வரை memory search keyword matching-ஐப் பயன்படுத்தும்.

systemd மூலம் சேவையைத் தொடர்ந்து இயக்குதல்

restart: unless-stopped, Docker தொடக்கத்திலேயே இயங்கினால், செயலிழப்பு அல்லது reboot-க்கு பிறகு container-ஐ மீண்டும் கொண்டு வரும். ஒரு unit file அந்தச் சார்புநிலையை (dependency) தெளிவாக வரையறுக்கிறது; மேலும், backup எடுப்பதற்கு முன் முழு stack-ஐயும் நிறுத்த ஒரே கட்டளையைப் பயன்படுத்த வழிவகுக்கிறது. Docker Compose stack-ஐ boot-ல் தொடங்குதல் பொதுவான முறையை விளக்குகிறது. 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-க்கு சரியான முடிவாகும். RemainAfterExit=yes உடன் Type=oneshot இங்கே சரியாக உள்ளது, ஏனெனில் docker compose up -d container தொடங்கப்பட்டவுடன் திரும்பிவிடும்: systemd என்பது stack இயங்குகிறதா என்பதைக் கண்காணிக்கிறது, foreground process-ஐ அல்ல. அதற்குப் பதிலாக Type=simple என்று எழுதினால், systemd அந்த கட்டளை உடனடியாக முடிவடைவதைக் கண்டு, service-ஐ dead என்று குறிக்கும்; பின்னர் உங்கள் Restart= அமைப்பைப் பொறுத்து அது முயற்சியைக் கைவிடும் அல்லது restart-loop-ல் சிக்கிக்கொள்ளும். Native install-க்கு, இந்தத் திட்டம் அதன் சொந்த இணையான kirocrew service install-ஐ வழங்குகிறது, இது /etc/systemd/system/kirocrew.service-ஐ எழுதி, gateway-ஐ உங்கள் user-ஆக இயக்குகிறது. இரண்டு unit-களையும் ஒரே நேரத்தில் இயக்க வேண்டாம். இந்தத் தலைப்பின் விரிவான விளக்கம் VPS-ல் systemd services மற்றும் timers பகுதியில் உள்ளது. ஒரு unit மீண்டும் தொடங்கத் தவறினால், நீங்கள் அதைச் சொல்ல வைக்காத வரை அது அமைதியாகவே இருக்கும்; எனவே, ஒரு OnFailure= handler-ஐச் சேர்க்கவும். இது உங்கள் சொந்த ntfy server-க்கு எச்சரிக்கையை அனுப்பும், இதன் மூலம் gateway செயலிழந்த தகவலை, இயங்காத scheduled job-க்காகக் காத்திருக்காமல், உங்கள் தொலைபேசியிலேயே உடனுக்குடன் அறிந்துகொள்ளலாம்.

முதல் முறை இயக்குதல்: உள்நுழைந்து dashboard token பெறுதல்

Container gateway-ஐத் தொடங்குகிறது, ஆனால் pinned 0.8.0 image-ல் உள்ள இயல்பான Kiro CLI runtime-க்கு இன்னும் authentication தேவைப்படுகிறது. Container-க்குள் உள்நுழையவும், அல்லது தானியங்கி பயன்பாட்டிற்கு container environment வழியாக KIRO_API_KEY-ஐ அனுப்பவும்:

docker exec -it kirocrew kiro-cli login

இது ஒரு device code மற்றும் நீங்கள் உங்கள் browser-ல் திறக்க வேண்டிய URL-ஐக் காட்டும். பிறகு ஒரு dashboard token-ஐ உருவாக்கவும்:

docker exec kirocrew kirocrew token --ttl 2h

Dashboard URL என்பது http://localhost:5476/?token=<the token> ஆகும். Tokens காலாவதியாகும்: அச்சிடப்பட்ட இணைப்பை உருவாக்கிய ஐந்து நிமிடங்களுக்குள் திறக்க வேண்டும், மேலும் இந்த command இரண்டு மணிநேர access cookie-ஐக் கோருகிறது, ஆவணப்படுத்தப்பட்ட அதிகபட்ச அளவு இருபது மணிநேரம் ஆகும். Browser 30-நாள் sliding idle window கொண்ட refresh cookie-ஐயும் பெறுகிறது, எனவே ஒரு active session மீண்டும் ஒரு இணைப்பு தேவையில்லாமல் புதுப்பிக்கப்படும். Dashboard காலியாகத் தெரிந்தாலோ அல்லது உங்களை மீண்டும் வெளியேற்றினாலோ, அது பொதுவாக காலாவதியான token-ஆக இருக்கலாம், எனவே இன்னொன்றை உருவாக்கி உடனடியாகத் திறக்கவும். Token-ஐ ஒரு ticket-லோ அல்லது chat message-லோ ஒருபோதும் பகிர வேண்டாம், ஏனெனில் அதை வைத்திருப்பவர் உங்கள் 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 முகவரிக்கு மட்டுமே port-ஐ வெளியிடுகிறது. 127.0.0.1: முன்னொட்டை நீக்கினால், அந்த port-ஐ ஸ்கேன் செய்யும் எவரும் gateway-ஐ பொது இணையம் வழியாக அணுக முடியும். ஒரு ufw விதி உங்களைக் காப்பாற்றாது: Docker, ufw விதிகள் செயல்படுவதற்கு முன்பே traffic-ஐ வழிநடத்தும் DNAT விதிகளை எழுதுவதால், ufw deny 5476 ஒரு திறக்கப்பட்ட port-க்கு எந்தப் பாதுகாப்பையும் தராது. Docker-ன் இயல்புநிலை iptables backend-ல், Docker-ன் சொந்த தீர்வு அதன் DOCKER-USER chain-ல் filtering விதிகளைச் சேர்ப்பதாகும். அது வேலை செய்யும், ஆனால் conntrack extension மூலம் நீங்கள் பொருத்தவில்லை எனில், அந்த விதிகள் container-ன் உள் முகவரி மற்றும் port-ஐ மட்டுமே பார்க்கும். எனவே, loopback bind முறையே எளிமையானது மற்றும் தவறுகள் நடக்க வாய்ப்பு குறைவானது. Docker-ன் nftables backend இதற்குப் பதிலாக தனித்தனி nftables tables மற்றும் base chains-ஐப் பயன்படுத்துகிறது. Docker ports bypassing ufw அந்த வழிமுறையை விளக்குகிறது.

இதற்குப் பதிலாக உங்கள் laptop-லிருந்து SSH வழியாக port-ஐ forward செய்யவும்:

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

அதை இயங்கவிட்டு, உள்ளூரில் http://localhost:5476/?token=<the token>-ஐத் திறக்கவும். ஒவ்வொரு இணைப்பிலும் இந்த 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 அமைப்போ அல்லது container-ஐ மீண்டும் உருவாக்குவதோ தேவையில்லை: loopback Origin கோரிக்கையின் Host-உடன் பொருந்துவதால், CSRF சரிபார்ப்பு அதை ஏற்றுக்கொள்கிறது. இரண்டாவது agent அதே server-ஐப் பயன்படுத்தத் தொடங்கும்போது, நீங்கள் இதுபோன்று பல forward-களை அடுக்க வேண்டியிருக்கும். ஏனெனில் self-hosting open-kritt for security scanning அதே server-ல் port 5173-ல் மற்றொரு loopback-only dashboard-ஐ உருவாக்குகிறது.

dashboard-லிருந்து எந்த அமைப்புகளை மாற்றலாம் என்பதை இரண்டு ஆவணப்படுத்தப்பட்ட செயல்பாடுகள் தீர்மானிக்கின்றன. முதலாவதாக, gateway ஏதேனும் forwarding headers (Forwarded, X-Forwarded-* அல்லது X-Real-IP) கொண்ட கோரிக்கைகளை remote கோரிக்கைகளாகக் கருதுகிறது; அதன் config-write மற்றும் secret-reveal endpoints அத்தகைய கோரிக்கைகளை நிராகரிக்கின்றன. ஒரு reverse proxy இந்த headers-ஐச் சேர்க்கும்; ஒரு சாதாரண ssh -L forward எதையும் சேர்க்காது, எனவே அது local-ஆகக் கருதப்பட்டு நிராகரிக்கப்படாது. இரண்டாவதாக, container image-ல் உள்ள channel-credential பக்கங்கள் மற்றும் secret-revealing காட்சிகள், direct-local அல்லாத எந்த browser-க்கும் read-only நிலையில் இருக்கும், மேலும் அந்த image-ல் text editor எதுவும் இல்லை. dashboard-லிருந்து channel credential சேமிக்கப்படவில்லை என்றால், அது பிழை அல்ல, இதுவே காரணம். அதற்குப் பதிலாக host-ல் config-ஐத் திருத்தவும்:

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

தொலைபேசி அணுகலுக்கு, இந்தத் திட்டம் Tailscale-ன் tailscale serve-ஐப் பரிந்துரைக்கிறது. இது dashboard-ஐ பொது hostname-ல் வைக்காமல், உங்கள் சொந்த tailnet-க்குள் வைத்திருக்கும். பொது reverse proxy-ஐ விட இதை முன்னுரிமைப்படுத்தவும். token URL-ல் பயணிக்கிறது, மேலும் URL அதன் பாதையில் உள்ள ஒவ்வொரு access log-லும் எழுதப்படும். இந்த விதி port-ஐ விட, அந்த port-க்குப் பின்னால் என்ன இருக்கிறது என்பதைப் பற்றியது: Halcyon, which rebuilds a Jellyfin library as a browsable 90s video store போன்றவற்றை மற்றவர்கள் திறக்கலாம், அது reverse proxy-க்கு ஏற்றது. ஆனால், உங்கள் server-ல் கட்டளைகளை இயக்கக்கூடிய gateway-ஐ அவ்வாறு திறக்கக்கூடாது.

ஏஜெண்டிற்கு மிகச்சிறிய அளவிலான பாதிப்பு எல்லையை (blast radius) வழங்குதல்

கண்டெய்னர் முதன்முதலில் தொடங்கும்போது, sandbox ஆதரவு உள்ளதா எனச் சோதிக்கும். அதன் முடிவைப் பொறுத்தே ஏஜெண்டுகள் எதையும் இயக்க முடியுமா என்பது தீர்மானிக்கப்படும். namespace isolation வசதி இருந்தால், ஏஜெண்டின் subprocess-கள் தனிமைப்படுத்தப்பட்டு இயங்கும். இந்த வசதி இல்லாமலும், KIROCREW_ALLOW_UNSANDBOXED=1 அமைக்கப்படாமலும் இருந்தால், பாதுகாப்பற்ற முறையில் இயக்குவதற்குப் பதிலாக, கட்டளைகளை இயக்குவது மறுக்கப்படும். எனவே, ஒரு கேட்வே (gateway) பார்ப்பதற்குச் சரியாகத் தெரிந்தாலும், அனைத்துப் பணிகளும் தேங்கி நின்றால், அதற்கு இதுவே காரணமாக இருக்கும். அந்த முதல் இயக்கத்தின் முடிவு 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 இயக்கப்பட்ட ஹோஸ்டில், இந்தத் திட்டத்தின் Docker வழிகாட்டி, seccomp profile-ஐ மாற்றத்தின் ஒரு பகுதி மட்டுமே என்கிறது. ஏனெனில் Docker அதன் docker-default AppArmor profile-ஐயும் இணைக்கிறது, மேலும் அந்த profile-ஐ apparmor=unconfined உடன் ஜோடி சேர்க்கிறது. அந்த விருப்பம் AppArmor-ன் கண்டெய்னர் வாரியான விதிகளை மட்டுமே தளர்த்தும்; seccomp profile, நீக்கப்பட்ட capabilities மற்றும் non-root பயனர் கட்டுப்பாடுகள் தொடர்ந்து அமலில் இருக்கும்.

நீங்கள் KIROCREW_ALLOW_UNSANDBOXED=1-ஐ அமைத்தால், என்ன மாற்றம் நிகழ்கிறது என்பதைத் தெளிவாகப் புரிந்துகொள்ளுங்கள்: இப்போது ஏஜெண்டிற்கும் உங்கள் சர்வருக்கும் இடையிலான ஒரே பாதுகாப்பு எல்லை இந்த கண்டெய்னர் மட்டுமே. இந்தத் திட்டத்தின் எச்சரிக்கையை முழுமையாக மீண்டும் குறிப்பிடுவது அவசியம். ஏஜெண்டிற்கு நேரடியாக வழங்க விரும்பாத எந்தவொரு ஹோஸ்ட் பாதையையும் (host paths) mount செய்யாதீர்கள். நடைமுறையில், Docker socket, /-ன் எந்தவொரு bind mount மற்றும் பிற சேவைகளின் தரவுகளைக் கொண்ட எந்தவொரு கோப்பகத்தையும் (directory) இதில் சேர்க்கக்கூடாது.

மீதமுள்ளவை கட்டளைகளை இயக்க அனுமதிக்கப்பட்ட ஒவ்வொரு ஏஜெண்டிற்கும் பொருந்தும் கட்டமைப்பாகும். அதன் நற்சான்றிதழ்களை (credentials) அதற்குத் தேவையான ஒரு repository அல்லது ஒரு bucket-க்கு மட்டும் கட்டுப்படுத்துங்கள்; கணக்கு முழுமைக்கும் உரிமைகளைக் கொண்ட தனிப்பட்ட டோக்கன்களை ஒருபோதும் வழங்காதீர்கள். அதன் home கோப்பகத்தில் வேறெதுவும் இல்லாத ஒரு பிரத்யேக பயனராக அதை இயக்குங்கள், இதற்காகவே VPS-ல் குறைந்தபட்ச அதிகாரமுள்ள பயனர்கள் என்ற கட்டுரை உள்ளது. ஏஜெண்ட் குறியீட்டை எழுதி அதை இயக்கும்போது, அது சேதப்படுத்த அனுமதிக்கப்பட்ட ஒரு இயந்திரத்தை அதற்கு வழங்குங்கள்: கோடிங் ஏஜெண்டுகளுக்கான தற்காலிக VM என்பது இந்த compose கோப்பில் உள்ள எந்தவொரு flag-ஐ விடவும் வலுவான பாதுகாப்பு எல்லையாகும், ஏனெனில் நீங்கள் அதைச் சுத்தம் செய்வதற்குப் பதிலாக அழித்துவிடலாம். இதே தர்க்கம் VPS-ல் OpenClaw-ஐ பாதுகாப்பாக இயக்குதல் மற்றும் VPS-ல் Hermes ஏஜெண்டைத் தாமாகவே ஹோஸ்ட் செய்தல் ஆகியவற்றிற்கும் பொருந்தும். கருவிகளும் பாதிப்பு எல்லையின் ஒரு பகுதியே: ஏஜெண்டிற்கு இணையத் தேடல் வசதியை வழங்குவது, அது பெறும் ஒவ்வொரு பக்கத்தையும் நம்பகத்தன்மையற்ற உள்ளீடாக மாற்றுகிறது. எனவே, உங்கள் சொந்த SearXNG instance-ஐப் பயன்படுத்துவது என்பது ஒரு தொழில்நுட்ப முடிவாக மட்டுமல்லாமல், prompt injection-ஐத் தடுக்கும் முடிவாகவும் அமைகிறது. திட்டமிடப்பட்ட பணிகள் நீங்கள் தூங்கும்போது பணத்தைச் செலவிடக்கூடும், ஏனெனில் Kiro backends-ல் inference செய்யும்போது உங்கள் Kiro திட்டம் பயன்படுத்தப்படும். எனவே, இரவு நேரப் பணிகளைச் சேர்ப்பதற்கு முன் VPS-ல் AI ஏஜெண்டின் செலவைக் கட்டுப்படுத்துதல் என்பதில் விவரிக்கப்பட்டுள்ள வரம்புகளை அமைத்துக்கொள்ளுங்கள்.

ஒவ்வொரு மேம்படுத்தலுக்கு முன்பும் state volume-ஐ காப்புப்பிரதி (backup) எடுக்கவும்

முதலில் உண்மையான volume பெயரை கண்டறியவும். Compose, project பெயரை முன்னொட்டாகக் கொண்டு volumes-க்கு பெயரிடும்; இது இயல்பாக directory பெயராக இருக்கும். எனவே, /opt/kirocrew/compose.yaml-ல் kirocrew-home என அறிவிக்கப்பட்ட volume, kirocrew_kirocrew-home என உருவாக்கப்படும்:

docker volume ls

எதையும் நகலெடுக்கும் முன் gateway-ஐ நிறுத்தவும். memory.db மற்றும் memory_index.db ஆகியவை SQLite databases ஆகும். தரவுத்தளம் எழுதப்படும்போது அதை நகலெடுத்தால், முழுமையடையாத பரிவர்த்தனை (transaction) பதிவாகி, மீட்டெடுக்கும்போது கோப்பு சிதைந்துவிடக்கூடும். திட்டத்தின் சொந்த migration வழிமுறைகளும் இதையே கூறுகின்றன: gateways நிறுத்தப்பட்டிருக்கும்போது மட்டுமே நினைவகத்தை நகர்த்தவும். இந்த 'முதலில் நிறுத்து' என்ற விதி KiroCrew-க்கு மட்டும் உரியதல்ல. ஒருவேளை அதே server-ல் photo server இயங்கினால், PhotoPrism மற்றும் Immich ஒப்பீடு அந்த இரண்டிற்கும் தேவையான துல்லியமான backup கட்டளைகளை வழங்குகிறது.

sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data:ro -v "$PWD":/backup \
  alpine tar czf /backup/kirocrew-2026-08-06.tgz -C /data .
sudo systemctl start kirocrew

Archive-ஐ server-லிருந்து வெளியே நகலெடுக்கவும். மீட்டெடுப்பதற்கும் (restore) அதே கட்டளைதான், ஆனால் container நிறுத்தப்பட்டிருக்க வேண்டும் மற்றும் tar czf-க்கு பதிலாக tar xzf-ஐ பயன்படுத்த வேண்டும்:

sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data -v "$PWD":/backup \
  alpine tar xzf /backup/kirocrew-2026-08-06.tgz -C /data
sudo systemctl start kirocrew

புதிய host-க்கு மாறுவது என்பது, இருக்கும் இடத்தில் மீட்டெடுப்பதிலிருந்து மாறுபட்ட பணியாகும்; இது குறித்து திட்டம் தெளிவாகக் கூறுகிறது. workspace/memory/-ன் கீழ் உள்ள chat history மற்றும் project notes ஆகியவை அப்படியே இடம்பெயரும்; அதேபோல் இரண்டு database கோப்புகளும் config.json-ம் இடம்பெயரும். PID கோப்புகள், security event log மற்றும் .env ஆகியவை பழைய host-டன் தொடர்புடையவை. எனவே அவற்றை விட்டுவிட்டு, புதிய server-ல் secrets-ஐ மீண்டும் உள்ளிடவும்.

தவறான 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/health

docker compose up -d அந்த image ஏற்கனவே கணினியில் இல்லையென்றால் அதைத் தரவிறக்கம் செய்யும், எனவே tag-ஐத் திருத்துவதே முழுமையான upgrade ஆகும். பழைய எண்ணைப் பயன்படுத்தி அதே வரிசையில் செயல்பட்டால் rollback செய்யலாம்; version tags மாற்ற முடியாதவை என்பதால், இது உங்களுக்கு முன்பு இருந்த அதே image-ஐத் தரும்.

Binary எந்தச் சிக்கலும் இன்றி rollback ஆகும். ஆனால், state அவ்வாறு இருக்காது. புதிய gateway, config.json-ஐ மாற்றியமைக்கலாம் அல்லது memory databases-ஐ பழைய gateway-ஆல் படிக்க முடியாத வடிவத்திற்கு மாற்றலாம்; 12 October 2026 நிலவரப்படி, state-ஐ downgrade செய்வதற்கான வழிமுறை எதுவும் ஆவணப்படுத்தப்படவில்லை. Install guide ஒரு விஷயத்தைப் பற்றித் தெளிவாகக் கூறுகிறது: பழைய ~/.kirocrew home-லிருந்து நகர்த்தப்பட்ட தரவுகளுக்கு rollback கிடையாது, மேலும் ~/.kiro/crew-க்கு முந்தைய release காலியாகவே தொடங்கும். எனவே, பழைய image தொடங்கி விசித்திரமாகச் செயல்பட்டால், அதை debug செய்ய வேண்டாம். அதை நிறுத்திவிட்டு, upgrade செய்வதற்கு முன்பு எடுத்த backup-ஐ restore செய்துவிட்டு, மீண்டும் தொடங்கவும். இதற்காகவே backup முதலில் எடுக்கப்பட வேண்டும்; upgrade-ஐ உடனே செய்துவிட்டு backup-ஐப் பிறகு எடுக்கும் பழக்கம், இது போன்ற புதிய project-களில் தோல்வியடையும்.

இங்கு நிரூபிக்கப்படாதவை

இந்த மென்பொருளின் வயது குறித்து வெளிப்படையாக இருக்க வேண்டும். பதிப்பு 0.1.3, 5 ஆகஸ்ட் 2026 அன்று வெளியிடப்பட்டது. 12 அக்டோபர் 2026-க்குள், நிலையான பதிப்பு 0.8.0-ஐ எட்டியது. பெரும்பாலான வெளியீட்டுக் குறிப்புகள் இன்னும் தானியங்கி changelog-களாகவே உள்ளன; 0.8.0 குறிப்புகள் கையால் எழுதப்பட்டவை, ஆனால் அவற்றில் migration பகுதி இல்லை. பொது வெளியீட்டு வரலாறு சுமார் மூன்று மாதங்கள் மட்டுமே. இந்த வழிகாட்டியில் உள்ள எதுவும் நீண்டகால பயன்பாட்டின் முடிவுகள் அல்ல. எனவே, memory வளர்ச்சி, database அளவு மற்றும் scheduler நம்பகத்தன்மை ஆகியவற்றை நீங்களே உங்கள் கணினியில் அளவிட வேண்டும்; அவற்றை அப்படியே நம்பிவிடக்கூடாது.

நீங்கள் சார்ந்திருப்பதற்கு முன், இரண்டு செயல்பாடுகளை நீங்களே சோதிப்பது நல்லது. முதலாவதாக, புதிய பதிப்பால் எழுதப்பட்ட தரவை பழைய பதிப்பிற்குத் திரும்பும்போது (downgrade) அது வாசிக்கிறதா என்பதைச் சோதிக்கவும். இதைச் செய்யும்போது, பாதிப்பு ஏற்படாதவாறு volume-ன் நகலில் சோதிக்கவும்; சேவை முடங்கியிருக்கும்போது செய்ய வேண்டாம். இரண்டாவதாக, திட்டமிடப்பட்ட பணி (scheduled job) நடக்கும்போது Kiro sign-in காலாவதியானால் gateway என்ன செய்கிறது என்பதைச் சோதிக்கவும். இவை இரண்டும் புதிய திட்டங்களில் வெளியீடுகளுக்கு இடையே மெதுவாகச் சரிசெய்யப்படும் குறைபாடுகள். இவற்றை இப்போதே சரிபார்ப்பது எளிது.

FAQ

எனது server-ன் public IP-ல் KiroCrew dashboard ஏன் திறக்கவில்லை?

ஏனெனில், கொடுக்கப்பட்டுள்ள உதாரணம் port-ஐ loopback-ல் மட்டுமே இணைக்கிறது (bind). -p 127.0.0.1:5476:5476, container-ன் port-ஐ host-ன் loopback முகவரியுடன் மட்டுமே இணைக்கிறது; இது வேண்டுமென்றே செய்யப்பட்ட ஒன்று. SSH மூலம் ssh -N -L 5476:127.0.0.1:5476 you@your-server கட்டளையைப் பயன்படுத்தி port-ஐ forward செய்து, உங்கள் laptop-ல் http://localhost:5476/?token=<token> முகவரியைத் திறப்பதன் மூலம் இதை அணுகலாம். 127.0.0.1: முன்னொட்டை நீக்கி இதை public internet-ல் அணுகும்படி செய்தால், gateway பொதுவெளியில் வெளிப்படும். Docker-ன் published-port DNAT விதிகள் ufw விதிகளுக்கு முன்பே traffic-ஐக் கையாளுவதால், ufw மூலம் இதைத் தடுக்க முடியாது. Published ports-ஐ வடிகட்ட Docker-ன் DOCKER-USER chain-ஐ அதன் iptables backend-உடன் பயன்படுத்தவும், அல்லது nftables backend-உடன் தனித்தனி nftables base chains-ஐப் பயன்படுத்தவும்; loopback bind-ஐ வைத்திருப்பதே எளிமையானது.

KiroCrew தனது தரவை எங்கே சேமிக்கிறது, எதை backup எடுக்க வேண்டும்?

அனைத்து தரவுகளும் ~/.kiro/crew-க்கு அடியில் உள்ளன, இது container image-க்குள் /home/kirocrew/.kiro/crew என்று அழைக்கப்படுகிறது, மேலும் KIROCREW_HOME மூலம் இதை மாற்றியமைக்கலாம். Gateway-ஐ நிறுத்திவிட்டு, முழு directory-யையோ அல்லது முழு Docker volume-ஐயோ backup எடுக்கவும். memory.db மற்றும் memory_index.db ஆகியவை SQLite databases என்பதால், gateway இயங்கிக்கொண்டிருக்கும்போது எடுக்கப்படும் நகல் முரண்பாடாக (inconsistent) இருக்கலாம். புதிய host-க்கு மாறும்போது, workspace/memory/, இரண்டு database கோப்புகள் மற்றும் config.json ஆகியவற்றை எடுத்துச் செல்லலாம்; ஆனால் PID கோப்புகள், security event log மற்றும் .env ஆகியவை பழைய host-க்கு உரியவை.

நான் stable tag-ஐப் பயன்படுத்த வேண்டுமா அல்லது version tag-ஐப் பயன்படுத்த வேண்டுமா?

Version tag-ஐப் பயன்படுத்தவும். stable ஒவ்வொரு முறை மென்பொருள் வெளியாகும்போதும் மாறும், எனவே அடுத்த முறை pull செய்யும்போது நீங்கள் இயக்கும் version மாறக்கூடும்; மேலும் அந்த tag-ஐ வைத்து தற்போது என்ன இயங்குகிறது என்பதை அறிய முடியாது. 0.8.0 போன்ற version tags மாற்ற முடியாதவை (immutable), இதுவே rollback செய்வதற்கு உதவும்: பழைய எண்ணை மீண்டும் குறிப்பிடுவதன் மூலம் அதே image-ஐப் பெறலாம். 1 November 2026 நிலவரப்படி, புதிய stable release 0.11.1 ஆகும்.

எனது agent ஏன் எந்தக் கட்டளையையும் இயக்க மறுக்கிறது?

Container முதன்முதலில் தொடங்கும்போது sandbox ஆதரவு உள்ளதா என்று சோதிக்கும். Agent subprocess-களைத் தனிமைப்படுத்த முடியாமல், KIROCREW_ALLOW_UNSANDBOXED=1 அமைக்கப்படாமல் இருந்தால், அவற்றை unconfined நிலையில் இயக்குவதற்குப் பதிலாக, அவற்றை இயக்க மறுத்துவிடும். இதனால் gateway சரியாக இருப்பது போலத் தோன்றும், ஆனால் அனைத்து task-களும் தேங்கி நிற்கும். docker logs kirocrew அந்த முதல் இயக்கத்தின் sandbox முடிவைக் காட்டும். இந்த variable-ஐ அமைப்பது, agent-க்கும் host-க்கும் இடையே container-ஐ மட்டுமே எல்லையாக மாற்றும்; எனவே இதை அமைத்தால், agent-க்கு நேரடியாக வழங்க விரும்பாத எதையும் mount செய்யாதீர்கள்.

KiroCrew-ஐ self-host செய்ய Kiro account தேவையா?

Kiro backends-க்கு, 1 November 2026 நிலவரப்படி, ஆம். KiroCrew என்பது Apache 2.0 உரிமத்தின் கீழ் உள்ள இலவச மென்பொருள், ஆனால் அந்த backends-ல் inference செய்ய உங்கள் Kiro திட்டம் தேவை. இணைக்கப்பட்டுள்ள 0.8.0 container Kiro CLI-ஐப் பயன்படுத்துகிறது: docker exec -it kirocrew kiro-cli login-ஐ இயக்கி, உங்கள் browser-ல் device code-ஐ அங்கீகரிக்கவும், அல்லது தானியங்கி பயன்பாட்டிற்கு KIRO_API_KEY-ஐ container environment வழியாக அனுப்பவும். அங்கீகாரம் (authentication) அமைக்கப்படும் வரை, gateway தொடங்கும் மற்றும் dashboard ஏற்றப்படும், ஆனால் அதன் default harness-ல் தொடர்புகொள்ள எந்த model-ம் இருக்காது. 0.10.0 முதல், kiro-cli நிறுவப்பட வேண்டிய அவசியமில்லாத உள்ளமைக்கப்பட்ட KAS engine உள்ளது; 0.11.0, சேமிக்கப்பட்ட harness தேர்வு இல்லாத புதிய நிறுவல்களுக்கு KAS-ஐ default-ஆக மாற்றியது, அதே நேரத்தில் Kiro CLI தேர்வுகளை அப்படியே வைத்திருக்கிறது. KAS, kiro-cli login-க்கு பதிலாக Crew-ன் சொந்த sign-in-ஐப் பயன்படுத்துகிறது. திட்டத்தின் custom backend வழிகாட்டி, claude harness மூலம் முக்கிய model உரையாடல்களை நீங்கள் தேர்ந்தெடுக்கும் Anthropic-compatible endpoint-க்கு அனுப்ப அனுமதிக்கிறது, ஆனால் Kiro-குறிப்பிட்ட அம்சங்களுக்கு kiro-cli sign-in தேவைப்படும்.

இந்தக் கட்டுரை பயனுள்ளதாக இருந்ததா?