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
- Open Dashboard → White-labelling.
- In the Custom Domain section, enter the domain (e.g.
app.yourcompany.com). Click Save. - 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
- Name:
- Add the record at your DNS provider (Cloudflare, Route53, etc).
- Once propagated (usually a few minutes), come back and click Verify Now.
- After verification, the page expands to show the A record or CNAME you need to add so the domain actually points at our servers.
- 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.
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.