ZoCloud User Guide Tiếng Việt Open ZoCloud

Domains

The organisation's Domains section: buy, transfer in and manage .vn and international domains, paid from your ZoCloud wallet. DNS runs on ZoCloud's servers in Vietnam (ns1.zocloud.io, ns2.zocloud.io).

Permissions: buying, renewing and transferring in need a role that can pay (Owner, Admin, Billing); editing DNS and Cloudflare needs Owner or Admin; getting a transfer-out code is for the Owner only. See Organisations, members and account security.

Finding a domain

The Find a domain box: type a name (for example shopcuatoi) to see which extensions are free, or a full name (shopcuatoi.vn), then click Search.

Each result is available, taken or to be checked (that extension's registry does not allow automated lookups; ZoCloud checks again at registration and refunds in full if the name turns out to be taken). Prices include VAT, apply to the first year, and come with the renewal price for the following years.

For each name the portal offers these options:

Option When
Register it The name is available
Transfer it to ZoCloud The name is already at another registrar and you want to manage and renew it at ZoCloud
I own it: point it at ZoCloud Keep the domain at its current provider and only add DNS records. Also works for extensions ZoCloud does not sell yet

Buying a domain

  1. Choose Register it → Buy.
  2. Choose the Period (number of years) and the Registrant. The first time, click Add a registrant: choose Individual or Organisation / company, fill in Full name / Organisation name, E-mail, Phone, Address, Province / city… then Save registrant.
  3. Turn Auto-renew on or off (renews from the wallet before expiry, with a reminder e-mail first).
  4. Click Pay …. The amount is taken from the wallet; if the wallet is short, the portal says "Not enough in the wallet: top up".

Once ordered, the domain is in the registering state. The ZoCloud team registers it at the registrar, usually during working hours, and e-mails you when it is done. If the registration fails, the full amount is refunded to the wallet. If more paperwork is needed, the state is needs information: click Answer through Support.

Domains bought at ZoCloud use ZoCloud's nameservers; DNS and SSL are automatic.

.vn domains

By regulation, the registrant of a .vn domain also needs: ID card / passport number (or Tax number for an organisation), Ward / commune, District, Birthday, Gender. For an organisation, the personal details are those of the Representative (manages the domain), together with their Position.

After the purchase you receive (by e-mail and on the portal, under "Please complete:"):

  • eKYC identity check (a person)
  • Sign the form

Paperwork states: form not signed, form being checked, form not accepted. If the form is not completed, the .vn domain may be suspended.

Renewal

  • Auto-renew: turned on per domain. ZoCloud renews from the wallet before the expiry date; if the wallet is short, you get a reminder e-mail.
  • Manual renewal: click Renew on the domain, choose the number of years, confirm. The portal says "Renewal ordered."
  • Past expiry: the state is expired; the DNS zone is kept.

Transferring a domain to ZoCloud

  1. At the current registrar: unlock the domain and get the Transfer (auth) code.
  2. Search for the domain → Transfer it to ZoCloud, enter the transfer code, choose the registrant, pay. The transfer fee usually includes one more year of registration.
  3. The state is transferring in until it completes. The transfer code is stored encrypted; only the person handling the transfer can see it, and each access is recorded.

Transferring a domain away

  • International domains: More actions → Move to another registrar → Get the code. The domain is unlocked and the organisation's owner gets an e-mail notification. Give the code to the new registrar and keep it secret: anyone with the code can transfer the domain away. Only an Owner can do this.
  • .vn domains: Move away (through Support).

Changing the registrant

More actions → Change registrant: updates the details at the registrar. For .vn, you can change the address, contact details and the person managing the domain yourself; changing the owner of a .vn domain requires an ownership-transfer file, so contact Support.

Attaching a domain to a service

From the Domains page (or the service's Domains tab, see Apps: projects, services and deployments):

  1. Choose the domain (or search for the name → Point it at ZoCloud).
  2. Attach to service: choose project / service → Attach the name.
  3. If ZoCloud manages the DNS (a name bought at ZoCloud, ZoCloud DNS, or a connected Cloudflare zone): the records are created automatically, nothing more to do.
  4. Otherwise, the portal lists the records to create where the DNS is currently managed:
    • a subdomain: CNAME → <service>-<project>.zocloud.app
    • the root name (@): A records pointing at ZoCloud's IPs. Remove the root name's old A/AAAA records; adding www as well is recommended.
  5. The portal shows "Waiting for DNS; ZoCloud checks every minute…", then "… points at ZoCloud. SSL is issued within minutes."

A domain not bought at ZoCloud may need a TXT record proving ownership: _zocloud.<domain> = zocloud-verify=… (the portal shows the exact value).

ZoCloud DNS (the record editor)

For domains on ZoCloud's nameservers, open the domain to see DNS of …:

  • Records ZoCloud keeps (for attached services): ZoCloud adds and removes them when you attach a name to a service or detach it. If you already have your own record with the same name, ZoCloud keeps yours.
  • Your records: click Add a record, fill in Name (@, www, mail…), Type, Value, Priority (MX and SRV only), then Save. Changes take effect within minutes.

Supported record types: A, AAAA, CNAME, MX, TXT, SRV, CAA, NS.

Business e-mail records (MX, SPF, DKIM…) are set automatically when you buy e-mail through ZoCloud, see Business e-mail (Google Workspace, Microsoft 365).

CLI/MCP: the dns_records, set_dns_record and remove_dns_record tools (see zo CLI and MCP server).

Connecting Cloudflare

Is your domain on Cloudflare? Connect it so ZoCloud creates the records for your services, turns the proxy on once SSL is ready, and (optionally) sets SSL to Full (strict). The Cloudflare section is at the bottom of the Domains page.

1. Create an API token

In Cloudflare → My Profile → API Tokens → Create Custom Token, grant:

Group Permission
Zone · Zone Read
Zone · DNS Edit
Zone · Zone Settings Edit
Zone · SSL and Certificates Edit
Zone · Zone WAF Edit
Zone · Cache Rules Edit

Select only the zones you need. Never use the Global API Key.

2. Connect

  1. Paste the token into the API token box and click Connect. The token is stored encrypted.
  2. Under Zones of …, click Use with ZoCloud for each zone. The option Set SSL Full (strict) and Always HTTPS for the whole zone applies to every proxied record in the zone, including your other sites, so turn it on only if all of those sites have valid certificates.
  3. Attach a name in the zone to a service: ZoCloud creates a CNAME, at first DNS only (waiting for SSL), then switches it to proxied once the certificate is valid. A record of yours with the same name is not overwritten ("you have a record here: ZoCloud does not overwrite it").

Once proxied, the domain accepts requests through Cloudflare only, and the service's .zocloud.app address sends visitors on to that domain. If you turn the proxy off in Cloudflare yourself, the site is blocked: turn the proxy back on or disconnect the zone. The app receives the visitor's real IP.

3. Rules on a connected zone

Protection (applies only to the names ZoCloud serves):

Level Effect
Off ZoCloud adds no firewall rules
Standard Blocks requests probing for secret files, admin tools and WordPress XML-RPC; limits the number of sign-in attempts from one address
Strict Like Standard, plus blocks requests without a user agent and challenges visitors before the sign-in page. Use it while the site is under attack
API For APIs and apps: blocks scanning requests and limits sign-ins, but never shows a challenge that a program could not answer

Other options:

  • Cache static files, never pages for signed-in users or /api.
  • Lock the origin to this zone (Authenticated Origin Pulls): once on, it shows locked.

If the portal reports that Cloudflare refused a rule or the origin lock, an older token lacks the Zone WAF, Cache Rules or SSL and Certificates permission: create a new token with all the permissions in the table above.

Disconnecting

  • Disconnect a zone: ZoCloud deletes the records it created in that zone.
  • Remove token: removes the token from ZoCloud.