Deploy app Bolt.new lên ZoCloud: từ file tải về hoặc GitHub tới HTTPS
Để deploy app làm bằng Bolt.new lên ZoCloud, lấy code ra khỏi Bolt (tải về máy hoặc đẩy lên GitHub), rồi deploy bằng lệnh zo deploy hoặc Deploy từ Git trên portal. ZoCloud tự nhận diện dự án Vite hay Node.js, build và trả về link HTTPS dạng https://web-<project>.zocloud.app. Sau đó bạn đặt biến môi trường, thêm database nếu cần, và gắn tên miền riêng.
Bolt.new sinh ra loại dự án nào
Bolt.new chạy code trong trình duyệt bằng môi trường Node.js, nên app Bolt là dự án Node.js thông thường với package.json. Tuỳ yêu cầu ban đầu, bạn sẽ gặp một trong các dạng:
| Dạng dự án | Nhận biết trong package.json |
ZoCloud chạy thế nào |
|---|---|---|
| Vite + React (hay Vue, Svelte), chỉ có giao diện | có vite, script dev, build, preview, không có start |
Build rồi phục vụ thư mục dist thành site tĩnh |
| Vite + server Express | có thêm script start chạy file server (ví dụ node server.js) |
Build rồi chạy start như một app Node.js |
| Next.js | có next |
Build rồi chạy next start |
| Astro, SvelteKit, Remix… | có framework tương ứng | Nhận diện theo framework |
Không chắc app của bạn thuộc dạng nào? Sau khi lấy code về máy, chạy zo detect: lệnh này in framework, lệnh cài, lệnh build, lệnh chạy mà ZoCloud sẽ dùng.
Một lưu ý: nếu script start chỉ là vite (chạy server phát triển), đừng để ZoCloud dùng nó cho production. Xoá script start đó để ZoCloud phục vụ bản build tĩnh, hoặc đổi thành lệnh chạy server thật.
Với site tĩnh Vite, mọi đường dẫn không phải file (/gio-hang, /san-pham/12) đều trả về index.html, nên React Router hoạt động khi người dùng tải lại trang.
Bước 1: Lấy code ra khỏi Bolt
Bạn có hai cách (giao diện Bolt thay đổi thường xuyên, nên tên nút có thể khác đôi chút):
- Tải về: dùng tuỳ chọn tải dự án thành file zip trong Bolt, giải nén ra một thư mục.
- GitHub: dùng tích hợp GitHub của Bolt để đẩy dự án lên một repo. Cách này tiện nếu bạn muốn tự deploy mỗi lần cập nhật.
Trên máy, nên chạy thử trước:
npm install
npm run build
Build trên máy được thì thường build trên ZoCloud cũng được. Đây cũng là lúc kiểm tra file .env mà Bolt tạo: ghi lại các biến trong đó, bạn sẽ đặt chúng trên ZoCloud ở bước 3.
Bước 2a: Deploy từ thư mục bằng zo CLI
Đây là cách nhanh nhất khi bạn vừa tải zip về.
curl -fsSL https://app.zocloud.io/install.sh | sh
zo login # dán token tạo ở Tài khoản → Token truy cập
cd duong-dan/app-bolt
zo detect
zo deploy -to myorg/shop/web
Windows: tải zo.exe ở Tài khoản → mục Deploy từ máy của bạn.
Project shop và service web được tạo tự động nếu chưa có. zo đóng gói thư mục, bỏ qua node_modules, .git và các mẫu trong .gitignore, không bao giờ gửi file .env, rồi in log build và địa chỉ HTTPS khi xong. Lần sau chỉ cần zo deploy.
Bước 2b: Deploy từ GitHub
- Đăng ký ZoCloud, xác minh e-mail; bạn có thể bắt đầu với gói Dùng thử miễn phí.
- Mục Project → Tạo project.
- Mục GitHub của tổ chức → Kết nối GitHub, cài ZoCloud cho repo. ZoCloud chỉ đọc mã nguồn.
- Trên canvas, Thêm → Từ repo GitHub, chọn repo, kiểm tra Tên service, Nhánh, Thư mục gốc.
- Bấm Tạo và deploy.
Bật Tự deploy khi push ở tab Cấu hình để mỗi lần push là có bản mới. Bản đang chạy vẫn phục vụ khi bản mới đang build hoặc bị lỗi.
Bước 3: Đặt biến môi trường
Đặt lại các biến từ file .env của Bolt ở tab Biến môi trường của service (bấm Sửa dạng .env để dán nhiều dòng), hoặc:
zo vars set VITE_SUPABASE_URL=https://xxxx.supabase.co VITE_SUPABASE_ANON_KEY=eyJ...
zo deploy
Hai điều cần nhớ:
- Biến có hiệu lực từ lần deploy sau. Biến
VITE_*còn được đưa thẳng vào bản build, nên đổi biến là phải deploy lại. - Biến
VITE_*lộ ra cho mọi người xem trang. Chỉ đặt vào đó những giá trị công khai (URL, khoá anon). Khoá bí mật như khoá API trả phí hayservice_rolecủa Supabase phải nằm ở phía server, không có tiền tốVITE_.
Chi tiết ở biến môi trường và file .env.
Bước 4: Database cho app Bolt
App dùng Supabase
Nhiều app Bolt gọi Supabase thẳng từ trình duyệt. Bạn có thể giữ nguyên: chỉ cần đặt biến như bước 3. Nếu app có đăng nhập, thêm địa chỉ ….zocloud.app và tên miền riêng vào Site URL và Redirect URLs trong phần cấu hình Authentication của dự án Supabase.
Chuyển hẳn từ Supabase sang PostgreSQL của ZoCloud thì được với dữ liệu bảng (dump và nạp lại), nhưng đăng nhập, lưu file, Edge Functions và quy tắc Row Level Security không tự chuyển theo: bạn cần một service backend đứng giữa giao diện và database. Phân tích kỹ hơn trong bài deploy app Lovable, phần "Giữ Supabase hay chuyển dữ liệu".
App có server Node.js cần database
Nếu app Bolt có server Express (hoặc Next.js với API routes) và cần database, thêm database trong cùng project:
zo db create pg -engine postgres
zo vars set 'DATABASE_URL=${{pg.DATABASE_URL}}'
zo deploy
Dùng dấu nháy đơn để shell không hiểu ${{…}} là biến của shell. Biến tham chiếu tự cập nhật nếu database đổi máy chủ hay mật khẩu. Database chạy trong mạng riêng, chỉ service trong cùng environment truy cập được, và được sao lưu mỗi đêm.
Cần MySQL hay bộ đệm Redis? Dùng -engine mysql hoặc -engine valkey (biến ${{cache.REDIS_URL}}). Xem PostgreSQL trên cloud tại Việt Nam, MySQL hosting và Redis, Valkey làm cache.
App dùng SQLite (một file database)? Thêm volume để file không mất khi deploy lại: tab Cấu hình → Volume → Thêm volume, đường dẫn ví dụ /data, rồi trỏ SQLite vào /data/app.db. Service có volume chạy 1 bản.
Server phải nghe đúng cổng ZoCloud đặt:
const port = process.env.PORT || 3000;
app.listen(port, "0.0.0.0");
Bước 5: Tên miền riêng và HTTPS
- Tab Tên miền của service → nhập
www.shopcuatoi.vn→ Thêm (hoặczo domains add www.shopcuatoi.vn). - Tạo bản ghi DNS portal hiện: tên con là
CNAMEvềweb-shop.zocloud.app, tên gốc là bản ghiA. Tên miền mua tại ZoCloud hoặc dùng ZoCloud DNS thì bản ghi tự tạo. - HTTPS được cấp tự động trong vài phút khi DNS đúng, tự gia hạn.
Gói Dùng thử chưa có tên miền riêng; gói Hobby (119.000 đ/tháng, chưa gồm VAT) có 3 tên miền, gói Pro (499.000 đ) có 20. Xem trỏ tên miền về hosting.
Tiếp tục sửa app sau khi deploy
Sau khi app đã lên mạng, bạn có thể:
- Tiếp tục sửa trong Bolt, đẩy lên GitHub và để ZoCloud tự deploy.
- Hoặc mở code trong Cursor, Claude Code và để agent tự deploy qua
zo mcp(xem vibe coding, deploy từ Cursor và Claude Code).
Khi có lỗi, xem log ở tab Log hoặc:
zo logs -since 1h
zo logs -stream http -status 5xx
Lỗi hay gặp
| Hiện tượng | Cách xử lý |
|---|---|
| Trang trắng sau deploy | Thiếu biến VITE_*, hoặc đặt biến xong chưa deploy lại |
| "không có gì nghe trên cổng N" | Server không nghe 0.0.0.0:$PORT |
| App chạy chế độ phát triển, chậm | Script start là vite; xoá hoặc đổi thành lệnh chạy server thật |
| Tải lại trang con báo 404 | Dự án có start nên không được phục vụ như SPA; kiểm tra zo detect |
| Dữ liệu SQLite mất sau deploy | Chưa có volume; thêm volume và lưu file database trong đó |