Bolt.new self-host trên VPS cho team dev AI app prototype

Bolt.new (bolt.new) của StackBlitz là tool generative app dạng "prompt to app" gây sốt cuối 2024. Nhập câu mô tả app, AI sinh full Next.js project, chạy preview ngay trong browser qua WebContainer (Node trong browser WASM). Bolt.new official subscription 20$/tháng. Bolt.diy là fork open source MIT, self-host được, gắn API model bạn chọn.

Bài này hướng dẫn full setup Bolt.diy trên VPS Ubuntu cho team dev VN, gắn Claude Sonnet + GPT-5 mix, demo prototype landing + dashboard nội bộ. Phù hợp team founder + freelancer hay cần MVP nhanh cho khách.

Mục tiêu cuối bài: bạn có Bolt.diy chạy HTTPS trên VPS, prompt sinh app đầu tiên, export code về GitHub repo, deploy lên Vercel hoặc Coolify để live demo.

1. Bolt.new vs Bolt.diy vs v0 vs Lovable

Bolt.diy thắng ở: self-host, dùng API key của bạn (cost theo token, có thể rẻ hơn subscription nếu dùng ít), team share không phải mua nhiều subscription. Thua ở: UI ít polish hơn Bolt.new official, một số tính năng beta.

2. Yêu cầu VPS

• RAM: 4GB tối thiểu (Bolt.diy + Node + Postgres dev).
• vCPU: 2-4.
• SSD: 40GB.
• Ubuntu 24.04, Node.js 22 hoặc Bun.
• Domain: bolt.your-domain.com với Caddy SSL.

3. Cài Bolt.diy

# Cài Node 22 hoặc Bun
curl -fsSL https://bun.sh/install | bash
source ~/.bashrc

# Clone Bolt.diy
git clone https://github.com/stackblitz-labs/bolt.diy.git /opt/bolt
cd /opt/bolt

# Install deps + build
bun install
bun run build

# Test chạy
bun run start
# Mặc định port 5173

4. File .env config providers

# /opt/bolt/.env.local
ANTHROPIC_API_KEY=sk-ant-api03-xxx
OPENAI_API_KEY=sk-xxx
GROQ_API_KEY=gsk_xxx  # tùy chọn cho Llama tốc độ cao
GOOGLE_GENERATIVE_AI_API_KEY=xxx  # cho Gemini

# Default model
DEFAULT_NUM_CTX=32768
DEFAULT_PROVIDER=Anthropic
DEFAULT_MODEL=claude-sonnet-4-7-20260301

Bolt.diy support 15+ provider: Anthropic, OpenAI, Google Gemini, Groq, Ollama, OpenRouter, HuggingFace, xAI Grok, Mistral, Cohere. Trong UI có thể switch model giữa các prompt.

5. Systemd service và Caddy reverse proxy

# /etc/systemd/system/bolt-diy.service
[Unit]
Description=Bolt.diy AI app generator
After=network.target

[Service]
Type=simple
User=bolt
WorkingDirectory=/opt/bolt
Environment=NODE_ENV=production
ExecStart=/home/bolt/.bun/bin/bun run start
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

# /etc/caddy/Caddyfile
bolt.your-domain.com {
    reverse_proxy localhost:5173
    encode gzip
    basicauth {
        team $2a$14$hashed_password
    }
}

sudo systemctl daemon-reload
sudo systemctl enable --now bolt-diy
sudo systemctl reload caddy

Basic Auth bảo vệ tránh ai cũng vào. Cho team dev internal là đủ. Production nâng cao: thêm OAuth qua Caddy plugin caddy-security.

6. Prompt đầu tiên: landing SaaS

Truy cập https://bolt.your-domain.com, login Basic Auth. UI có textarea prompt + button "Build". Thử prompt:

Tạo landing page cho SaaS Cloud VPS:
- Hero: headline "VPS 99k/tháng tại VN", subhead, 2 button (Bắt đầu, Xem gói)
- Section "Tính năng": 4 card grid (SSD CEPH, Snapshot, Backup, 200Mbps)
- Section "Pricing": 3 plan card (Basic 99k, Pro 199k, Business 399k)
- Footer simple
- Dùng Next.js 15 App Router + Tailwind + shadcn/ui
- Dark mode default, glassmorphism style

Bolt.diy stream code real-time: tạo package.json, tsconfig, các file component, tailwind config, layout, page. WebContainer chạy npm install trong browser, hot reload preview. Vài phút là có demo live.

7. Iterate: refine và sửa

• Trong chat: "Thêm section testimonial 3 cột với avatar và quote".
• Bolt.diy đọc context project hiện tại, edit file thêm component, preview update.
• "Sửa Hero gradient từ xanh sang tím #7A5BFF".
• "Pricing dùng Stripe checkout link khi click Bắt đầu" - sinh stub API route.

8. Export code về GitHub

• Click "Download zip" trong UI - tải full project.
• Hoặc: connect GitHub OAuth, click "Push to GitHub" - tạo repo mới hoặc commit vào branch.
• Clone về local, sửa thêm, deploy Vercel/Coolify/Dokploy.

Lưu ý: code Bolt.diy sinh là MVP quality, cần dev review trước khi production. Hay miss edge case, error handling thiếu, type không strict 100%.

9. Use case thực tế

• Founder demo MVP cho investor: prompt 5 phút, có UI live click.
• Freelancer prototype concept cho client trước proposal.
• Internal tool nhanh: dashboard admin xem stats, form submit Google Sheets.
• Landing page A/B test: sinh 3-5 variant headline khác nhau, test conversion.
• Workshop học React: prompt sinh todo app, AI giải thích từng phần.

10. Hạn chế WebContainer

• Chỉ chạy package Node thuần JS. Không hỗ trợ native module (sharp, sqlite, canvas).
• Không truy cập filesystem máy local của user.
• Performance browser hạn chế: project lớn (50+ component) chậm dần.
• Không persistent: refresh tab mất state, phải save chat history.
• Không có DB thật - Prisma SQLite chạy được nhưng reset mỗi session.

11. Tối ưu cost API

• Mix model: Sonnet 4.7 cho generate init project, Haiku/GPT-5-mini cho refine nhỏ.
• Context size: default 32k token, tăng cho project lớn 100k+ token (tốn nhiều hơn).
• Prompt caching: Claude support cache 1h, mỗi prompt sau tiết kiệm 70-90% input token.
• Limit per session: cấu hình max 50 message/session, tránh user spam tốn cost.
• Monitor: log usage qua provider dashboard, alert khi vượt budget.

12. Team workflow đề xuất

• Sáng: PM/founder prompt sinh prototype dựa spec mới.
• Trưa: dev review code sinh ra, refine + thêm logic backend thật.
• Chiều: export GitHub, deploy preview Vercel, share link client.
• Tối: client feedback, iterate sáng hôm sau.

Cycle MVP từ ý tưởng -> demo live giảm từ 3-5 ngày xuống 1 ngày. ROI cực cao cho freelancer/agency.

FAQ

Bolt.diy khác Bolt.new official ra sao?

Bolt.diy là fork open source MIT của community, mất một số tính năng beta (multi-file edit, GitHub deep integration). Bolt.new official polish hơn, có infrastructure StackBlitz scaling. Self-host Bolt.diy phù hợp team budget thấp + cần tùy biến model. Pro user nên thử Bolt.new official trước, switch sang Bolt.diy nếu cost trở thành vấn đề.

Có thể chạy Bolt.diy với Ollama local model không?

Có. Provider Ollama trong .env: OLLAMA_API_BASE_URL=http://localhost:11434. Khuyến nghị model Qwen 2.5 Coder 14B hoặc 32B (cần VPS 32-64GB RAM). Model nhỏ 7B không đủ generate full project. Production: ưu tiên Claude/GPT cho quality, local Ollama chỉ khi compliance offline.

Code sinh ra có production-ready không?

Không hoàn toàn. Code Bolt.diy chất lượng MVP, đủ cho demo và prototype. Production cần dev review thêm: error handling, validation Zod, security headers, auth middleware, test. Coi Bolt như "AI pair programmer junior", không như "senior engineer thay thế".

WebContainer chạy nặng máy user không?

Khá nặng. WebContainer compile Node V8 -> WASM chạy trong browser, project trung bình ngốn 1-2GB RAM Chrome tab. Laptop 8GB chạy 1-2 tab Bolt.diy được. Mobile/iPad không khuyến nghị. Trade-off: chạy preview ngay browser không cần backend, không lo security sandbox.

Có thể import existing project vào Bolt.diy chỉnh sửa không?

Có, từ v0.5+. Upload ZIP project hoặc clone Git URL, Bolt.diy load vào WebContainer. AI có thể đọc context và sửa. Phù hợp cho refactor nhỏ hoặc thêm feature. Project >100MB hoặc nhiều native deps không import được.

So với Cursor/Claude Code, ưu thế Bolt.diy là gì?

Bolt.diy: prompt -> app chạy ngay browser, không cần cài tool local. Phù hợp non-dev (founder, PM) hoặc dev mobile/iPad. Cursor/Claude Code: edit code local trên máy bạn, mạnh cho refactor đa file, có DB/API thật. Hai tool bổ trợ chứ không replace. Mình dùng Bolt cho prototype demo, Claude Code cho production work.