Tự host LiveContext: 7 container, cần 8 GB RAM
LiveContext CE chạy stack Docker Compose 7 container, backend Java và cần khoảng 8 GB RAM. Xem cách pin version, dùng Traefik và backup cả hai store.
LiveContext là gì và chi phí vận hành
Để tự host LiveContext, bạn cần một VPS có khoảng 8 GB RAM. LiveContext CE là nền tảng tự động hóa source-available, chạy các AI agent bên trong chính hệ thống tự động hóa. Nền tảng này được đóng gói dưới dạng một Docker Compose stack gồm 7 container, xây dựng trên backend Java; trong đó có một job chạy một lần rồi thoát sau khi thiết lập xong. Tài liệu self-hosting của nhà cung cấp yêu cầu tối thiểu 4 GB và khuyến nghị 8 GB. README của npm launcher hiện yêu cầu tối thiểu 6 GB. File compose cho thấy lượng RAM được sử dụng vào đâu.
Dự án được công bố dưới dạng livecontext-ai/livecontext-ce trên GitHub theo AGPL-3.0, nhưng CE hiện không còn dùng AGPL. Bản release hiện tại đi kèm LiveContext Sustainable Use License 1.1, một giấy phép source-available cho phép bạn chạy và sửa đổi CE, kể cả trong môi trường production trong doanh nghiệp của mình. Tuy nhiên, giấy phép này cấm cung cấp CE cho bên thứ ba dưới dạng hosted hoặc embedded để cạnh tranh với các phiên bản trả phí của LiveContext. npm launcher của nhà cung cấp cho thấy thay đổi này: livecontext@0.2.11 khai báo AGPL-3.0-only, còn livecontext@0.3.8 trỏ đến file giấy phép đó. Tính đến ngày 13 October 2026, repository GitHub và tổ chức livecontext-ai đều trả về 404, dù tài liệu của nhà cung cấp vẫn yêu cầu bạn clone repository. Vì vậy, guide này lấy các file release từ npm package. Bản release hiện tại là v0.3.8, được publish vào ngày 9 October 2026. Mọi LiveContext image chỉ được build cho linux/amd64, nên không thể dùng các gói Arm giá rẻ. Guide này pin tag đó, đặt stack phía sau reverse proxy và chuyển hướng dẫn backup của upstream thành các command.
Định cỡ VPS trước khi tự host LiveContext
Hầu hết service trong file compose được phát hành đều có giới hạn memory rõ ràng, nên bạn có thể định cỡ máy trước khi thuê. Có 2 service không có giới hạn: job chạy một lần minio-init và frontend. Đây là các giới hạn được ghi trong file compose v0.3.8, không phải mức sử dụng đo được.
Dữ liệu đằng sau biểu đồ này
[
{
"label": "livecontext (backend)",
"memory_limit_mb": 2048
},
{
"label": "bridge",
"memory_limit_mb": 512
},
{
"label": "postgres",
"memory_limit_mb": 512
},
{
"label": "redis",
"memory_limit_mb": 384
},
{
"label": "minio",
"memory_limit_mb": 256
},
{
"label": "websearch (optional)",
"memory_limit_mb": 2048
},
{
"label": "searxng (optional)",
"memory_limit_mb": 512
},
{
"label": "renderer (optional)",
"memory_limit_mb": 1024
}
]Chỉ riêng backend đã bị giới hạn ở 2048 MB. Giới hạn này áp dụng cho một tiến trình Java 21 có heap được đặt ở mức 1 GiB (-Xmx1024m với ZGC). Comment trong file compose cũng nói heap sẽ tăng đến đủ 1 GiB đó, chưa tính overhead riêng của JVM. 5 service nền có giới hạn cộng lại khoảng 3.6 GB. Frontend không có giới hạn nên sẽ dùng lượng memory mà Node yêu cầu. Trên VPS 4 GB, chỉ riêng các giới hạn này đã để lại vài trăm MB cho frontend, kernel và page cache. Vì vậy README của launcher hiện đặt mức tối thiểu là 6 GB, dù tài liệu self-hosting vẫn ghi 4 GB.
Các profile tùy chọn là lý do cần VPS 8 GB. Profile browser agent thêm một container Chromium có giới hạn 2048 MB, cùng với một instance tìm kiếm SearXNG. Profile renderer thêm 1024 MB nữa để tạo screenshot và PDF. Cả 2 profile đều không khởi động nếu bạn chưa enable, nên hãy để chúng tắt cho đến khi cần. Container Chromium được build cục bộ từ một thư mục websearch-service mà npm package không ship kèm. Vì vậy, khi GitHub không thể truy cập, browser agent profile không thể được build từ các file đã phát hành tính đến ngày 13 October 2026. Renderer dùng image đã phát hành nên không bị ảnh hưởng. Container SearXNG tồn tại để làm search backend cho agent. Do đó, các trang mà nó trả về sẽ xuất hiện trong prompt của bạn dưới dạng text không đáng tin cậy. Đây là trust boundary mà việc cấp quyền tìm kiếm web SearXNG cho AI agent hoạt động qua, như được trình bày chi tiết.
Nếu bạn đang chạy n8n, hãy lên kế hoạch thay thế nó thay vì chạy thêm. Stack trong hướng dẫn chạy n8n trên VPS với Docker và HTTPS của chúng tôi gồm một tiến trình Node chạy cùng Postgres và hoạt động ổn định trên một máy nhỏ. Chỉ riêng backend của LiveContext đã cần nhiều tài nguyên hơn toàn bộ stack đó. 2 nền tảng automation trên cùng một VPS 8 GB sẽ vẫn chạy được cho đến khi cả 2 cùng chạy job trong cùng một phút. Nếu dùng chung một host, hãy đặt giới hạn rõ ràng cho mọi service khác bằng phương pháp trong bài viết về cách đặt giới hạn memory trong Docker Compose của chúng tôi. Như vậy, một workflow chạy mất kiểm soát sẽ không kéo cả máy xuống theo.
Cài đặt LiveContext bằng Docker Compose, cố định theo tag
Bắt đầu với một Ubuntu 24.04 VPS mới, đã cài Docker Engine 24 trở lên và Compose v2. Nếu Docker chưa được cài, trước tiên hãy làm theo hướng dẫn cơ bản về Docker Compose cho VPS của chúng tôi, rồi quay lại đây.
README của launcher cung cấp npx livecontext@latest để khởi động bằng một dòng lệnh. Cách này phù hợp trên laptop, nhưng launcher sẽ chép lại file compose trong mỗi lần chạy và các image mà nó chỉ định đều được gắn tag latest. Trên server, bạn nên đặt file compose trong một thư mục do mình quản lý và cố định theo một bản release, để khi nâng cấp có thể diff file. Tài liệu của vendor vẫn hướng dẫn dùng git clone của repository trên GitHub cho việc này, nhưng repository đó trả về 404 tính đến ngày 13 October 2026. Vì vậy, hãy lấy cùng 2 file, file compose và file env mẫu, từ npm package của bản release bạn muốn dùng.
sudo apt update && sudo apt install -y npm
npm view livecontext version
mkdir -p ~/livecontext-ce/docker ~/livecontext-ce/catalog-seeds
cd ~/livecontext-ce
npm pack livecontext@0.3.8
tar xzf livecontext-0.3.8.tgz
cp package/assets/docker-compose.yml .
cp package/assets/.env.example docker/.env.ce
chmod 600 docker/.env.ceFile compose bind-mount ./catalog-seeds vào backend, nên thư mục này được tạo ở bước trên. npm launcher sẽ tải một bundle model catalog và điền vào thư mục khi khởi động. Stack sẽ khởi động với thư mục này đang trống.
File compose trong npm package gắn tag latest cho mọi LiveContext image, chẳng hạn ghcr.io/livecontext-ai/livecontext-ce:latest, dù comment ở đầu file nói rằng tag đã được cố định theo bản release. Hãy tự cố định tag trước lần khởi động đầu tiên. Vendor phát hành các tag của cùng bản release trên Docker Hub trong namespace livecontext. Tính đến ngày 13 October 2026, v0.3.8 được liệt kê cho các image backend, frontend, bridge và renderer, nên hãy trỏ 4 image vào đó:
sed -i -E 's#ghcr\.io/livecontext-ai/(livecontext-ce[a-z-]*):latest#livecontext/\1:v0.3.8#' docker-compose.yml
grep -n 'image:' docker-compose.ymlLấy file compose từ cùng bản release với các image giúp 2 thành phần này tương thích với nhau, vì file compose cho v0.3.8 được viết để chạy với các image đó. Không để các tag ở latest. Tag latest có thể thay đổi mà bạn không biết, và backend chạy database migration trong mỗi lần khởi động. Vì vậy, một lần pull ngoài ý muốn có thể nâng schema vào lúc 3 giờ sáng mà không có cách quay lại ngoài việc restore.
Chỉnh sửa docker/.env.ce trước lần khởi động đầu tiên (phần tiếp theo liệt kê các mục cần thay đổi), rồi khởi động stack.
docker compose --env-file docker/.env.ce up -d
docker compose --env-file docker/.env.ce psDùng cùng flag --env-file trong mọi lệnh compose ở hướng dẫn này. Compose đọc lại file đó trong mỗi lần gọi lệnh, nên lệnh không có flag sẽ dùng các giá trị mặc định được ghi trong file compose và có thể publish các port khác với những port bạn đã cấu hình.
Healthcheck của backend có start_period là 120s và polling /actuator/health, nên docker compose ps sẽ báo service livecontext ở trạng thái health: starting trong khoảng 2 phút đầu, khi schema migration và quá trình đăng ký tool đang chạy. Đây là bình thường. Kiểm tra nhanh từ server:
curl -s localhost:8080/actuator/healthLệnh này phải in ra {"status":"UP"}. Khi thấy kết quả đó, hãy mở web UI trên port 3000. Tài khoản đầu tiên bạn tạo sẽ trở thành admin, và đăng ký công khai sẽ đóng sau đó trừ khi admin mở lại. Vì vậy, hãy tạo tài khoản của bạn trước khi port này có thể được người khác truy cập. Đây là lý do quan trọng nhất để không publish port 3000 ra Internet ngay từ ngày đầu.
Các giá trị env bạn phải thay đổi
File ví dụ chứa các giá trị mặc định có thể dùng được để stack khởi động trên laptop. Một số giá trị không an toàn trên server public.
DB_PASSWORD=<random>
MINIO_ROOT_USER=<not minioadmin>
MINIO_ROOT_PASSWORD=<random>
CREDENTIAL_ENCRYPTION_PASSWORD=<random>
CREDENTIAL_ENCRYPTION_SALT=<random>
ANTHROPIC_API_KEY=sk-ant-...
FRONTEND_PORT=3000
BACKEND_PORT=8080
PUBLIC_BASE_URL=https://lc.example.com
GATEWAY_PUBLIC_URL=https://lc-api.example.comTạo từng giá trị ngẫu nhiên bằng openssl rand -base64 32. Lưu ý các giá trị dễ gây lỗi:
DB_PASSWORDvàMINIO_ROOT_PASSWORDđược cung cấp với giá trị mặc định làpostgresvàminioadmin. File compose truyềnDB_PASSWORDcho Postgres làmPOSTGRES_PASSWORD. Không database port nào được publish ra host, nên chúng không bị expose trực tiếp. Tuy nhiên, mọi container bạn gắn vào cùng network sau này đều có thể truy cập cả hai bằng giá trị mặc định được tài liệu công bố.CREDENTIAL_ENCRYPTION_PASSWORDvàCREDENTIAL_ENCRYPTION_SALTmặc định được comment out và sẽ được tự động tạo trong lần boot đầu tiên nếu để trống. Hãy tự đặt hai giá trị này. Credentials mà workflow lưu được mã hóa bằng cặp giá trị đó. Vì vậy, nếu restore database dump trên máy mới mà không dùng cùng password và salt, bạn sẽ có các credential row mà không thể đọc được. Chỉ đặt chúng một lần, sau đó xemdocker/.env.celà một phần của backup.FRONTEND_PORTvàBACKEND_PORTđược thay thế trong port mapping thành${FRONTEND_PORT:-3000}:3000và${BACKEND_PORT:-8080}:8080. File env ví dụ comment out cả hai giá trị này, dưới dạng# FRONTEND_PORT=3000và# BACKEND_PORT=8080, nên các giá trị mặc định 3000 và 8080 sẽ được áp dụng cho đến khi bạn bỏ comment một dòng để override.PUBLIC_BASE_URLlà địa chỉ mà trình duyệt dùng để truy cập web UI. File ví dụ yêu cầu các bản cài đặt trên server đặt giá trị này cùng vớiGATEWAY_PUBLIC_URL. Ghi cả hai giá trị mà không có dấu slash ở cuối, vì file ví dụ cảnh báo rằng dấu slash này sẽ làm hỏng OAuth callback.GATEWAY_PUBLIC_URLlà origin mà trình duyệt dùng để truy cập backend. Giá trị này quan trọng ngay khi có reverse proxy. Xem phần tiếp theo.- Các model key (
ANTHROPIC_API_KEY,OPENAI_API_KEY,GOOGLE_API_KEYvà tùy chọnMISTRAL_API_KEYhoặcDEEPSEEK_API_KEY) được lưu dưới dạng plain text tại đây. Chỉ điền provider mà bạn thực sự sử dụng.
Bảy container làm gì
postgreschạypgvector/pgvector:pg16dưới dạng containerlivecontext-dbvà lưu database có tênlivecontext. Extension pgvector dùng cho tìm kiếm embedding, nên imagepostgres:16thông thường sẽ không dùng được.redischạyredis:7-alpinecùng vớiappendonly yesvà--maxmemory-policy noeviction. Đây là chính sách có chủ ý: Redis lưu queue và trạng thái run ở đây, nên khi chạm giới hạn bộ nhớ, nó trả về lỗi cho tiến trình ghi thay vì âm thầm xóa key. Lỗi nhìn thấy được vẫn tốt hơn công việc biến mất mà không có dấu hiệu.miniolà object store tương thích S3 cho các file được truyền qua workflow.minio-initlà container chạy một lần. Nó chạymc mb myminio/workflow-files --ignore-existingkhi khởi động, tạo bucket rồi thoát. Nếu thấyminio-initở trạng tháiexited (0)trongdocker compose psthì hệ thống đang hoạt động đúng.bridgechứa các CLI adapter và công cụ MCP (model context protocol). Nó lắng nghe tại cổng 8093 bên trong Docker network và không được publish ra host.livecontextlà backend, một monolith Java 21 chạy trên cổng 8080. Nó chạy workflow engine, scheduler và agent.frontendlà web UI Next.js trên cổng 3000. Chỉ hai container cuối được publish ra host.
Trạng thái được lưu trong bảy named volume: livecontext_data cho Postgres, livecontext_redis, livecontext_minio, livecontext_keys, livecontext_bridge_secret, livecontext_cli_home và livecontext_logs. Compose thêm project name vào trước tên volume. Compose file đặt project name là livecontext-ce, nên volume thực tế trên disk có tên tương tự livecontext-ce_livecontext_minio. npm launcher ghi đè tên đó bằng -p livecontext, nên một máy từng chạy npx livecontext sẽ có thêm một bộ volume với tiền tố livecontext_. Chạy docker volume ls và sao chép đúng tên trước khi viết bất kỳ backup script nào dùng các volume này.
docker compose down -vxóa cả bảy volume. Tài liệu của vendor nói không được chạy lệnh này vì đây là cách nhanh nhất để mất toàn bộ workflow đã tạo.-vlà điểm khác biệt duy nhất.
Đặt phía sau Traefik thay vì publish port 3000
Publish các port 3000 và 8080 trên một VPS public sẽ expose app mà không có TLS (transport layer security) và không có lớp kiểm soát trước chức năng đăng ký tài khoản quản trị. Một rule ufw không đủ để tự bảo vệ, vì Docker chèn các rule iptables riêng cho những port đã publish lên trước chain do ufw quản lý. Vì vậy, một port được publish vào 0.0.0.0 vẫn có thể truy cập được ngay cả khi ufw báo port đó bị deny.
Cách xử lý gọn nhất là không publish port nào. Thay vào đó, để proxy truy cập các container qua một Docker network dùng chung. Tạo docker-compose.override.yml cùng với docker-compose.yml:
services:
frontend:
ports: !override []
networks:
- default
- proxy
livecontext:
ports: !override []
networks:
- default
- proxy
networks:
proxy:
external: trueCó 2 chi tiết quyết định cấu hình này có hoạt động hay không. !override thay thế danh sách ports thay vì gộp với danh sách hiện có. Tính năng này cần Compose v2.24 hoặc mới hơn: kiểm tra bằng docker compose version. Trên bản Compose cũ hơn, hai danh sách sẽ bị gộp và các port vẫn được publish. Ngoài ra, default phải tiếp tục có mặt trong từng danh sách networks. Khi đặt tên cho một network, Compose sẽ thay thế network mặc định. Nếu bỏ network này, backend sẽ mất kết nối đến Postgres và Redis, còn frontend sẽ mất kết nối đến backend. Xác nhận kết quả cấu hình sau khi merge trước khi khởi động:
docker compose --env-file docker/.env.ce configCác router, certificate resolver và redirect từ HTTP sang HTTPS vẫn giống như với mọi app khác. Hãy làm theo hướng dẫn reverse proxy Traefik để chạy nhiều app trên một VPS thay vì viết cấu hình TLS mới ở đây. Trỏ một hostname đến frontend trên port 3000 và hostname thứ hai đến livecontext trên port 8080.
Hostname thứ hai là bắt buộc. Web UI gọi backend từ trình duyệt, nên backend cần một origin riêng mà trình duyệt có thể truy cập. Đặt GATEWAY_PUBLIC_URL trong docker/.env.ce thành URL của backend, ví dụ https://lc-api.example.com, và đặt PUBLIC_BASE_URL thành URL của frontend. Nếu bỏ qua cấu hình này, trang vẫn tải bình thường nhưng mọi thao tác đều fail, vì UI lấy origin của backend từ địa chỉ bạn đã mở rồi gọi đến một port mà proxy không publish.
Vì trang đăng ký mở cho người đầu tiên truy cập, bạn nên đặt forward auth trên frontend router. Như vậy, không ai thấy được trang này nếu chưa xác thực tại proxy. Đây là chức năng mà chạy Authentik làm lớp SSO riêng của bạn bổ sung trên cùng cấu hình Traefik.
Vị trí đặt model key và lý do instance nhàn rỗi vẫn tốn tiền
Agent chạy bên trong automation, nên mô hình chi phí khác với workflow tool thông thường. Provider key được lưu trong docker/.env.ce dưới dạng ANTHROPIC_API_KEY hoặc OPENAI_API_KEY, được backend và bridge đọc khi khởi động, và áp dụng cho toàn bộ instance. Key này không được giới hạn theo từng user. Bất kỳ ai có account trên instance của bạn và có thể tạo agent đều đang sử dụng key đó. Người đăng ký đầu tiên là admin. Nếu bạn cần agent và chi phí theo từng người để có thể quy cho một đồng nghiệp cụ thể, tự host OneCLI làm harness, mỗi người một agent sẽ giải quyết vấn đề key theo hướng ngược lại: đặt mọi model key phía sau một gateway biết ai đang gọi.
Ba thói quen sau giúp chi phí dễ dự đoán hơn. Tạo một provider key riêng cho VPS này để có thể revoke key mà không ảnh hưởng đến các hệ thống khác. Đặt hard spend cap trong provider console, vì đó là giới hạn duy nhất nằm ngoài máy bạn đang bảo vệ. Sau đó sử dụng per-agent credit budget và per-agent metrics do LiveContext cung cấp, để một loop không thể sử dụng hết key trước khi bạn phát hiện.
Chi phí khi nhàn rỗi không bằng 0 nếu agent chạy theo schedule. Schedule trigger vẫn chạy dù không có ai theo dõi, và mỗi lần chạy đều gửi token. Schedule 5 phút chạy 288 lần mỗi ngày. Một agent đọc một trang rồi quyết định không làm gì vẫn phải trả chi phí đọc trang đó. Ban đầu, hãy cấu hình agent dùng webhook hoặc chat trigger, theo dõi chi phí thực tế trong một tuần, rồi chuyển sang schedule sau khi biết chi phí cho mỗi lần chạy.
Sao lưu Postgres và object store
Có hai kho dữ liệu và hai nơi lưu secret: file env và volume livecontext_keys. Tài liệu của vendor liệt kê các volume này trong danh sách cần sao lưu. Mất bất kỳ thành phần nào cũng làm mất instance của bạn. Hãy sao lưu database và bucket trong cùng một khoảng thời gian, khi backend đã dừng, để file không thể được ghi sau khi row tương ứng trong database đã được dump.
cd ~/livecontext-ce
mkdir -p ~/backups
docker compose --env-file docker/.env.ce stop livecontext frontend
docker compose --env-file docker/.env.ce exec -T postgres \
pg_dump -U postgres -d livecontext --clean --if-exists \
| gzip > ~/backups/livecontext-db-$(date +%F).sql.gzNếu bạn đã thay đổi postgres, hãy dùng giá trị bạn đã đặt cho DB_USERNAME thay cho postgres. Sau đó sao chép các volume object store và keys bằng tên có tiền tố mà docker volume ls đã in ra:
docker run --rm \
-v livecontext-ce_livecontext_minio:/data \
-v ~/backups:/backup \
alpine tar czf /backup/livecontext-minio-$(date +%F).tgz -C /data .
docker run --rm \
-v livecontext-ce_livecontext_keys:/data \
-v ~/backups:/backup \
alpine tar czf /backup/livecontext-keys-$(date +%F).tgz -C /data .
docker compose --env-file docker/.env.ce start livecontext frontend
cp docker/.env.ce ~/backups/env.ce.$(date +%F)Kiểm tra dump không rỗng trước khi tin cậy: gunzip -c ~/backups/livecontext-db-*.sql.gz | head -20 phải hiển thị các câu lệnh CREATE TABLE và DROP TABLE, không phải lỗi chỉ gồm một dòng. Sau đó sao chép cả bốn file ra khỏi server, cùng với docker-compose.yml và file override của bạn. Backup chỉ nằm trên chính máy mà nó bảo vệ thì không phải là backup.
Để restore lên một máy mới, hãy cài cùng tag, khôi phục docker/.env.ce đã lưu để password và salt dùng cho việc mã hóa credential khớp nhau, khởi động stack một lần để tạo các volume, dừng backend, giải nén archive keys vào volume keys theo đúng cách đã dùng khi sao lưu, rồi load dump:
gunzip -c livecontext-db-2026-08-10.sql.gz \
| docker compose --env-file docker/.env.ce exec -T postgres psql -U postgres -d livecontextNâng cấp và cách khôi phục khi có sự cố
Luôn tạo dump trước mỗi lần nâng cấp. Backend áp dụng các schema migration khi khởi động và migration chỉ tiến về phía trước. Vì vậy, quay lại tag cũ sau một lần nâng cấp lỗi sẽ khiến code cũ chạy trên schema mới. Rollback nghĩa là khôi phục dump. Đó là lý do phải tạo dump trước.
cd ~/livecontext-ce
npm view livecontext version
TAG=0.3.8
npm pack "livecontext@$TAG"
rm -rf package && tar xzf "livecontext-$TAG.tgz"
cp docker-compose.yml docker-compose.yml.prev
cp package/assets/docker-compose.yml .
sed -i -E "s#ghcr\.io/livecontext-ai/(livecontext-ce[a-z-]*):latest#livecontext/\1:v$TAG#" docker-compose.yml
diff docker-compose.yml.prev docker-compose.yml
docker compose --env-file docker/.env.ce pull
docker compose --env-file docker/.env.ce up -d
docker compose --env-file docker/.env.ce logs -f livecontextĐặt TAG thành phiên bản mà lệnh thứ hai đã in ra. Theo dõi log của backend cho đến khi health endpoint trả lời lại. docker-compose.override.yml của bạn không thuộc package, nên việc chép file compose mới vào sẽ giữ nguyên file đó. Tuy nhiên, hãy đọc diff mà lệnh diff in ra, vì service mới hoặc service được đổi tên có thể khiến file override của bạn bị lỗi thời mà không hiển thị thông báo lỗi. Đồng thời, hãy so sánh docker/.env.ce với package/assets/.env.example, vì các thiết lập mới được thêm vào đó.
Các trường hợp lỗi và chuỗi bạn sẽ thấy
Một container liên tục restart và docker compose ps hiển thị exited (137). Đây là OOM killer của kernel. docker inspect livecontext-app xác nhận điều này bằng "OOMKilled": true trong khối trạng thái. Backend đã chạm giới hạn 2048M, hoặc host hết memory trước. Kiểm tra free -m trước khi tăng bất kỳ giới hạn nào. Tăng giới hạn container trên host không còn memory trống chỉ chuyển việc kill sang container khác.
Lệnh pull fail với no matching manifest for linux/arm64/v8 in the manifest list entries. Các image chỉ được publish cho linux/amd64. Arm VPS không thể chạy stack này từ các image đã publish. Emulation qua QEMU quá chậm đối với JVM kết hợp với Chromium. Hãy chuyển sang plan x86.
Bind for 0.0.0.0:3000 failed: port is already allocated. Một tiến trình khác trên host đã giữ port đó. Đặt FRONTEND_PORT trong docker/.env.ce, hoặc áp dụng override ở trên và không publish port nào.
UI đã hoạt động nhưng request đăng nhập fail sau khi bạn thêm proxy. Browser đang gọi backend trên một origin mà proxy của bạn không serve. Mở tab network của browser và xem host của request bị fail. Đặt GATEWAY_PUBLIC_URL thành public URL của backend rồi recreate frontend container, vì giá trị này được đọc lúc khởi động.
Mọi thứ đều healthy nhưng các file upload trong workflow biến mất. Kiểm tra để bảo đảm minio-init hiển thị exited (0) thay vì code khác 0. Nếu bucket workflow-files chưa từng được tạo, backend không có nơi để lưu object.
Chọn LiveContext hay n8n
Chọn LiveContext khi agent là trọng tâm: bạn muốn model xây dựng và chạy automation, đồng thời chấp nhận một máy 8 GB và một Java service. Chọn n8n khi bạn cần workflow có tính quyết định, thư viện node lớn và footprint có thể dùng chung một VPS với các service khác. Giấy phép hiện không còn là điểm khác biệt giữa hai công cụ. LiveContext CE đã chuyển từ AGPL-3.0 sang LiveContext Sustainable Use License 1.1, một giấy phép source-available thuộc cùng họ fair-code với Sustainable Use License của n8n. Vì vậy, hãy đọc kỹ hạn chế về hosting trước khi cung cấp một trong hai công cụ cho bất kỳ ai bên ngoài công ty bạn. n8n self-hosted cũng giữ lại một số tính năng dành cho khách hàng trả phí, nên hãy kiểm tra những phần nào của n8n được miễn phí và phần nào cần license key trước khi xây dựng workflow nhóm dựa trên một trong hai công cụ. Các version ở đây còn mới, v0.3.8 tính đến ngày 13 October 2026, và dòng 0.3 đã phát hành 9 release trong khoảng từ 22 September đến 9 October 2026. Vì vậy, hãy pin version và đọc các thay đổi trước mỗi lần upgrade. Để xem phạm vi rộng hơn, bao gồm các công cụ nằm giữa hai lựa chọn này, hãy xem bài tổng hợp các lựa chọn thay thế n8n self-hosted của chúng tôi thay vì chỉ đọc bài so sánh hai công cụ này.
FAQ
LiveContext self-hosted cần bao nhiêu RAM?
Hãy chuẩn bị 8 GB. Tài liệu self-hosting của vendor ghi 4 GB là mức tối thiểu và 8 GB là mức khuyến nghị, README của launcher hiện ghi tối thiểu 6 GB, còn file compose đi kèm giải thích lý do: riêng backend đã bị giới hạn ở 2048 MB, và 5 service cơ sở có tổng giới hạn khoảng 3.6 GB trước khi tính container frontend không giới hạn. Bật browser agent profile sẽ cần thêm 2048 MB cho Chromium cùng một container SearXNG, nên từ thời điểm đó 8 GB không còn là mức tùy chọn.
Tôi có thể chạy LiveContext trên Arm VPS không?
Không. Mọi image LiveContext được phát hành cho v0.3.8 đều được build cho linux/amd64, vì vậy docker compose up trên gói Arm sẽ fail ngay khi pull với no matching manifest for linux/arm64/v8 in the manifest list entries. Về lý thuyết có thể chạy bằng QEMU emulation, nhưng trong thực tế không thể sử dụng được cho workload JVM. Hãy chọn gói x86.
Tôi đặt model API key ở đâu?
Trong docker/.env.ce, dưới dạng ANTHROPIC_API_KEY, OPENAI_API_KEY hoặc GOOGLE_API_KEY, trước lần khởi động đầu tiên. Backend và bridge đọc key này khi khởi động, và key áp dụng cho toàn bộ instance thay vì chỉ một user. Giữ file ở mode 600, dùng một key chỉ được tạo cho server này để có thể revoke riêng key đó, và đặt spend cap trong console của provider, vì đây là giới hạn duy nhất nằm ngoài máy.
Tôi sao lưu LiveContext như thế nào?
Có 4 thứ: một pg_dump của database livecontext, một bản sao của volume MinIO, một bản sao của volume livecontext_keys và file docker/.env.ce. Dừng các service livecontext và frontend trong khi tạo dump và sao chép volume để database và object store nhất quán với nhau. File env rất quan trọng vì các credential được lưu trong workflow được mã hóa bằng CREDENTIAL_ENCRYPTION_PASSWORD và CREDENTIAL_ENCRYPTION_SALT, nên restore mà thiếu các giá trị này sẽ để lại các row credential mà không thành phần nào trên máy mới có thể đọc được.
Vì sao backend đứng ở health: starting trong vài phút sau khi boot?
Healthcheck của compose đặt start_period: 120s và poll /actuator/health, nên Docker báo service đang khởi động trong khi schema migration và quá trình đăng ký tool chạy. Mất 2 đến 3 phút ở lần boot đầu tiên là bình thường. Nếu service không bao giờ chuyển sang trạng thái healthy, hãy đọc docker compose logs -f livecontext. Stack dừng ở bước migration thường là do đang trỏ đến database volume của một release mới hơn.