SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Self-Host KiroCrew di VPS agar Selalu Aktif

Jalankan KiroCrew sebagai container yang dipatok di VPS sendiri. Panduan ini mencakup Docker, systemd, akses SSH, backup, rollback, dan port 5476.

Mengapa melakukan self-hosting KiroCrew di VPS, bukan di laptop

Self-hosting KiroCrew hanya bermanfaat pada mesin yang tidak pernah tidur, sehingga VPS adalah tempat yang tepat dan laptop bukan. KiroCrew menyimpan riwayat sesi, memori semantik, tugas terjadwal, dan antrean persetujuan di disk, lalu memuat semuanya kembali saat proses dimulai ulang. Semua itu tidak berguna jika proses tidak berjalan pada 03:00 ketika tugas terjadwal harus dijalankan. Laptop yang ditutup juga tidak menjalankan proses tersebut.

KiroCrew adalah ruang kerja agen open source dari tim Kiro, dengan lisensi Apache 2.0, dan 0.1.0 dirilis pada 22 July 2026. Satu proses yang disebut gateway mengelola state dan menyediakan dasbor web pada port 5476. Anda mengakses gateway tersebut melalui dasbor, CLI kirocrew, atau kanal chat seperti Slack. Gateway adalah satu-satunya komponen yang Anda lakukan self-hosting. Karena itu, panduan ini membahas cara menjaganya tetap berjalan, menjaganya agar tidak terekspos ke Internet publik, dan memulihkannya setelah upgrade yang bermasalah.

Ada dua hal yang perlu diketahui sebelum memulai. Sejak 0.11.0, instalasi KiroCrew baru yang tidak memiliki pilihan harness tersimpan akan menggunakan KAS secara default tanpa memerlukan kiro-cli. Pilihan Kiro CLI eksplisit yang sudah ada tetap dipertahankan. Inferensi pada backend Kiro menggunakan paket Kiro Anda. Jadi, per 1 November 2026, konfigurasi default ini tidak berjalan secara offline. Proyek ini juga masih baru dan berkembang cepat. Rilis stabilnya berubah dari 0.1.3 pada 5 August 2026 menjadi 0.10.0 pada 25 October 2026. Di antaranya, 0.8.0 dirilis pada 9 October dan 0.9.0 pada 16 October. Kandidat rilis 0.11.0 juga sudah tersedia sebagai pra-rilis pada 25 October. Anggap bahwa Anda akan perlu melakukan rollback pada suatu saat, lalu instalasikan dengan cara yang memungkinkan hal itu. Jika Anda belum pernah menjalankan agen pada server, menjalankan agen coding pada VPS membahas dasar-dasar yang menjadi landasan panduan ini. Jika Anda lebih baru memahami sisi agen daripada sisi server, baca terlebih dahulu memahami apa itu loop agen, tool-nya, dan memorinya. Dengan demikian, pilihan di bawah ini akan terbaca sebagai keputusan, bukan rangkaian perintah tanpa penjelasan.

Kebutuhan KiroCrew dan lokasi penyimpanan state

Instalasi native memerlukan Python 3.12 atau yang lebih baru dan Node.js 22.12.0 atau yang lebih baru jika Anda membangun dashboard dari source (proyek ini merekomendasikan Node 24 LTS). Backend Kiro CLI memerlukan kiro-cli, yang diautentikasi dengan kiro-cli login atau API key untuk penggunaan otomatis; sejak 0.10.0, engine KAS bawaan dapat berjalan tanpa kiro-cli terinstal, dan 0.11.0 menjadikannya default untuk instalasi baru yang belum memiliki pilihan harness tersimpan. Instalasi container tidak memerlukan semua itu pada host. Instalasi tersebut hanya memerlukan Docker. Itulah alasan utama untuk memilihnya.

State disimpan di ~/.kiro/crew, dan environment variable KIROCREW_HOME memindahkannya ke lokasi lain. Isi direktori tersebut:

  • config.json: pengaturan gateway dan kredensial channel chat.
  • .env: secret.
  • workspace/memory/: preferensi, catatan proyek, dan riwayat chat.
  • memory.db dan memory_index.db: indeks semantik dan full-text.
  • models/: model embedding, yang diunduh saat pertama kali dijalankan.
  • security_events.jsonl: log peristiwa keamanan.

Direktori tersebut adalah instalasinya. Salin direktori itu ke VPS baru dan agent Anda ikut berpindah. Karena itu, bagian pencadangan di bawah ini lebih penting daripada bagian instalasi.

Prioritaskan perencanaan kapasitas disk, bukan RAM. Gateway berjalan sebagai proses Python; beban yang sebenarnya diterima server berasal dari apa pun yang dijalankan agent, seperti build atau test suite. Direktori state bertambah seiring riwayat chat, dan model embedding diunduh saat pertama kali dijalankan. Karena itu, ukur penggunaannya di server Anda sendiri dengan du -sh ~/.kiro/crew setelah beberapa minggu, alih-alih mempercayai angka yang dipublikasikan pada bulan-bulan awal proyek. Bandingkan dengan runtime yang memberikan setiap worker container dan browser sendiri. Dalam self-hosting rekan kerja AI OpenBot, perencanaan kapasitas menjadi persoalan RAM sebelum menjadi persoalan disk.

Jalur instalasi mana yang sebaiknya digunakan

Proyek ini menyediakan empat jalur: aplikasi desktop, wheel satu baris, kode sumber, dan Docker. Installer satu baris mengambil sebuah wheel dan membuat peluncur kirocrew. Jika direktorinya tidak ada dalam PATH, installer tersebut menampilkan petunjuk untuk menambahkannya:

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh

Installer ini menerima flag channel dan flag versi:

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

Image container dipublikasikan di ghcr.io/kirodotdev/kirocrew, untuk linux/amd64 dan linux/arm64 pada setiap tag. Build dari kode sumber memerlukan git clone serta make build, dan ditujukan bagi pengguna yang mengubah kode, bukan bagi pengguna yang menjalankannya.

Gunakan container. Instalasi native dari kode sumber menempatkan paket Python dan Node pada host yang sama dengan layanan lain yang Anda jalankan, serta kiro-cli jika menggunakan backend Kiro CLI. Akibatnya, jika upgrade gagal, Anda harus membatalkan perubahan tersebut secara manual. Container menyimpan runtime dalam satu image dan state dalam satu volume. Dengan demikian, rollback cukup dilakukan dengan mengganti tag dan melakukan restart.

Tetapkan image ke tag rilis, bukan ke stable

Contoh dari proyek itu sendiri menggunakan tag stable:

docker run -d --name kirocrew \
  -p 127.0.0.1:5476:5476 \
  -v kirocrew-home:/home/kirocrew \
  ghcr.io/kirodotdev/kirocrew:stable

stable adalah tag yang dapat berubah, begitu pula latest, yang mengarah ke rilis yang sama. Tag tersebut selalu mengarah ke rilis stabil terbaru. Karena itu, pull berikutnya dapat mengubah versi yang sedang Anda jalankan tanpa pilihan dari Anda, dan tag tersebut tidak mencatat versi yang digunakan. Tag versi bersifat tidak dapat diubah, jadi tetapkan salah satunya. Rilis stabil terbaru per 1 November 2026 adalah 0.11.1, yang diterbitkan pada 31 October 2026. Rilis ini merupakan patch penting untuk integritas memori dan perbaikan KAS pada 0.11.0. Contoh 0.8.0 di bawah menggunakan Kiro CLI. Tersedia juga tag insider dan nightly; nightly mengikuti build dari main.

Tulis /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:

Jalankan image tersebut, lalu periksa endpoint health yang juga digunakan image untuk HEALTHCHECK miliknya:

cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/health

docker compose ps seharusnya melaporkan bahwa container sehat dalam waktu sekitar satu menit, dan /api/health memberikan respons tanpa token. Hal yang sama berlaku untuk /api/live dan /api/ready, sehingga endpoint tersebut dapat digunakan sebagai probe. Jika status tetap starting, baca docker logs kirocrew sebelum mengubah apa pun. Pada eksekusi pertama, model embedding diunduh di latar belakang. Pencarian memori menggunakan pencocokan kata kunci hingga model tersebut tersedia.

Menjaga layanan tetap berjalan dengan systemd

restart: unless-stopped menghidupkan kembali container setelah crash dan reboot, selama Docker sendiri berjalan saat boot. Unit file membuat dependensi tersebut eksplisit dan menyediakan satu perintah untuk menghentikan seluruh stack sebelum pencadangan. Menjalankan stack Docker Compose saat boot membahas pola umumnya. Berikut bentuknya untuk KiroCrew, dalam /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 seharusnya menampilkan active (exited). Itu adalah hasil yang sehat untuk unit ini. Type=oneshot dengan RemainAfterExit=yes tepat digunakan di sini karena docker compose up -d mengembalikan hasil segera setelah container dijalankan: systemd melacak bahwa stack sudah aktif, bukan proses foreground. Jika Anda menulis Type=simple, systemd melihat perintah segera selesai, menandai service sebagai mati, lalu menyerah atau masuk ke loop restart, bergantung pada pengaturan Restart=. Untuk instalasi native, proyek ini menyediakan padanannya sendiri, yaitu kirocrew service install, yang menulis /etc/systemd/system/kirocrew.service dan menjalankan gateway sebagai user Anda. Jangan menjalankan kedua unit tersebut. Pembahasan yang lebih luas tentang topik ini tersedia di service dan timer systemd pada VPS. Unit yang gagal aktif kembali tidak akan memberi tahu Anda sampai Anda membuatnya mengirim notifikasi. Tambahkan handler OnFailure= yang mengirimkan peringatan ke server ntfy Anda sendiri, sehingga Anda mengetahui gateway tidak aktif dari ponsel, bukan dari scheduled job yang ternyata tidak pernah berjalan.

Penggunaan pertama: masuk dan dapatkan token dashboard

Container menjalankan gateway, tetapi runtime Kiro CLI default pada image 0.8.0 yang dipatok masih memerlukan autentikasi. Masuk dari dalam container, atau teruskan KIRO_API_KEY melalui environment container untuk penggunaan otomatis:

docker exec -it kirocrew kiro-cli login

Perintah tersebut menampilkan kode perangkat dan URL yang dibuka di browser Anda. Selanjutnya, buat token dashboard:

docker exec kirocrew kirocrew token --ttl 2h

URL dashboard adalah http://localhost:5476/?token=<the token>. Token memiliki masa berlaku: tautan yang ditampilkan harus dibuka dalam lima menit setelah token dibuat. Perintah ini meminta cookie akses yang berlaku selama dua jam, sedangkan dua puluh jam adalah batas maksimum yang didokumentasikan. Browser juga menerima cookie refresh dengan jendela idle bergulir selama 30 hari, sehingga sesi aktif diperbarui tanpa tautan lain. Dashboard yang tampil kosong atau langsung mengeluarkan Anda biasanya menunjukkan token yang sudah kedaluwarsa. Buat token baru dan segera buka tautannya. Jangan pernah menempelkan token ke tiket atau pesan chat, karena siapa pun yang memegangnya dapat mengendalikan agent Anda.

Akses dashboard melalui SSH dan jangan pernah memublikasikan port 5476

Perhatikan kembali alamat bind pada contoh proyek: -p 127.0.0.1:5476:5476. Di dalam container, gateway mendengarkan pada 0.0.0.0 karena harus dapat dijangkau melalui pemetaan port. Namun, pemetaan tersebut hanya memublikasikan port ke loopback pada host. Hapus prefiks 127.0.0.1:, dan gateway akan tersedia di Internet publik bagi siapa pun yang memindai port tersebut. Aturan ufw juga tidak akan melindungi Anda. Docker memublikasikan port dengan menulis aturan DNAT yang merutekan trafik sebelum aturan ufw diterapkan, sehingga ufw deny 5476 tidak berpengaruh pada port yang dipublikasikan. Dengan backend iptables default Docker, cara yang disediakan Docker adalah menempatkan aturan pemfilteran di chain DOCKER-USER miliknya. Cara ini berfungsi, tetapi aturan tersebut melihat alamat dan port internal container kecuali Anda melakukan pencocokan dengan ekstensi conntrack. Karena itu, bind loopback tetap menjadi kontrol yang lebih sederhana dan lebih sulit salah konfigurasi. Backend nftables Docker menggunakan tabel dan base chain nftables terpisah untuk pemfilteran khusus. Docker melewati ufw saat memublikasikan port menjelaskan mekanisme tersebut.

Teruskan port melalui SSH dari laptop Anda:

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

Biarkan sesi tersebut tetap berjalan, lalu buka http://localhost:5476/?token=<the token> secara lokal. Untuk menjalankan penerusan secara otomatis pada setiap koneksi, masukkan konfigurasi tersebut ke dalam ~/.ssh/config:

Host your-server.example.com
    LocalForward 5476 127.0.0.1:5476

Jika port 5476 sudah digunakan di laptop Anda, ubah hanya angka di sisi kiri: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com, lalu buka http://localhost:45476/?token=... di browser. Anda tidak memerlukan pengaturan port loopback tambahan atau pembuatan ulang container. Origin loopback cocok dengan Host milik request itu sendiri, sehingga pemeriksaan CSRF menerimanya. Anda akan menggunakan beberapa penerusan seperti ini ketika agent kedua mulai berbagi server tersebut, karena self-hosting open-kritt untuk pemindaian keamanan menambahkan dashboard lain yang hanya tersedia melalui loopback pada server yang sama, yaitu port 5173.

Dua perilaku yang telah didokumentasikan menentukan pengaturan mana yang dapat diubah dari dashboard. Pertama, gateway menganggap setiap request yang membawa header forwarding (Forwarded, X-Forwarded-*, atau X-Real-IP) sebagai request remote. Endpoint untuk menulis konfigurasi dan mengungkapkan secret menolak request tersebut. Reverse proxy menambahkan header tersebut. Penerusan ssh -L biasa tidak menambahkan header apa pun, sehingga dianggap lokal dan tidak ditolak atas dasar tersebut. Kedua, pada container image, halaman kredensial channel dan tampilan yang mengungkapkan secret bersifat read-only bagi browser mana pun yang tidak terhubung langsung secara lokal. Image tersebut juga tidak menyediakan text editor. Jika kredensial channel tidak dapat disimpan dari dashboard, penyebabnya adalah hal ini, bukan bug. Edit konfigurasi pada host:

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

Untuk akses melalui ponsel, proyek tersebut menyarankan tailscale serve milik Tailscale. Fitur ini menjaga dashboard tetap berada di dalam tailnet Anda sendiri, bukan pada hostname publik. Pilih cara ini daripada reverse proxy publik. Token dikirim di dalam URL, dan URL tersebut ditulis ke setiap access log di sepanjang jalurnya. Aturan ini berkaitan dengan layanan yang berada di balik port, bukan port itu sendiri. Sesuatu seperti Halcyon, yang membangun ulang library Jellyfin menjadi toko video 90-an yang dapat dijelajahi memang dibuat agar dibuka oleh orang lain dan merupakan kandidat yang wajar untuk reverse proxy. Namun, gateway yang dapat menjalankan command di server Anda tidak demikian.

Berikan agen ruang dampak sekecil mungkin

Container memeriksa dukungan sandbox saat pertama kali dijalankan. Hasilnya menentukan apakah agen dapat mengeksekusi sesuatu. Jika isolasi namespace tersedia, subprocess agen berjalan secara terisolasi. Jika tidak tersedia dan KIROCREW_ALLOW_UNSANDBOXED=1 tidak ditetapkan, eksekusi ditolak, bukan dijalankan tanpa isolasi. Karena itu, gateway yang terlihat sehat sementara setiap tugas terhenti biasanya mengalami masalah ini. Keputusan tersebut disimpan di docker logs kirocrew sejak proses pertama dijalankan. Proyek ini juga menyediakan profil seccomp (secure computing mode) yang dapat Anda terapkan:

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

Pada host yang mengaktifkan AppArmor, panduan Docker proyek ini menyebut profil seccomp hanya sebagai separuh perubahan. Docker juga memasang profil AppArmor docker-default dan memasangkannya dengan apparmor=unconfined. Opsi tersebut hanya menonaktifkan aturan AppArmor per-container. Profil seccomp, kapabilitas yang dihapus, dan pengguna non-root tetap berlaku.

Jika Anda menetapkan KIROCREW_ALLOW_UNSANDBOXED=1, pahami dengan jelas perubahan yang terjadi: container kini menjadi satu-satunya batas antara agen dan server Anda. Peringatan dari proyek ini perlu diulangi secara lengkap. Jangan memasang path host yang tidak akan Anda berikan langsung kepada agen. Dalam praktiknya, ini berarti jangan memasang Docker socket, bind mount apa pun dari /, atau direktori yang menyimpan data service lain.

Bagian berikutnya adalah kerangka yang berlaku bagi setiap agen yang diizinkan menjalankan perintah. Batasi kredensialnya pada satu repository atau satu bucket yang diperlukan. Jangan gunakan token pribadi dengan hak akses untuk seluruh akun. Jalankan agen sebagai pengguna khusus yang home directory-nya tidak menyimpan hal lain. Inilah tujuan pengguna dengan hak akses minimum pada VPS. Saat agen menulis kode lalu menjalankan kode tersebut, berikan mesin yang boleh dirusaknya: VM sekali pakai untuk agen coding memberikan batas yang lebih kuat daripada flag apa pun dalam compose file ini, karena Anda dapat menghapusnya alih-alih membersihkannya. Pertimbangan yang sama berlaku untuk menjalankan OpenClaw dengan aman pada VPS dan self-hosting agen Hermes pada VPS. Tool juga termasuk dalam ruang dampak. Memberikan akses web search kepada agen menjadikan setiap halaman yang diambilnya sebagai input yang tidak tepercaya. Karena itu, mengarahkannya ke instance SearXNG milik Anda sendiri merupakan keputusan tentang prompt injection, bukan hanya konfigurasi koneksi. Pekerjaan terjadwal juga dapat menghabiskan biaya saat Anda tidur. Inference pada backend Kiro menggunakan paket Kiro Anda. Karena itu, tetapkan batas yang dijelaskan dalam mengendalikan biaya agen AI pada VPS sebelum menambahkan job yang berjalan setiap malam.

Cadangkan volume state sebelum setiap upgrade

Temukan nama volume sebenarnya terlebih dahulu. Compose menambahkan nama project sebagai awalan pada named volume. Secara default, nama tersebut adalah nama direktori. Jadi, volume yang dideklarasikan sebagai kirocrew-home dalam /opt/kirocrew/compose.yaml dibuat sebagai kirocrew_kirocrew-home:

docker volume ls

Hentikan gateway sebelum menyalin apa pun. memory.db dan memory_index.db adalah database SQLite. Menyalin database saat sedang ditulis dapat merekam transaksi yang belum selesai, sehingga saat dipulihkan file tersebut menjadi rusak. Petunjuk migrasi project juga menyatakan hal yang sama: pindahkan memory hanya saat gateway dihentikan. Aturan untuk menghentikan layanan terlebih dahulu ini tidak khusus untuk KiroCrew. Jika server juga menjalankan server foto, perbandingan PhotoPrism dan Immich berisi perintah pencadangan yang tepat untuk masing-masing aplikasi tersebut.

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

Salin arsip ke luar server. Pemulihan menggunakan perintah yang sama, dengan container dihentikan dan tar xzf menggantikan tar czf:

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

Memindahkan layanan ke host baru berbeda dari memulihkannya di host yang sama. Project ini memiliki ketentuan khusus untuk proses tersebut. Riwayat chat dan catatan project di bawah workspace/memory/ ikut dipindahkan, begitu juga kedua file database dan config.json. File PID, log peristiwa keamanan, dan .env terikat pada host lama. Jangan pindahkan file-file tersebut, lalu masukkan kembali secret pada server baru.

Cara melakukan rollback setelah upgrade yang bermasalah

Upgrade berlangsung singkat dan aman hanya karena Anda menetapkan versi tertentu. Buat backup terlebih dahulu, lalu ubah 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 akan mengambil image jika image tersebut belum ada di server, sehingga perubahan tag merupakan seluruh proses upgrade. Rollback dilakukan dengan urutan yang sama menggunakan nomor versi lama. Dengan demikian, Anda mendapatkan image yang sama persis seperti sebelum upgrade karena tag versi bersifat immutable.

Binary dapat di-rollback dengan baik. Namun, state belum tentu demikian. Gateway yang lebih baru dapat menulis ulang config.json atau memigrasikan database memori ke format yang tidak dapat dibaca oleh gateway versi lama. Hingga 12 October 2026, tidak ada jalur downgrade untuk state yang didokumentasikan. Panduan instalasi menjelaskan satu kasus secara tegas: data yang dipindahkan dari direktori home ~/.kirocrew lama tidak dapat di-rollback, dan release yang lebih lama daripada ~/.kiro/crew akan berjalan dalam keadaan kosong. Jadi, jika image lama berhasil start tetapi kemudian berperilaku tidak semestinya, jangan lakukan debugging. Hentikan image tersebut, pulihkan backup yang dibuat sebelum upgrade, lalu start kembali. Itulah alasan backup dibuat terlebih dahulu, dan itulah sebabnya kebiasaan melakukan upgrade sekarang lalu membuat backup nanti tidak cocok untuk project yang masih sangat baru.

Hal yang belum terbukti di sini

Jujurlah terhadap usia software ini. Versi 0.1.3 dirilis pada 5 August 2026, dan pada 12 October 2026 jalur stabil telah mencapai 0.8.0. Sebagian besar catatan rilis masih berupa changelog otomatis; catatan 0.8.0 ditulis secara manual, tetapi tidak memiliki bagian migrasi, dan riwayat rilis publik baru berlangsung sekitar tiga bulan. Tidak ada hal dalam panduan ini yang merupakan hasil penggunaan jangka panjang. Karena itu, anggap pertumbuhan penggunaan memori, ukuran database, dan keandalan scheduler sebagai hal yang harus Anda ukur pada server sendiri, bukan sebagai hal yang dapat diasumsikan.

Ada dua perilaku yang sebaiknya Anda uji sendiri sebelum mengandalkannya. Pertama, apakah proses downgrade dapat membaca state yang ditulis oleh versi yang lebih baru. Uji pada salinan volume saat kegagalan tidak berdampak, bukan ketika terjadi outage. Kedua, perilaku gateway ketika sesi sign-in Kiro kedaluwarsa saat scheduled job harus dijalankan. Keduanya merupakan jenis masalah kecil yang biasanya diperbaiki secara bertahap oleh proyek yang masih baru di antara dua rilis. Keduanya juga mudah diperiksa sekarang.

FAQ

Mengapa dasbor KiroCrew tidak terbuka pada IP publik server saya?

Karena contoh yang dipublikasikan mengikat port ke loopback. -p 127.0.0.1:5476:5476 hanya memetakan port container ke alamat loopback host, dan ini memang disengaja. Akses melalui port forwarding SSH dengan ssh -N -L 5476:127.0.0.1:5476 you@your-server, lalu buka http://localhost:5476/?token=<token> pada laptop Anda. Menghapus awalan 127.0.0.1: agar layanan dapat diakses dari luar akan menempatkan gateway di Internet publik. ufw tidak akan membatasinya karena aturan DNAT untuk port yang dipublikasikan Docker merutekan trafik sebelum aturan ufw diterapkan. Gunakan chain DOCKER-USER Docker dengan backend iptables-nya, atau base chain nftables terpisah dengan backend nftables-nya, untuk memfilter port yang dipublikasikan. Mempertahankan binding loopback lebih sederhana.

Di mana KiroCrew menyimpan datanya, dan apa yang harus saya cadangkan?

Semua data berada di bawah ~/.kiro/crew, yaitu /home/kirocrew/.kiro/crew di dalam image container, dan KIROCREW_HOME memindahkannya. Cadangkan seluruh direktori atau seluruh volume Docker saat gateway dihentikan. memory.db dan memory_index.db adalah database SQLite. Salinan yang dibuat saat gateway sedang menulis dapat menjadi tidak konsisten. Saat memindahkan layanan ke host baru, workspace/memory/, kedua file database, dan config.json ikut dipindahkan. File PID, log peristiwa keamanan, dan .env tetap terkait dengan host lama.

Sebaiknya saya menggunakan tag stable atau tag versi?

Gunakan tag versi. stable berubah setiap kali rilis diterbitkan. Akibatnya, versi yang Anda jalankan dapat berubah pada pull berikutnya, dan tag tersebut tidak memberi informasi tentang versi yang sedang berjalan. Tag versi seperti 0.8.0 bersifat immutable. Inilah yang memungkinkan rollback: Anda mengembalikan nomor versi lama dan mendapatkan image yang identik. Per 1 November 2026, rilis stabil terbaru adalah 0.11.1.

Mengapa agent saya menolak menjalankan semua perintah?

Container memeriksa dukungan sandbox saat pertama kali dijalankan. Jika container tidak dapat mengisolasi subprocess agent dan KIROCREW_ALLOW_UNSANDBOXED=1 tidak ditetapkan, container menolak mengeksekusinya alih-alih menjalankannya tanpa pembatasan. Akibatnya, gateway terlihat sehat, tetapi setiap tugas berhenti. docker logs kirocrew menampilkan keputusan sandbox dari proses pertama tersebut. Menetapkan variabel ini menjadikan container satu-satunya batas antara agent dan host. Jika Anda menetapkannya, jangan mount apa pun yang tidak akan Anda serahkan langsung kepada agent.

Apakah saya memerlukan akun Kiro untuk melakukan self-hosting KiroCrew?

Untuk backend Kiro, ya, per 1 November 2026. KiroCrew adalah perangkat lunak gratis di bawah lisensi Apache 2.0, tetapi inferensi pada backend tersebut menggunakan paket Kiro Anda. Container 0.8.0 yang dipin menggunakan Kiro CLI. Jalankan docker exec -it kirocrew kiro-cli login dan setujui kode perangkat di browser Anda, atau teruskan KIRO_API_KEY melalui environment container untuk penggunaan otomatis. Sebelum autentikasi dikonfigurasi, gateway tetap berjalan dan dasbor dapat dimuat, tetapi harness default-nya tidak memiliki model untuk diajak berkomunikasi. Sejak 0.10.0, tersedia juga engine KAS bawaan yang tidak memerlukan kiro-cli terpasang. 0.11.0 menjadikan KAS sebagai default untuk instalasi baru yang tidak memiliki pilihan harness tersimpan, sekaligus mempertahankan pilihan Kiro CLI yang ditetapkan secara eksplisit. KAS menggunakan proses sign-in milik Crew, bukan kiro-cli login. Panduan backend kustom proyek memungkinkan harness claude mengirim giliran utama model ke endpoint yang kompatibel dengan Anthropic dan Anda pilih, tetapi proses sign-in kiro-cli tetap diperlukan untuk fitur khusus Kiro.

Apakah artikel ini bermanfaat?