BehindGate Docs

Appearance

Step-by-step walkthrough of the New site wizard in the dashboard.

Before you start ​

A site is created with a guided wizard. You choose how the site is reached: a BehindGate subdomain, which is live instantly, or a Custom domain you own, pointed at us with a single DNS record. A subdomain site has six steps; a custom domain adds a Provisioning step (seven steps) while it waits for DNS to resolve and a TLS certificate to be issued.

The site is created when you leave the Address step. The later steps then act on the real, existing site.

Open the wizard ​

  1. In the sidebar, select + New site.

If your workspace has no sites yet, you'll see No sites yet and Create your first site to start hosting., and the wizard may open automatically as Create your first site.

Step 1: Name ​

Give your site a name.

  1. Enter a Site name. A suggested subdomain is derived from it for the Address step.
  2. Select Continue.

Step 2: Domain ​

Choose how your site is reached.

  • BehindGate subdomain: Reachable instantly at a .{...} address, secured automatically.
  • Custom domain: Use a domain you own. Add one DNS record and we'll issue a TLS certificate. (Where a custom domain isn't available for the environment, this option is disabled and shows Not available in this environment yet.)

Select Continue.

Step 3: Address ​

Set your site's address. The site is created when you leave this step.

For a BehindGate subdomain:

  1. Enter a Subdomain (lowercase letters, numbers and hyphens, up to 63 characters, with no leading or trailing hyphen).
  2. Check the preview under Your site will live at, which shows the full URL your site will be reachable at.

For a custom domain:

  1. Enter your domain under Your domain (for example app.example.com).
  2. Add the DNS record the wizard shows: Add this DNS record at your provider. We'll issue a TLS certificate once it resolves: It is a single CNAME record pointing your domain at the target shown.

Select Continue to create the site.

Step 4: Provisioning (custom domains only) ​

A custom domain has to wait for DNS to resolve and for its certificate to be issued, so it goes through a Provisioning step. A BehindGate subdomain is live immediately and skips it, which is why a subdomain site shows six steps instead of seven.

  1. Add the CNAME record shown (the same record as the Address step) at your DNS provider if you haven't already.
  2. Leave the wizard open. It shows Waiting for DNS. Your site is provisioned automatically once it resolves. and keeps checking.
  3. Once your domain resolves, a managed TLS certificate is issued and the site goes live automatically.

You can safely close the wizard. The site keeps provisioning in the background and comes online on its own, so you can also continue later from the site's page.

Step 5: Sign-in ​

Choose how visitors sign in. The wizard shows Choose how visitors sign in. Your site stays private by default.

  1. Choose a sign-in method:

    • Email one-time code: People sign in with a code sent to an email you allow.
    • Google Workspace: Anyone in your Google Workspace can access the site. (SSO)
    • Microsoft Entra ID: Sign in with Microsoft Entra ID. You can configure more detailed access in Entra. (SSO)

  2. Select Continue.

Step 6: Sign-in details ​

Configure the method you chose. Continuing saves the sign-in here, so any validation or error surfaces on this step rather than later at Finish.

If you chose Email one-time code:

  1. Under Allowed email domains, add the domains whose users can sign in. Anyone with an email at these domains can sign in.
  2. Optionally add individual addresses under Allowed email addresses for guests outside those domains.
  3. Add at least one allowed domain or address.

If you chose Google Workspace:

  1. Under Google Workspace domain(s), add every domain your organization uses. Only accounts in these domains can sign in.
  2. Enter the Client ID and Client secret from your provider.

If you chose Microsoft Entra ID:

  1. Enter the Directory (tenant) ID. This restricts sign-in to your Entra directory, so only accounts in your organization can sign in.
  2. Enter the Client ID and Client secret from your provider.

Select Continue to save the sign-in settings.

Step 7: First deploy ​

Upload your first release to the root app, or skip and deploy later.

  1. Choose an Upload type:

    • Zip file: A single .zip of your built site.
    • Folder: Pick your build output folder. We'll upload its files.

  2. Select Upload & finish to upload now.

To skip content for now, tick Skip upload and prepare the site manually, then select Finish. Finish stays blocked until you choose a build or tick skip, so an empty site is always deliberate. If you ticked skip, any build you picked is ignored.

On finish, an uploaded build is extracted and published before the next step, so your content is live by the time the success screen appears.

Step 8: Done ​

A success screen confirms Your site is ready.

  1. Use the link to open your live site in a new tab. If it shows a 404 at first, give it a moment while the new site propagates to the edge.
  2. Select Close to land on your new site's page.

The site is kept once you reach this screen. Only an earlier Cancel deletes it.