KiroCrew VPS üzerinde nasıl kurulur ve çalıştırılır
KiroCrew uygulamasını VPS üzerinde Docker ve systemd ile sürekli çalışır hale getirin. Bellek ve zamanlanmış görevlerin kesintisiz sürmesi için gereken yapılandırma adımları.
KiroCrew uygulamasını dizüstü bilgisayar yerine neden VPS üzerinde barındırmalısınız
KiroCrew uygulamasını kendi sunucunuzda barındırmak yalnızca hiç kapanmayan bir makinede verim sağlar; bu nedenle VPS uygun bir ortamdır, dizüstü bilgisayar ise değildir. KiroCrew oturum geçmişini, anlamsal belleği, zamanlanmış görevleri ve onay kuyruğunu disk üzerinde tutar ve süreç yeniden başlatıldığında tüm bunları tekrar yükler. Zamanlanmış bir görevin vakti geldiğinde, saat 03:00'te süreç çalışmıyorsa bunların hiçbirinin bir faydası olmaz; kapalı bir dizüstü bilgisayar ise bu süreci çalıştırmaz.
KiroCrew, Kiro ekibi tarafından geliştirilen, Apache 2.0 lisansına sahip ve 0.1.0 sürümü 22 Temmuz 2026 tarihinde yayınlanan açık kaynaklı bir aracı çalışma alanıdır. Gateway adı verilen tek bir süreç, durumu yönetir ve 5476 numaralı port üzerinden bir web paneli sunar. Bu gateway'e panel üzerinden, kirocrew CLI aracından veya Slack gibi bir sohbet kanalından erişirsiniz. Kendi sunucunuzda barındırdığınız tek bileşen bu gateway'dir; dolayısıyla bu rehber, onu nasıl ayakta tutacağınız, genel internete nasıl kapatacağınız ve hatalı bir yükseltme sonrasında nasıl geri yükleyeceğiniz üzerinedir.
Başlamadan önce bilinmesi gereken iki husus vardır. 0.11.0 sürümünden itibaren, kayıtlı bir harness seçimi bulunmayan yeni KiroCrew kurulumları, kiro-cli gerektirmeksizin varsayılan olarak KAS kullanır; mevcut açık Kiro CLI seçimleri korunur. Kiro altyapılarındaki çıkarım işlemleri Kiro planınızı kullanır, bu nedenle 1 Kasım 2026 itibarıyla bu varsayılan kurulum çevrimdışı değildir. Proje henüz yenidir ve hızlı ilerlemektedir: kararlı sürümleri 5 Ağustos 2026'daki 0.1.3 sürümünden 25 Ekim 2026'daki 0.10.0 sürümüne yükselmiş, arada 9 Ekim'de 0.8.0 ve 16 Ekim'de 0.9.0 sürümleri yayınlanmış, 25 Ekim'de ise 0.11.0 sürüm adayı ön sürüm olarak çıkmıştır. Bir noktada geri alma işlemi yapmanız gerekeceğini varsayın ve kurulumu buna olanak tanıyacak şekilde gerçekleştirin. Daha önce bir sunucuda aracı (agent) çalıştırmadıysanız, VPS üzerinde kodlama aracı çalıştırma başlıklı içerik, bu rehberin temelini oluşturan kuralları kapsar. Aracı tarafı sizin için sunucu tarafına göre daha yeniyse, önce aracı döngüsünün, araçlarının ve belleğinin ne olduğunu öğrenmek, aşağıdaki seçenekleri birer büyü gibi değil, bilinçli kararlar olarak okumanızı sağlayacaktır.
KiroCrew gereksinimleri ve durum verisinin konumu
Yerel bir kurulum, Python 3.12 veya daha yeni bir sürüm ile dashboard kaynağını derleyecekseniz Node.js 22.12.0 veya daha yeni bir sürüm gerektirir (proje, Node 24 LTS sürümünü önermektedir). Kiro CLI backend, kiro-cli gerektirir ve kiro-cli login ile ya da otomasyon kullanımı için bir API anahtarı ile kimlik doğrulaması yapılır; 0.10.0 sürümünden bu yana, yerleşik KAS motoru kiro-cli kurulu olmadan çalışmaktadır ve 0.11.0, kayıtlı bir harness tercihi olmayan yeni kurulumlar için bunu varsayılan hale getirmiştir. Konteyner kurulumu, ana makinede bunların hiçbirine ihtiyaç duymaz. Sadece Docker gerektirir. Tercih edilmesinin temel nedeni budur.
Durum verisi ~/.kiro/crew içinde tutulur ve KIROCREW_HOME ortam değişkeni ile başka bir yere taşınabilir. İçerisinde şunlar bulunur:
config.json: ağ geçidi ayarları ve sohbet kanalı kimlik bilgileri..env: gizli anahtarlar.workspace/memory/: tercihler, proje notları ve sohbet geçmişi.memory.dbvememory_index.db: anlamsal ve tam metin dizinleri.models/: ilk çalıştırmada indirilen embedding modeli.security_events.jsonl: güvenlik olay günlüğü.
Söz konusu dizin, kurulumun kendisidir. Bu dizini yeni bir VPS'e kopyaladığınızda temsilcinizi taşımış olursunuz; bu nedenle aşağıdaki yedekleme bölümü, kurulum bölümünden daha önemlidir.
RAM yerine disk alanını planlayın. Ağ geçidi bir Python sürecidir; sistemi asıl yükleyen şey, temsilcinin çalıştırdığı derleme veya test paketidir. Durum dizini sohbet geçmişiyle birlikte büyür ve embedding modeli ilk başlatmada indirilir; bu nedenle projenin ilk aylarında yayınlanan rakamlara güvenmek yerine, birkaç hafta sonra kendi sunucunuzda du -sh ~/.kiro/crew ile ölçüm yapın. Her işçiye kendi konteynerini ve tarayıcısını veren bir çalışma zamanı ile bunu kıyaslayın; bu durumda OpenBot'un yapay zeka iş arkadaşlarını kendi sunucunuzda barındırmak, boyutlandırmayı diskten önce bir RAM sorunu haline getirir.
Dört kurulum yolundan hangisini kullanmalısınız
Proje dört farklı yöntem sunar: masaüstü uygulaması, tek satırlık wheel, kaynak kod ve Docker. Tek satırlık yükleyici bir wheel dosyasını çeker ve bir kirocrew başlatıcısı oluşturur; eğer dizini PATH değişkeninizde değilse, eklemeniz için gerekli talimatları yazdırır:
curl -fsSL https://download.crew.kiro.dev/cli.sh | shKanal bayrağı ve sürüm bayrağı alır:
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.0Konteyner imajı ghcr.io/kirodotdev/kirocrew adresinde, her etiket altında linux/amd64 ve linux/arm64 için yayınlanır. Kaynak koddan derleme git clone ve make build gerektirir; bu yöntem uygulamayı çalıştıranlar için değil, kod üzerinde değişiklik yapanlar içindir.
Konteyneri kullanın. Yerel kaynak kod kurulumu, Python paketlerini ve Node'u diğer servislerinizin çalıştığı aynı ana makineye yerleştirir; ayrıca Kiro CLI arka ucunu kullanırken kiro-cli ekler. Bu nedenle hatalı bir yükseltme işlemi, sistemi elle düzeltmenizi gerektirir. Konteyner ise çalışma zamanını tek bir imajda, durumu ise tek bir birimde (volume) tutar; bu da geri almayı sadece bir etiket değişikliği ve yeniden başlatma işlemine indirger.
İmajı bir sürüm etiketine sabitleyin, stable etiketine değil
Projenin kendi örneği stable etiketini kullanmaktadır:
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stablestable değişken bir etikettir, aynı sürümü işaret eden latest etiketi de öyledir. Bu etiket, o anki en güncel kararlı sürümü işaret eder; dolayısıyla bir sonraki çekme (pull) işleminde, siz seçmeden çalıştırdığınız sürüm değişebilir ve etiket, hangi sürümün kullanıldığına dair hiçbir kayıt tutmaz. Sürüm etiketleri değiştirilemezdir, bu yüzden bir tanesini sabitleyin. 1 Kasım 2026 itibarıyla en güncel kararlı sürüm, 31 Ekim 2026 tarihinde yayınlanan ve 0.11.0 içindeki bellek bütünlüğü ve KAS düzeltmelerini içeren bir ara yama olan 0.11.1 sürümüdür. Aşağıdaki 0.8.0 örneği Kiro CLI kullanmaktadır. Ayrıca insider ve nightly etiketleri de mevcuttur; nightly, main üzerinden yapılan derlemeleri takip eder.
/opt/kirocrew/compose.yaml dosyasını yazın:
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:Servisi başlatın ve ardından imajın kendi HEALTHCHECK mekanizması için de kullandığı sağlık kontrolü uç noktasını denetleyin:
cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/healthdocker compose ps, bir dakika içerisinde container durumunun sağlıklı olduğunu bildirmelidir ve /api/health, herhangi bir token gerektirmeden yanıt verir (prob olarak kullanılabilmelerini sağlayan /api/live ve /api/ready uç noktaları da aynı şekilde çalışır). Durum starting olarak kalırsa, herhangi bir değişiklik yapmadan önce docker logs kirocrew dosyasını okuyun. İlk çalıştırma sırasında gömme (embedding) modeli arka planda indirilir; model gelene kadar bellek araması anahtar kelime eşleştirme yöntemini kullanır.
systemd ile çalışır durumda tutma
restart: unless-stopped, Docker'ın kendisi önyüklemede başladığı sürece, bir çökme sonrasında veya yeniden başlatmanın ardından container'ı tekrar ayağa kaldırır. Bir unit dosyası bu bağımlılığı belirginleştirir ve yedekleme öncesinde tüm yığını durdurmanızı sağlayan tek bir komut sunar. Docker Compose yığınını önyüklemede başlatma genel modeli ele almaktadır. Bunun KiroCrew biçimi /etc/systemd/system/kirocrew.service içinde yer alır:
[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, bu unit için sağlıklı sonuç olan active (exited) değerini okumalıdır. RemainAfterExit=yes ile birlikte Type=oneshot burada doğrudur çünkü docker compose up -d, container başlatılır başlatılmaz geri döner: systemd, ön planda çalışan bir süreci değil, yığının ayakta olduğu gerçeğini takip eder. Bunun yerine Type=simple yazarsanız, systemd komutun hemen sonlandığını görür, servisi ölü olarak işaretler ve Restart= ayarınıza bağlı olarak ya pes eder ya da yeniden başlatma döngüsüne girer. Yerel bir kurulum için proje kendi eşdeğeri olan kirocrew service install dosyasını sunar; bu dosya /etc/systemd/system/kirocrew.service yazar ve ağ geçidini sizin kullanıcınız olarak çalıştırır. Her iki unit dosyasını aynı anda çalıştırmayın. Bu konunun daha geniş kapsamlı hali VPS üzerinde systemd servisleri ve zamanlayıcıları başlığındadır. Geri gelmeyen bir unit, siz onu konuşturmadığınız sürece sessiz kalır; bu nedenle kendi ntfy sunucunuza uyarı gönderen bir OnFailure= işleyicisi ekleyin. Böylece ağ geçidinin kapalı olduğunu, hiç çalışmamış zamanlanmış bir işten değil, doğrudan telefonunuzdan öğrenirsiniz.
İlk çalıştırma: oturum açma ve kontrol paneli belirteci alma
Konteyner ağ geçidini başlatır, ancak sabitlenmiş 0.8.0 imajındaki varsayılan Kiro CLI çalışma zamanı hala kimlik doğrulaması gerektirir. Konteyner içinde oturum açın veya otomatik kullanım için KIRO_API_KEY değerini konteyner ortamı üzerinden geçirin:
docker exec -it kirocrew kiro-cli loginBu komut bir cihaz kodu ve kendi tarayıcınızda açmanız gereken bir URL çıktısı verir. Ardından bir kontrol paneli belirteci oluşturun:
docker exec kirocrew kirocrew token --ttl 2hKontrol paneli URL adresi http://localhost:5476/?token=<the token> şeklindedir. Belirteçlerin süresi dolabilir: yazdırılan bağlantı, oluşturulduktan sonra beş dakika içinde açılmalıdır; bu komut iki saatlik bir erişim çerezi talep eder ve belgelenen maksimum süre yirmi saattir. Tarayıcı ayrıca 30 günlük kayan bir boşta kalma süresine sahip bir yenileme çerezi alır, böylece aktif bir oturum başka bir bağlantıya gerek kalmadan yenilenir. Boş yüklenen veya sizi doğrudan dışarı atan bir kontrol paneli genellikle süresi dolmuş bir belirteçten kaynaklanır; bu durumda yeni bir tane oluşturun ve hemen açın. Bir belirteci asla destek talebine veya sohbet mesajına yapıştırmayın, çünkü belirtece sahip olan kişi temsilcinizin kontrolünü ele geçirmiş olur.
Paneli SSH üzerinden erişilebilir kılın ve 5476 numaralı portu asla dışarıya açmayın
Projenin örneğindeki bind adresini tekrar inceleyin: -p 127.0.0.1:5476:5476. Gateway, container içerisinde 0.0.0.0 adresini dinler; çünkü port eşlemesi üzerinden erişilebilir olması gerekir, ancak eşlemenin kendisi ana makinede yalnızca loopback arayüzüne yayın yapar. 127.0.0.1: önekini silerseniz, gateway o portu tarayan herkes için genel internete açılmış olur. Bir ufw kuralı da sizi kurtarmaz: Docker, portları ufw kuralları uygulanmadan önce trafiği yönlendiren DNAT kuralları yazarak yayınlar, bu yüzden ufw deny 5476 yayınlanmış bir port üzerinde hiçbir işe yaramaz. Docker'ın varsayılan iptables altyapısında, Docker'ın kendi çözümü filtreleme kurallarını DOCKER-USER zincirine yerleştirmektir. Bu yöntem çalışır, ancak bu kurallar conntrack eklentisi ile eşleştirme yapmadığınız sürece container'ın dahili adresini ve portunu görür; bu nedenle loopback bind işlemi daha basit ve hata yapılması daha zor olan kontrol yöntemidir. Docker'ın nftables altyapısı ise özel filtreleme için ayrı nftables tabloları ve temel zincirler kullanır. Docker portlarının ufw'yi atlaması bu mekanizmayı detaylıca açıklar.
Bunun yerine portu dizüstü bilgisayarınızdan SSH üzerinden yönlendirin:
ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.comBu komutu çalışır durumda bırakın ve yerel olarak http://localhost:5476/?token=<the token> adresini açın. Yönlendirmeyi her bağlantıda otomatik hale getirmek için ~/.ssh/config dosyasına ekleyin:
Host your-server.example.com
LocalForward 5476 127.0.0.1:5476Eğer 5476 numaralı port dizüstü bilgisayarınızda zaten kullanımdaysa, yalnızca soldaki sayıyı değiştirin: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com, ardından http://localhost:45476/?token=... adresine gidin. Ek bir loopback-port ayarına veya container'ın yeniden oluşturulmasına gerek yoktur: loopback Origin, isteğin kendi Host bilgisiyle eşleşir, bu yüzden CSRF denetimi bunu kabul eder. İkinci bir aracı sunucuyu paylaştığında bu şekilde yönlendirmeleri üst üste ekleyeceksiniz, çünkü güvenlik taraması için open-kritt self-hosting işlemi, aynı sunucuda 5173 numaralı port üzerinde başka bir sadece-loopback paneli daha oluşturur.
Panel üzerinden hangi ayarları değiştirebileceğinize iki belgelenmiş davranış karar verir. Birincisi, gateway yönlendirme başlıkları (Forwarded, X-Forwarded-* veya X-Real-IP) taşıyan her isteği uzak olarak kabul eder ve yapılandırma yazma ile gizli veri görüntüleme uç noktaları bu istekleri reddeder. Bir reverse proxy bu başlıkları ekler; düz bir ssh -L yönlendirmesi ise hiçbir başlık eklemez, bu yüzden istek yerel görünür ve bu gerekçeyle reddedilmez. İkincisi, container imajında kanal kimlik bilgisi sayfaları ve gizli veri görüntüleme görünümleri, doğrudan yerel olmayan her tarayıcı için salt okunurdur ve imaj içerisinde bir metin düzenleyici bulunmaz. Panel üzerinden kaydedilmeyen bir kanal kimlik bilgisi bu kısıtlamadan kaynaklıdır, bir hata değildir. Yapılandırmayı bunun yerine ana makinede düzenleyin:
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 kirocrewTelefon erişimi için proje, paneli genel bir ana makine adı yerine kendi tailnet ağınızda tutan Tailscale tailscale serve çözümünü işaret eder. Bunu genel bir reverse proxy kullanımına tercih edin. Token URL içerisinde taşınır ve bir URL, yolundaki her erişim günlüğüne yazılır. Bu kural portun kendisinden ziyade portun arkasında neyin durduğu ile ilgilidir: Jellyfin kütüphanesini 90'ların video mağazası gibi taranabilir bir yapıya dönüştüren Halcyon gibi araçlar başkalarının erişimine açılabilir ve reverse proxy için uygun adaylardır, ancak sunucunuzda komut çalıştırabilen bir gateway bu kategoriye girmez.
Ağaya en küçük etki alanını atayın
Konteyner, ilk başlatıldığında sandbox desteğini denetler ve sonuç, ağaların herhangi bir şey çalıştırıp çalıştıramayacağına karar verir. Namespace izolasyonu mevcutsa, ağa alt süreçleri izole bir şekilde çalışır. Eğer izolasyon mevcut değilse ve KIROCREW_ALLOW_UNSANDBOXED=1 ayarlanmamışsa, süreçler kısıtlanmamış bir şekilde çalıştırılmak yerine reddedilir; bu nedenle, her görev askıda kalırken ağ geçidinin sağlıklı görünmesi genellikle bu durumdan kaynaklanır. Karar, ilk çalıştırmadan itibaren docker logs kirocrew içinde saklanır. Proje ayrıca uygulayabileceğiniz bir seccomp (secure computing mode) profili de yayınlar:
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 etkin olan bir ana makinede, projenin Docker kılavuzu seccomp profilini değişikliğin yalnızca yarısı olarak nitelendirir; çünkü Docker aynı zamanda kendi docker-default AppArmor profilini de ekler ve bu profili apparmor=unconfined ile eşleştirir. Bu seçenek yalnızca AppArmor'un konteyner bazlı kurallarını kaldırır; seccomp profili, düşürülen yetenekler ve root olmayan kullanıcı kısıtlamaları geçerliliğini korur.
Eğer KIROCREW_ALLOW_UNSANDBOXED=1 ayarını yaparsanız, neyin değiştiğini net bir şekilde anlayın: konteyner artık ağa ile sunucunuz arasındaki tek sınırdır. Projenin uyarısını tam olarak tekrarlamakta fayda var. Doğrudan ağaya vermeyeceğiniz hiçbir ana makine yolunu mount etmeyin. Uygulamada bu durum, Docker socket'ini, / dizininin herhangi bir bind mount işlemini ve başka bir servisin verilerini tutan tüm dizinleri kapsam dışı bırakır.
Geriye kalan kısım, komut çalıştırmasına izin verilen her ağa için geçerli olan çerçevedir. Kimlik bilgilerini yalnızca ihtiyaç duyduğu tek bir depo veya tek bir bucket ile sınırlandırın; asla hesap genelinde yetkilere sahip kişisel bir token kullanmayın. Ağayı, ana dizininde başka hiçbir şey bulunmayan özel bir kullanıcı olarak çalıştırın; VPS üzerinde en düşük yetkili kullanıcılar rehberi bunun içindir. Ağa kod yazıp ardından bu kodu çalıştırdığında, ona bozmasına izin verilen bir makine verin: kodlama ağaları için tek kullanımlık bir VM, bu compose dosyasındaki herhangi bir bayraktan daha güçlü bir sınırdır, çünkü onu temizlemek yerine doğrudan silersiniz. Aynı mantık OpenClaw'u bir VPS üzerinde güvenli çalıştırma ve Hermes ağasını bir VPS üzerinde self-host etme süreçlerini de şekillendirir. Araçlar da etki alanına dahildir: ağaya web araması yetkisi vermek, getirdiği her sayfayı güvenilmeyen bir girdi haline getirir; bu nedenle onu kendi SearXNG örneğinize yönlendirmek, teknik bir altyapı kararı olduğu kadar bir prompt injection önlemidir. Zamanlanmış işler siz uyurken de para harcar, çünkü Kiro arka uçlarındaki çıkarım işlemleri Kiro planınızı kullanır; bu yüzden gece çalışan bir iş eklemeden önce bir VPS üzerinde yapay zeka ağası maliyetlerini kontrol etme bölümünde açıklanan limitleri ayarlayın.
Her yükseltme öncesinde durum birimini yedekleyin
Önce gerçek birim adını bulun. Compose, adlandırılmış birimleri proje adıyla önekler; proje adı varsayılan olarak dizin adıdır. Bu nedenle kirocrew-home içinde /opt/kirocrew/compose.yaml olarak tanımlanan birim, kirocrew_kirocrew-home şeklinde oluşturulur:
docker volume lsHerhangi bir kopyalama işlemi yapmadan önce ağ geçidini durdurun. memory.db ve memory_index.db SQLite veritabanlarıdır. Yazma işlemi devam ederken bir veritabanını kopyalamak, yarıda kalmış bir işlemin kaydedilmesine ve geri yükleme sırasında dosyanın bozuk çıkmasına neden olabilir. Projenin kendi taşıma talimatları da aynı şeyi belirtir: verileri yalnızca ağ geçitleri durdurulduğunda taşıyın. Bu "önce durdur" kuralı yalnızca KiroCrew'e özgü değildir; eğer sunucuda bir fotoğraf sunucusu da barındırılıyorsa, PhotoPrism ve Immich karşılaştırması bu iki servisin her biri için gereken kesin yedekleme komutlarını sunar.
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 kirocrewArşivi sunucudan dışarı kopyalayın. Geri yükleme işlemi, container durdurulmuş haldeyken ve tar czf yerine tar xzf kullanılarak aynı komutla gerçekleştirilir:
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 kirocrewYeni bir sunucuya geçiş yapmak, yerinde geri yükleme yapmaktan farklı bir işlemdir ve proje bu konuda özel talimatlar içerir. workspace/memory/ altındaki sohbet geçmişi ve proje notları, iki veritabanı dosyası ve config.json ile birlikte taşınabilir. PID dosyaları, güvenlik olay günlüğü ve .env eski sunucuya bağlıdır; bu nedenle bunları geride bırakın ve yeni sunucuda gizli bilgileri (secrets) yeniden girin.
Hatalı bir yükseltme işlemi nasıl geri alınır
Yükseltme işlemi kısa sürer ve yalnızca bir sürümü sabitlediğiniz (pin) için güvenlidir. Önce yedeği alın, ardından etiketi değiştirin:
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, imaj sunucuda mevcut değilse onu çeker; bu nedenle etiket düzenlemesi yükseltmenin tamamıdır. Geri alma işlemi, eski numara ile aynı dizinin izlenmesidir ve sürüm etiketleri değiştirilemez olduğu için size daha önceki imajın aynısını verir.
İkili dosya sorunsuz bir şekilde geri döner. Durum (state) kısmı ise sorun yaratabilir. Daha yeni bir gateway, config.json dosyasını yeniden yazabilir veya bellek içi veritabanlarını eski bir gateway'in okuyamayacağı bir biçime dönüştürebilir; 12 Ekim 2026 itibarıyla durum verisi için belgelenmiş bir sürüm düşürme yolu bulunmamaktadır. Kurulum kılavuzu bir durum hakkında net bir uyarıda bulunur: eski ~/.kirocrew dizininden taşınan verilerin geri dönüşü yoktur ve ~/.kiro/crew öncesindeki bir sürüm boş olarak başlayacaktır. Bu nedenle, eski imaj başlar ve ardından beklenmedik şekilde davranırsa hata ayıklamaya çalışmayın. Servisi durdurun, yükseltme öncesinde aldığınız yedeği geri yükleyin ve yeniden başlatın. Yedeğin ilk sırada alınmasının tek nedeni budur ve yükseltmeyi hemen yapıp yedeği sonraya bırakma alışkanlığının bu kadar yeni bir projede başarısız olmasının sebebi de budur.
Burada kanıtlanmamış olanlar
Bu yazılımın yaşı konusunda dürüst olunmalıdır. 0.1.3 sürümü 5 Ağustos 2026 tarihinde yayınlanmış olup, 12 Ekim 2026 itibarıyla kararlı sürüm hattı 0.8.0 seviyesine ulaşmıştır. Sürüm notlarının çoğu hala otomatikleştirilmiş değişiklik günlüklerinden ibarettir; 0.8.0 notları elle yazılmış olsa da herhangi bir geçiş bölümü içermemektedir ve genel sürüm geçmişi yaklaşık üç aylıktır. Bu kılavuzdaki hiçbir bilgi uzun vadeli sonuçlara dayanmamaktadır; bu nedenle bellek artışı, veritabanı boyutu ve zamanlayıcı güvenilirliği gibi konuları varsayım olarak kabul etmek yerine kendi sunucunuzda ölçümlemeniz gereken değerler olarak değerlendirin.
İki davranış, güvenmeden önce bizzat test edilmeye değerdir. Birincisi, bir sürüm düşürme işleminin daha yeni bir sürüm tarafından yazılan durumu okuyup okuyamadığıdır; bunu bir kesinti sırasında değil, bir sorun teşkil etmeyeceği bir zamanda birim kopyası üzerinde deneyin. İkincisi, zamanlanmış bir işin zamanı geldiğinde Kiro oturum açma süresi dolarsa ağ geçidinin ne yaptığıdır. Her ikisi de genç bir projenin sürümler arasında sessizce düzelttiği pürüzlü kenar türündendir ve her ikisini de şimdi kontrol etmenin maliyeti düşüktür.
FAQ
KiroCrew paneli sunucumun genel IP adresi üzerinden neden açılmıyor?
Çünkü paylaşılan örnekte port, loopback arayüzüne bağlanmıştır. -p 127.0.0.1:5476:5476, container portunu yalnızca ana makinenin loopback adresine eşler; bu kasıtlı bir tercihtir. Panele erişmek için ssh -N -L 5476:127.0.0.1:5476 you@your-server ile portu SSH üzerinden yönlendirin ve ardından dizüstü bilgisayarınızda http://localhost:5476/?token=<token> adresini açın. Erişilebilir kılmak için 127.0.0.1: önekini kaldırmak, ağ geçidini genel internete açar. Docker'ın yayınlanan portlara yönelik DNAT kuralları, trafiği ufw kuralları devreye girmeden önce yönlendirdiği için ufw bu trafiği engelleyemez. Yayınlanan portları filtrelemek için Docker'ın DOCKER-USER zincirini (iptables altyapısı ile) veya nftables altyapısı ile ayrı nftables temel zincirlerini kullanın; ancak loopback bağlamasını korumak daha basit bir yöntemdir.
KiroCrew verilerini nerede saklar ve neleri yedeklemeliyim?
Her şey ~/.kiro/crew altında bulunur; bu dizin container imajı içinde /home/kirocrew/.kiro/crew konumundadır ve KIROCREW_HOME ile yeri değiştirilebilir. Ağ geçidi durdurulmuş haldeyken tüm dizini veya tüm Docker volume içeriğini yedekleyin. memory.db ve memory_index.db SQLite veritabanlarıdır; bu nedenle ağ geçidi yazma işlemi yaparken alınan bir kopya tutarsız olabilir. Yeni bir ana makineye taşınırken workspace/memory/, iki veritabanı dosyası ve config.json taşınmalıdır; PID dosyaları, güvenlik olay günlüğü ve .env ise eski ana makineye aittir.
stable etiketini mi yoksa bir sürüm etiketini mi kullanmalıyım?
Sürüm etiketi kullanın. stable, her yeni sürüm yayınlandığında değişir; bu nedenle bir sonraki çekme işleminde çalıştırdığınız sürüm değişebilir ve etiketin kendisi neyin çalıştığına dair bilgi vermez. 0.8.0 gibi sürüm etiketleri değiştirilemezdir; geri alma (rollback) işleminin çalışmasını sağlayan tam olarak budur: eski sürüm numarasını geri yüklersiniz ve aynı imajı elde edersiniz. 1 Kasım 2026 itibarıyla en yeni kararlı sürüm 0.11.1'dir.
Ajanım neden hiçbir komutu çalıştırmayı reddediyor?
Container, ilk başlatıldığında sandbox desteğini kontrol eder. Ajan alt süreçlerini izole edemezse ve KIROCREW_ALLOW_UNSANDBOXED=1 ayarlanmamışsa, bunları kısıtlanmamış şekilde çalıştırmak yerine yürütmeyi reddeder; bu durumda ağ geçidi sağlıklı görünür ancak tüm görevler durur. docker logs kirocrew, ilk çalıştırmadaki sandbox kararını gösterir. Bu değişkeni ayarlamak, container'ı ajan ile ana makine arasındaki tek sınır haline getirir; bu nedenle ayarlarsanız, doğrudan ajana vermeyeceğiniz hiçbir şeyi mount etmeyin.
KiroCrew'u kendi sunucumda barındırmak için bir Kiro hesabına ihtiyacım var mı?
1 Kasım 2026 itibarıyla Kiro arka uçları için evet. KiroCrew, Apache 2.0 lisanslı özgür bir yazılımdır ancak bu arka uçlardaki çıkarım (inference) işlemleri Kiro planınızı kullanır. Sabitlenmiş 0.8.0 container'ı Kiro CLI kullanır: docker exec -it kirocrew kiro-cli login komutunu çalıştırın ve tarayıcınızda cihaz kodunu onaylayın ya da otomasyon kullanımı için KIRO_API_KEY değerini container ortamı üzerinden geçirin. Kimlik doğrulama yapılandırılana kadar ağ geçidi başlar ve panel yüklenir ancak varsayılan donanımı (harness) üzerinde konuşacak bir model yoktur. 0.10.0 sürümünden bu yana, kiro-cli kurulumu gerektirmeyen yerleşik bir KAS motoru da mevcuttur; 0.11.0, kaydedilmiş bir donanım seçimi olmayan yeni kurulumlarda KAS'ı varsayılan hale getirmiş, ancak açık Kiro CLI seçimlerini korumuştur. KAS, kiro-cli login yerine Crew'un kendi oturum açma sistemini kullanır. Projenin özel arka uç kılavuzu, bir claude donanımının ana model dönüşlerini seçtiğiniz Anthropic uyumlu bir uç noktaya göndermesine olanak tanır ancak Kiro'ya özgü özellikler için kiro-cli oturum açma gereksinimi devam eder.