Tạo website mới
webmati create — tạo một website mới (trong trình duyệt, hoặc bằng key của workspace) rồi clone nó về máy luôn.
webmati create "Tiệm Bánh" --slug tiem-banh
Một lệnh làm ba việc: tạo website, duyệt key cho máy này, rồi clone
website mới vào thư mục tiem-banh/.
Trong trình duyệt (mặc định)
- CLI mở trang quản trị (
Create the website and approve this machine in the browser). Chưa đăng nhập thì bạn đăng nhập trước. - Trang tạo website trong workspace bạn đang mở: giới hạn số website của gói và quyền của bạn vẫn áp dụng như khi tạo trong admin.
- Trang hỏi bạn cho phép key của máy này cho website mới (key chỉ dùng cho website đó, như ở Đăng nhập).
- CLI lưu key và clone website:
Created website "Tiệm Bánh" (store 43, tiem-banh).
Cloned tiem-banh into /…/tiem-banh
theme: 1 own file(s), 81 inherited (read-only in .webmati/inherited)
backend: 0 workflow(s), 0 table(s)
Next: cd tiem-banh, read AGENTS.md, edit, then `webmati validate` and `webmati push --dry-run`.
Nếu trên trang bạn chọn một website có sẵn thay vì tạo mới, CLI báo
Note: the browser approved an existing website … instead of creating one và
clone website đó.
Tuỳ chọn
| Cờ | Tác dụng |
|---|---|
--slug tiem-banh | địa chỉ website (<slug>.<tên miền nền tảng>), kiểm tra như admin kiểm tra; mặc định lấy từ tên |
--template restaurant | bắt đầu từ một mẫu theme; tên sai thì CLI liệt kê các mẫu có; mặc định là mẫu trống |
[thư mục] | thư mục để clone vào (mặc định là slug); phải trống, và được kiểm tra trước khi tạo gì |
--days 7, --label, --locale | như ở login --web |
webmati create "Nhà hàng Mai" --slug nha-hang-mai --template restaurant
webmati create "Studio An" studio-an-local
Không có trình duyệt: --key
Cho máy chủ CI, dùng một key của workspace (tạo trong Cài đặt ▸ API Keys)
có quyền stores:write (thêm domains:write nếu dùng --slug). Đưa key qua
stdin:
webmati create "Tiệm Bánh" --slug tiem-banh --key -
Biến WEBMATI_TOKEN cũng được. Key của CLI (key bạn duyệt bằng login --web)
chỉ gắn với một website nên không bao giờ tạo được website mới: CLI từ chối
trước khi gửi gì, và gợi ý bỏ --key để tạo trong trình duyệt.
Khi bị từ chối
| Thông báo | Làm gì |
|---|---|
Plan limit reached: max N websites (kèm tiếng Việt) | gói đã đủ số website: nâng gói, hoặc xoá bớt một website |
the address "tiem-banh" is taken by another website, or reserved | chọn --slug khác |
--slug "admin": this subdomain is reserved by the platform (mã thoát 2) | chọn slug khác; slug cần ít nhất 3 ký tự, chỉ chữ, số và gạch nối |
no template "…" here (templates: …) | chọn một mẫu trong danh sách, hoặc bỏ --template |
<thư mục> is not empty | đặt tên thư mục khác ở cuối lệnh |
this key cannot create websites | bỏ --key để tạo trong trình duyệt, hoặc dùng key của workspace đủ quyền |
Mã thoát: 0 đã tạo và clone · 1 bị từ chối hoặc lỗi · 2 dùng sai lệnh.

