White-labelling and custom domains

Run the workspace, the client portal, or short links on your own domain.

If your team is on a paid plan with the White-labelling feature enabled, you can run Nexus ERP on your own domain instead of nexuserp.dev. There are three independent custom-domain slots:

  • Workspace domain, replaces nexuserp.dev/workspace/<slug>.
  • Client portal domain, replaces nexuserp.dev/portal/<slug>/signin.
  • Short-link (URL) domains, for branded short links from your Marketing module.

All three live under Dashboard → White-labelling.

Setting up a workspace domain

  1. Open Dashboard → White-labelling.
  2. In the Custom Domain section, enter the domain (e.g. app.yourcompany.com). Click Save.
  3. The page shows an amber alert with a TXT record to add to your DNS.
    • Name: _erp-verify.<your domain>
    • Type: TXT
    • Value: the random token shown
  4. Add the record at your DNS provider (Cloudflare, Route53, etc).
  5. Once propagated (usually a few minutes), come back and click Verify Now.
  6. After verification, the page expands to show the A record or CNAME you need to add so the domain actually points at our servers.
  7. Add that record. After propagation your workspace lives at the new URL.

Once the domain is verified, the slug field becomes read-only, your custom domain becomes the canonical URL.

Setting up a client portal domain

Same flow as above, but in the Client Portal Domain section. The TXT record name is _erp-portal-verify.<your domain> (different prefix to keep it separate from the workspace domain).

You can run the portal on a totally different domain from your workspace, e.g. app.yourcompany.com for the team, clients.yourcompany.com for customers.

Setting up short-link domains

Add as many as you like in the URL Domains section. Each one goes through the same TXT verification, then a CNAME to point traffic at us. You'll be able to pick which domain to use when generating a short link from the Marketing module.

App name and favicon

In the same page you can also set:

  • App name, used in browser tab titles and home-screen icon labels (max 60 characters). Defaults to your org name.
  • Favicon URL, a publicly-accessible image URL (PNG/SVG, ideally a square 32×32 or 64×64). Falls back to the org logo if empty.

Permissions you'll need

You need Manage Org plus the White-labelling feature flag enabled for your org. The feature flag is enabled by your platform admin, it's not self-serve.

Don't delete your DNS records

Once your domain is live, removing the TXT or A/CNAME records will take the workspace offline. If you ever rotate domains, set up the new one fully, switch users to it, then retire the old DNS.