Quick start

You need:

• A GitHub account created at least 30 days ago.
• A web app repo with a Dockerfile, or a Node, Python, Go… project Embra can detect.

The console is in Vietnamese; button names are quoted as they appear, with a translation in brackets.

Checklist

Each step has its own guide (linked at the end of the step).

1. Sign in, get the trial. Open the console → “Đăng nhập bằng GitHub” (sign in with GitHub). A 7-day trial workspace is created right away. → Account, trial and payment
2. Prepare the repo. The app listens on 0.0.0.0 on the port set in embra.toml (3000 by default), has a health check path that returns 2xx, and writes nothing to disk outside /tmp. Need Postgres? Add database = true (adding it after the first deploy works too). → Prepare your app
3. Deploy from GitHub. “＋ Tạo mới” (create) → “Deploy từ GitHub” → “Kết nối GitHub ↗” (connect GitHub) → pick the repo → “Tạo và deploy” (create and deploy). → Deploy from GitHub
4. Database and migrations. Write schema changes as files like migrations/0001_name.sql. Embra rehearses them on a copy of your data before running them for real. → Database and migrations
5. Store files (optional). Each plan has one S3 bucket per environment: “＋ Tạo mới” → “Bucket”. The app gets the S3_* env vars from the next deploy on. → Store files (S3 bucket)
6. Set secrets. Cài đặt → Secrets (settings, secrets). The app reads each secret from an env var of the same name, from the next build on. → Secrets
7. Approve production, open the app. Production always needs an Owner or Admin to approve: “Xem và duyệt” (review and approve) → type the environment name → “Duyệt và deploy” (approve and deploy). The app runs at https://<app>-production-<code>.onembra.com.
8. Add your own domain. Cài đặt → Domain, add the TXT and CNAME records. On Cloudflare, keep the cloud grey (DNS only). → Custom domains
9. Invite your team, pay. Cài đặt → Thành viên (members). Invitees accept on their next sign-in with the invited email, even if they already have a workspace. Choose a plan before the 7-day trial ends, or the app and data are deleted. → Members and permissions, Account, trial and payment

Using the CLI?

Every step above also works with the embra CLI: install with one command, embra login, then embra up in the app directory. See the command list.

If something goes wrong

You see	Do this
Build failed	Click “Xem build logs” (view build logs) on the overview page, look up the code in Error codes and fixes
App does not come up (HEALTHCHECK_FAILED)	Check the port and health check path. See Health check
The environment shows “Cần xác minh dữ liệu” (data needs checking), “Cần đội Embra hỗ trợ” (needs the Embra team) or “Chờ đội Embra kiểm tra” (waiting for the Embra team)	An action ended with an unknown outcome; Embra stops instead of retrying. Email hello@embra.cloud, see When Embra stops for a check