Self-host KiroCrew trên VPS, chạy agent 24/7
Chạy KiroCrew trong container cố định trên VPS để giữ memory và lịch sau reboot. Dùng Docker, systemd, SSH, backup và rollback khi upgrade lỗi.
Thỏa thuận để tự host KiroCrew trên VPS thay vì laptop
Tự host KiroCrew chỉ có ích trên một máy không bao giờ ngủ, vì vậy VPS là nơi phù hợp còn laptop thì không. KiroCrew lưu lịch sử session, bộ nhớ ngữ nghĩa, các job đã lên lịch và hàng đợi phê duyệt trên ổ đĩa, rồi nạp lại toàn bộ khi process khởi động lại. Những dữ liệu này không có tác dụng nếu process không chạy lúc 03:00, khi đến hạn một job đã lên lịch; laptop đã đóng thì cũng không chạy process đó.
KiroCrew là một agent workspace mã nguồn mở của đội Kiro, được cấp phép theo Apache 2.0, với 0.1.0 được phát hành vào 22 July 2026. Một process duy nhất, gọi là gateway, quản lý state và cung cấp web dashboard trên port 5476. Bạn truy cập gateway đó từ dashboard, từ kirocrew CLI hoặc từ một kênh chat như Slack. Gateway là thành phần duy nhất bạn tự host, nên hướng dẫn này tập trung vào việc giữ cho nó luôn chạy, không để nó trên public Internet và có thể khôi phục nó sau một lần nâng cấp lỗi.
Có hai điều cần biết trước khi bắt đầu. Kể từ 0.11.0, các bản cài KiroCrew mới không có lựa chọn harness đã lưu sẽ mặc định dùng KAS mà không cần kiro-cli; các lựa chọn Kiro CLI được chỉ định rõ từ trước vẫn được giữ nguyên. Inference trên các backend Kiro sử dụng gói Kiro của bạn, vì vậy tính đến 1 November 2026, cấu hình mặc định này không chạy offline. Project cũng còn mới và thay đổi nhanh: các bản stable release tăng từ 0.1.3 vào 5 August 2026 lên 0.10.0 vào 25 October 2026, với 0.8.0 vào 9 October và 0.9.0 vào 16 October ở giữa, đồng thời một 0.11.0 release candidate đã được phát hành dưới dạng pre-release vào 25 October. Hãy giả định rằng đến một lúc nào đó bạn sẽ cần rollback, và cài đặt theo cách cho phép bạn thực hiện việc đó. Nếu bạn chưa từng chạy agent trên server, chạy coding agent trên VPS sẽ trình bày các nguyên tắc cơ bản mà hướng dẫn này dựa trên. Nếu phần agent còn mới với bạn hơn phần server, trước tiên hãy tìm hiểu agent loop, các tool và memory của nó thực sự là gì để các lựa chọn dưới đây được hiểu như các quyết định thay vì những câu lệnh khó hiểu.
KiroCrew cần gì và state nằm ở đâu
Cài native cần Python 3.12 trở lên và Node.js 22.12.0 trở lên nếu bạn build dashboard từ source (project khuyến nghị Node 24 LTS). Backend Kiro CLI cần kiro-cli, được xác thực bằng kiro-cli login hoặc API key khi dùng tự động; từ 0.10.0, engine KAS tích hợp sẵn chạy mà không cần cài kiro-cli, và 0.11.0 đã đặt engine này làm mặc định cho các lần cài mới nếu chưa có lựa chọn harness được lưu. Cài bằng container không cần các thành phần đó trên host. Bạn chỉ cần Docker. Đây là lý do chính để ưu tiên cách cài này.
State nằm trong ~/.kiro/crew, và biến môi trường KIROCREW_HOME cho phép chuyển state sang vị trí khác. Bên trong có:
config.json: cấu hình gateway và credential của các kênh chat..env: secret.workspace/memory/: tùy chọn, ghi chú project và lịch sử chat.memory.dbvàmemory_index.db: semantic index và full-text index.models/: embedding model, được tải xuống trong lần chạy đầu tiên.security_events.jsonl: security event log.
Thư mục đó chính là bản cài đặt. Sao chép nó sang một VPS mới là bạn đã chuyển toàn bộ agent, vì vậy phần backup bên dưới quan trọng hơn phần cài đặt.
Hãy tính dung lượng disk thay vì RAM. Gateway là một tiến trình Python; thứ thực sự làm máy chủ chịu tải là những gì agent chạy, chẳng hạn một bản build hoặc test suite. Thư mục state tăng theo lịch sử chat, còn embedding model được tải trong lần khởi động đầu tiên. Vì vậy, sau vài tuần hãy dùng du -sh ~/.kiro/crew để đo trực tiếp trên máy của bạn, thay vì tin vào một con số được công bố trong những tháng đầu của một project. Điều này khác với runtime cấp cho mỗi worker một container và một browser riêng; với việc self-hosting các AI coworker của OpenBot, bạn phải tính RAM trước khi tính disk.
Nên dùng cách cài đặt nào trong bốn cách
Dự án cung cấp bốn cách: desktop app, one-line wheel, source và Docker. Trình cài đặt one-line tải một wheel và tạo launcher kirocrew; nếu thư mục chứa launcher không nằm trong PATH, trình cài đặt sẽ in hướng dẫn để thêm thư mục đó:
curl -fsSL https://download.crew.kiro.dev/cli.sh | shTrình cài đặt nhận flag channel và flag version:
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --channel insider
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --version 0.8.0Container image được publish tại ghcr.io/kirodotdev/kirocrew, cho linux/amd64 và linux/arm64 ở mọi tag. Cách build từ source cần git clone cùng với make build và dành cho người thay đổi code, không dành cho người chỉ chạy ứng dụng.
Hãy dùng container. Cài native từ source sẽ đặt các package Python và Node trên cùng host đang chạy các service khác của bạn, cùng với kiro-cli khi dùng backend Kiro CLI. Nếu quá trình upgrade gặp lỗi, bạn sẽ phải tự gỡ các thay đổi đó. Container giữ runtime trong một image và state trong một volume. Nhờ vậy, rollback chỉ cần đổi tag rồi restart.
Ghim image vào release tag, không dùng stable
Ví dụ của chính dự án sử dụng tag stable:
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stablestable là một moving tag, latest cũng vậy và trỏ đến cùng một release. Tag này trỏ đến release stable mới nhất tại thời điểm đó. Vì vậy, lần pull tiếp theo có thể thay đổi version đang chạy mà bạn không chủ động chọn, đồng thời tag không cho biết đó là version nào. Version tag là immutable, nên hãy pin vào một version cụ thể. Release stable mới nhất tính đến ngày 1 November 2026 là 0.11.1, được phát hành ngày 31 October 2026, là hot patch để sửa lỗi memory integrity và KAS trong 0.11.0. Ví dụ 0.8.0 bên dưới sử dụng Kiro CLI. Ngoài ra còn có tag insider và nightly; nightly bám theo các build từ main.
Ghi /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:Khởi động container, sau đó kiểm tra health endpoint mà image cũng dùng cho HEALTHCHECK của chính nó:
cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/healthdocker compose ps sẽ báo container ở trạng thái healthy trong khoảng một phút. /api/health trả lời mà không cần token; /api/live và /api/ready cũng vậy, nên có thể dùng chúng làm probe. Nếu trạng thái vẫn là starting, hãy đọc docker logs kirocrew trước khi thay đổi bất kỳ thứ gì. Lần chạy đầu tiên sẽ tải embedding model ở chế độ background. Chức năng tìm kiếm memory sẽ dùng keyword matching cho đến khi model được tải xong.
Giữ gateway chạy bằng systemd
restart: unless-stopped sẽ khởi động lại container sau khi bị crash và sau khi reboot, miễn là Docker tự khởi động cùng hệ thống. Unit file làm rõ dependency này và cung cấp một lệnh để dừng toàn bộ stack trước khi backup. Khởi động Docker Compose stack khi boot trình bày mẫu triển khai chung. Với KiroCrew, cấu hình có dạng như sau trong /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.targetsudo systemctl daemon-reload
sudo systemctl enable --now kirocrew
systemctl status kirocrewsystemctl status kirocrew phải hiển thị active (exited). Đây là kết quả bình thường của unit này. Việc dùng Type=oneshot cùng với RemainAfterExit=yes là đúng trong trường hợp này vì docker compose up -d trả về ngay sau khi container được khởi động: systemd theo dõi trạng thái stack đã chạy, không theo dõi một tiến trình foreground. Nếu thay bằng Type=simple, systemd sẽ thấy lệnh thoát ngay, đánh dấu service đã dừng, rồi hoặc bỏ cuộc hoặc restart liên tục tùy theo thiết lập Restart=. Với bản cài native, project cung cấp thành phần tương đương là kirocrew service install. Thành phần này ghi /etc/systemd/system/kirocrew.service và chạy gateway bằng user của bạn. Không chạy đồng thời cả hai unit. Nội dung mở rộng về chủ đề này có trong service và timer của systemd trên VPS. Unit không khởi động lại được sẽ không phát tín hiệu nếu bạn không cấu hình, vì vậy hãy thêm handler OnFailure= để đẩy cảnh báo đến ntfy server của bạn. Khi đó, bạn sẽ biết gateway đã dừng qua điện thoại thay vì phát hiện qua một scheduled job chưa từng chạy.
Lần chạy đầu tiên: đăng nhập và lấy token dashboard
Container khởi động gateway, nhưng runtime Kiro CLI mặc định trong image 0.8.0 được pin vẫn cần xác thực. Đăng nhập bên trong container hoặc truyền KIRO_API_KEY qua environment của container để dùng tự động:
docker exec -it kirocrew kiro-cli loginLệnh này in ra device code và một URL. Mở URL đó trong trình duyệt của bạn. Sau đó tạo token dashboard:
docker exec kirocrew kirocrew token --ttl 2hURL của dashboard là http://localhost:5476/?token=<the token>. Token sẽ hết hạn: phải mở link được in ra trong vòng năm phút kể từ lúc tạo token. Lệnh này yêu cầu cookie truy cập có thời hạn hai giờ; thời hạn tối đa được ghi nhận là hai mươi giờ. Trình duyệt cũng nhận một refresh cookie với thời gian chờ không hoạt động là 30 ngày. Vì vậy, session đang hoạt động sẽ tự gia hạn mà không cần link mới. Nếu dashboard tải trang trống hoặc ngay lập tức đưa bạn quay lại trang đăng nhập, nguyên nhân thường là token đã hết hạn. Hãy tạo token mới và mở ngay. Không bao giờ dán token vào ticket hoặc tin nhắn chat, vì ai giữ token thì người đó kiểm soát agent của bạn.
Truy cập dashboard qua SSH và không bao giờ public port 5476
Xem lại địa chỉ bind trong ví dụ của project: -p 127.0.0.1:5476:5476. Bên trong container, gateway lắng nghe trên 0.0.0.0 vì nó phải có thể truy cập qua port mapping, nhưng mapping chỉ public ra loopback trên host. Xóa tiền tố 127.0.0.1: là gateway sẽ nằm trên public Internet và bất kỳ ai scan port đó cũng có thể truy cập. Rule của ufw cũng không bảo vệ được bạn: Docker public port bằng cách ghi các rule DNAT để định tuyến traffic trước khi các rule của ufw được áp dụng, vì vậy ufw deny 5476 không có tác dụng với port đã được public. Với iptables backend mặc định của Docker, cách xử lý của Docker là đặt rule filtering trong chain DOCKER-USER. Cách này hoạt động, nhưng các rule đó thấy địa chỉ và port nội bộ của container nếu không match bằng conntrack extension. Vì vậy, bind vào loopback vẫn là cách kiểm soát đơn giản hơn và khó cấu hình sai hơn. nftables backend của Docker thay vào đó dùng các nftables table và base chain riêng cho custom filtering. Docker bỏ qua ufw khi public port giải thích cơ chế này.
Forward port qua SSH từ laptop của bạn:
ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.comGiữ session đó chạy và mở http://localhost:5476/?token=<the token> trên máy local. Để tự động tạo forward trong mỗi lần kết nối, thêm nó vào ~/.ssh/config:
Host your-server.example.com
LocalForward 5476 127.0.0.1:5476Nếu port 5476 đã được dùng trên laptop, chỉ đổi số bên trái: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com, rồi truy cập http://localhost:45476/?token=.... Không cần thêm cấu hình loopback-port hoặc tạo lại container: Origin loopback khớp với Host của chính request, nên kiểm tra CSRF chấp nhận request đó. Bạn sẽ dùng nhiều forward kiểu này ngay khi agent thứ hai dùng chung máy, vì tự host open-kritt để quét bảo mật tạo thêm một dashboard chỉ bind loopback trên cùng server, tại port 5173.
Hai hành vi được tài liệu hóa quyết định những setting nào bạn có thể thay đổi từ dashboard. Thứ nhất, gateway xem mọi request có forwarding header (Forwarded, X-Forwarded-* hoặc X-Real-IP) là request remote, đồng thời từ chối các request đó tại endpoint ghi cấu hình và endpoint hiển thị secret. Reverse proxy thêm các header này; forward ssh -L thông thường không thêm header nào, nên gateway xem request là local và không từ chối vì lý do đó. Thứ hai, trong container image, các trang thông tin xác thực channel và các view hiển thị secret chỉ read-only với browser không kết nối trực tiếp từ local, đồng thời image không có text editor. Nếu thông tin xác thực channel không thể lưu từ dashboard thì đây là hành vi dự kiến, không phải bug. Hãy sửa config trên host thay vì sửa trong dashboard:
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Để truy cập bằng điện thoại, project hướng dẫn dùng tailscale serve của Tailscale. Cách này giữ dashboard bên trong tailnet của riêng bạn thay vì đưa lên hostname public. Hãy ưu tiên cách này thay cho reverse proxy public. Token nằm trong URL, và URL sẽ được ghi vào mọi access log trên đường đi của request. Quy tắc này liên quan đến dịch vụ nằm sau port, không phải bản thân port: một dịch vụ như Halcyon, dịch vụ dựng lại thư viện Jellyfin thành một video store thập niên 90 có thể duyệt được tạo ra để người khác truy cập và là ứng viên phù hợp cho reverse proxy, còn gateway có thể chạy command trên server thì không.
Cấp cho agent phạm vi ảnh hưởng nhỏ nhất có thể
Container sẽ kiểm tra khả năng hỗ trợ sandbox ở lần khởi động đầu tiên. Kết quả này quyết định agent có được phép thực thi hay không. Nếu có isolation bằng namespace, các subprocess của agent sẽ chạy trong môi trường được cô lập. Nếu không có và KIROCREW_ALLOW_UNSANDBOXED=1 chưa được đặt, hệ thống sẽ từ chối thực thi thay vì chạy không giới hạn. Vì vậy, nếu gateway có vẻ hoạt động bình thường nhưng mọi task đều bị treo thì nguyên nhân thường là đây. Quyết định này được ghi trong docker logs kirocrew từ lần chạy đầu tiên. Project cũng cung cấp profile seccomp (secure computing mode) mà bạn có thể áp dụng:
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.jsonTrên host đã bật AppArmor, Docker guide của project xem profile seccomp mới chỉ là một nửa thay đổi. Docker còn gắn profile AppArmor docker-default và dùng kèm apparmor=unconfined. Tùy chọn đó chỉ gỡ các rule theo từng container của AppArmor. Profile seccomp, các capability bị loại bỏ và user không phải root vẫn được áp dụng.
Nếu bạn đặt KIROCREW_ALLOW_UNSANDBOXED=1, hãy hiểu rõ thay đổi đã xảy ra: container giờ là boundary duy nhất giữa agent và server của bạn. Cảnh báo của project đáng được nhắc lại đầy đủ. Không mount các path trên host mà bạn không sẵn sàng giao trực tiếp cho agent. Trên thực tế, điều đó loại trừ Docker socket, mọi bind mount của / và mọi thư mục chứa dữ liệu của service khác.
Phần còn lại là các nguyên tắc áp dụng cho mọi agent được phép chạy command. Giới hạn credential của nó vào đúng một repository hoặc một bucket cần dùng. Không bao giờ dùng personal token có quyền trên toàn bộ account. Chạy agent bằng một user riêng, có home không chứa dữ liệu khác. Đây là mục đích của user có quyền tối thiểu trên VPS. Khi agent ghi code rồi chạy code đó, hãy cung cấp cho nó một máy mà nó được phép làm hỏng: VM tạm thời cho coding agent là boundary mạnh hơn mọi flag trong compose file này, vì bạn chỉ cần xóa VM thay vì dọn dẹp. Cùng cách suy luận đó áp dụng cho chạy OpenClaw an toàn trên VPS và tự host agent Hermes trên VPS. Tool cũng tạo ra blast radius: khi cấp cho agent khả năng tìm kiếm web, mọi trang nó tải về đều trở thành input không đáng tin cậy. Vì vậy, trỏ agent đến instance SearXNG của bạn cũng là một quyết định về prompt injection, không chỉ là vấn đề kết nối. Tác vụ theo lịch cũng tiêu tiền khi bạn đang ngủ, vì inference trên các backend Kiro sử dụng Kiro plan của bạn. Do đó, hãy đặt các giới hạn được mô tả trong kiểm soát chi phí của AI agent trên VPS trước khi thêm job chạy hằng đêm.
Sao lưu state volume trước mỗi lần nâng cấp
Trước tiên, hãy tìm đúng tên volume. Compose thêm tên project vào tên các named volume. Tên project mặc định là tên thư mục. Vì vậy, volume khai báo là kirocrew-home trong /opt/kirocrew/compose.yaml sẽ được tạo thành kirocrew_kirocrew-home:
docker volume lsDừng gateway trước khi sao chép. memory.db và memory_index.db là các database SQLite. Sao chép database trong lúc đang được ghi có thể lấy phải một transaction chưa ghi xong, khiến file bị lỗi sau khi restore. Hướng dẫn migration của project cũng nêu đúng điều này: chỉ di chuyển memory khi các gateway đã dừng. Quy tắc dừng trước này không chỉ áp dụng cho KiroCrew. Nếu một photo server dùng chung máy, bài so sánh PhotoPrism và Immich có các lệnh backup chính xác mà từng ứng dụng cần.
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 kirocrewChuyển archive ra khỏi máy chủ. Restore dùng cùng lệnh đó, với container đã dừng và tar xzf thay cho 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 kirocrewChuyển sang host mới là một công việc khác với restore tại chỗ, và project có hướng dẫn cụ thể cho việc này. Lịch sử chat và ghi chú project trong workspace/memory/ sẽ được chuyển sang, cùng với 2 file database và config.json. Các file PID, security event log và .env gắn với host cũ, nên không chuyển chúng sang. Hãy nhập lại các secret trên máy chủ mới.
Cách rollback một lần upgrade lỗi
Upgrade nhanh và chỉ an toàn vì bạn đã pin version. Trước tiên hãy tạo backup, sau đó đổi tag:
sudo systemctl stop kirocrew
# take the backup here, as above
sudo nano /opt/kirocrew/compose.yaml # set the new image tag
sudo systemctl start kirocrew
docker compose -f /opt/kirocrew/compose.yaml ps
curl -s http://127.0.0.1:5476/api/healthdocker compose up -d sẽ pull image nếu image đó chưa có trên máy, nên sửa tag là toàn bộ quy trình upgrade. Rollback cũng dùng đúng trình tự đó với số version cũ. Bạn sẽ nhận lại chính xác image đã dùng trước đó vì các version tag là immutable.
Binary rollback sạch sẽ. Phần state mới có thể gây vấn đề. Gateway mới hơn có thể ghi lại config.json hoặc migrate các memory database sang cấu trúc mà gateway cũ không đọc được. Tính đến ngày 12 October 2026, chưa có tài liệu về đường dẫn downgrade cho state. Install guide nêu rõ một trường hợp: dữ liệu đã được chuyển khỏi thư mục home ~/.kirocrew legacy thì không thể rollback, và release cũ hơn ~/.kiro/crew sẽ khởi động với dữ liệu rỗng. Vì vậy, nếu image cũ khởi động nhưng hoạt động bất thường, đừng debug. Hãy stop nó, restore backup đã tạo trước khi upgrade, rồi khởi động lại. Đó là toàn bộ lý do backup phải được thực hiện trước, và cũng là lý do thói quen upgrade trước rồi backup sau sẽ thất bại với một project còn mới như vậy.
Những điều chưa được kiểm chứng
Hãy trung thực về tuổi đời của phần mềm này. Phiên bản 0.1.3 được phát hành vào ngày 5 tháng 8 năm 2026, và đến ngày 12 tháng 10 năm 2026, nhánh stable đã đạt tới 0.8.0. Hầu hết các ghi chú phát hành vẫn là changelog tự động; các ghi chú 0.8.0 được viết tay nhưng không có phần hướng dẫn chuyển đổi, và lịch sử phát hành công khai chỉ mới kéo dài khoảng ba tháng. Không có gì trong hướng dẫn này là kết quả của quá trình vận hành lâu dài, vì vậy hãy coi việc tăng trưởng bộ nhớ, kích thước database và độ tin cậy của scheduler là những thứ cần tự đo đạc trên máy chủ của bạn thay vì mặc định tin tưởng.
Có hai hành vi đáng để bạn tự kiểm tra trước khi phụ thuộc vào chúng. Thứ nhất, liệu việc downgrade có đọc được dữ liệu do phiên bản mới hơn ghi hay không: hãy thử trên một bản sao của volume khi chưa có sự cố, đừng thử trong lúc hệ thống đang ngừng hoạt động. Thứ hai, gateway sẽ xử lý thế nào khi phiên đăng nhập Kiro hết hạn trong lúc một tác vụ theo lịch trình đến hạn thực thi. Cả hai đều là những điểm chưa hoàn thiện mà một dự án non trẻ thường âm thầm khắc phục giữa các bản phát hành, và cả hai đều rất dễ để kiểm tra ngay bây giờ.
FAQ
Vì sao dashboard KiroCrew không mở được bằng public IP của server?
Vì ví dụ được cung cấp bind cổng vào loopback. -p 127.0.0.1:5476:5476 chỉ map cổng của container vào địa chỉ loopback của host; đây là chủ ý thiết kế. Hãy truy cập bằng cách forward cổng qua SSH với ssh -N -L 5476:127.0.0.1:5476 you@your-server, sau đó mở http://localhost:5476/?token=<token> trên laptop. Xóa tiền tố 127.0.0.1: để cho phép truy cập từ bên ngoài sẽ đưa gateway lên public internet. ufw sẽ không ngăn được lưu lượng này vì các rule DNAT của Docker cho published port định tuyến lưu lượng trước khi các rule của ufw được áp dụng. Dùng chain DOCKER-USER của Docker với iptables backend, hoặc các base chain nftables riêng với nftables backend, để lọc published port. Giữ bind loopback là cách đơn giản hơn.
KiroCrew lưu dữ liệu ở đâu và tôi nên backup những gì?
Toàn bộ dữ liệu nằm dưới ~/.kiro/crew, tương ứng với /home/kirocrew/.kiro/crew bên trong container image, và KIROCREW_HOME dùng để di chuyển vị trí này. Hãy backup toàn bộ thư mục hoặc toàn bộ Docker volume khi gateway đã dừng. memory.db và memory_index.db là các database SQLite, nên bản sao được tạo trong lúc gateway đang ghi dữ liệu có thể không nhất quán. Khi chuyển sang host mới, workspace/memory/, hai file database và config.json sẽ được chuyển theo. PID file, security event log và .env thuộc về host cũ.
Tôi nên dùng tag stable hay tag phiên bản?
Hãy dùng tag phiên bản. stable thay đổi mỗi khi có release mới, nên phiên bản đang chạy có thể tự thay đổi ở lần pull tiếp theo. Bản thân tag cũng không cho biết image nào đang chạy. Các tag phiên bản như 0.8.0 là bất biến. Đây chính là điều giúp rollback hoạt động: bạn đặt lại số phiên bản cũ và nhận đúng image trước đó. Tính đến 1 November 2026, release ổn định mới nhất là 0.11.1.
Vì sao agent từ chối chạy mọi command?
Container kiểm tra khả năng hỗ trợ sandbox ở lần khởi động đầu tiên. Nếu không thể cô lập các subprocess của agent và KIROCREW_ALLOW_UNSANDBOXED=1 chưa được thiết lập, container sẽ từ chối thực thi thay vì chạy chúng không bị giới hạn. Vì vậy gateway vẫn có vẻ khỏe mạnh nhưng mọi task đều bị treo. docker logs kirocrew hiển thị quyết định về sandbox từ lần chạy đầu tiên đó. Việc thiết lập biến này khiến container trở thành ranh giới duy nhất giữa agent và host. Vì vậy, nếu thiết lập biến, đừng mount bất kỳ thứ gì mà bạn không sẵn sàng cấp trực tiếp cho agent.
Tôi có cần tài khoản Kiro để tự host KiroCrew không?
Có, đối với các Kiro backend, tính đến 1 November 2026. KiroCrew là phần mềm tự do theo giấy phép Apache 2.0, nhưng việc inference trên các backend đó sử dụng Kiro plan của bạn. Container 0.8.0 đã pin sử dụng Kiro CLI: chạy docker exec -it kirocrew kiro-cli login và phê duyệt device code trong browser, hoặc truyền KIRO_API_KEY qua môi trường của container để tự động hóa. Trước khi cấu hình authentication, gateway vẫn khởi động và dashboard vẫn tải được, nhưng harness mặc định không có model để kết nối. Kể từ 0.10.0, KiroCrew cũng có engine KAS tích hợp và không cần cài kiro-cli; 0.11.0 đặt KAS làm mặc định cho các lần cài mới không có lựa chọn harness đã lưu, đồng thời vẫn giữ nguyên các lựa chọn Kiro CLI được chỉ định rõ ràng. KAS sử dụng quy trình đăng nhập riêng của Crew thay vì kiro-cli login. Hướng dẫn custom backend của dự án cho phép harness claude gửi các lượt xử lý model chính đến endpoint tương thích với Anthropic do bạn chọn, nhưng quy trình đăng nhập kiro-cli vẫn cần cho các tính năng dành riêng cho Kiro.