| Guide & Documentation
HU EN DE RO SK

White-label & Custom Domain

White-label & Custom Domain

The White-label feature allows each organization to access the application with its own branding – custom name, logo, colors and domain. This is especially useful when you run NationForge as a SaaS for multiple clients.


What can be customized?

Setting Description
Brand Name The application name shown in the browser tab and sidebar
Logo Organization logo displayed at the top of the sidebar
Favicon The icon shown in the browser tab
Primary Color The main color of the sidebar and UI
Subdomain e.g. myclient.nationforge.example.com
Custom Domain e.g. app.myclient.com

Where to configure

Go to the Organizations page, click the pencil icon, then scroll down to the White-label / Custom Branding section.


Uploading a logo and favicon

  • Logo: max. 2 MB, JPG / PNG / SVG / WebP. Shown at the top of the sidebar next to the app name.
  • Favicon: max. 512 KB, ICO / PNG / SVG. Shown as the icon in the browser tab.

Setting a brand name

Enter the name in the Brand Name field — this is what organization members see in the sidebar and browser tab, overriding the default application name.

If left empty, the organization's name is used.


Setting up a subdomain

  1. On the server, set the base domain in .env:
    APP_BASE_DOMAIN=nationforge.example.com
    
  2. In the organization editor, fill in the Subdomain field (letters, numbers, hyphens only — e.g. myclient).
  3. In your DNS manager, create an A or CNAME record:
    • myclient.nationforge.example.com → your server's IP or hostname

After this, the URL myclient.nationforge.example.com will automatically open the branded interface for that organization.


Setting up a custom domain

  1. In the organization editor, fill in the Custom Domain field (e.g. app.myclient.com).
  2. In the client's DNS manager, create a CNAME record:
    • app.myclient.com → your server's hostname
  3. Make sure your web server (Apache / Nginx) accepts this domain name (virtual host configuration).

Note: For HTTPS, an SSL certificate is required for the custom domain (e.g. via Let's Encrypt).


Domain lock

When someone opens the application via a custom domain or subdomain:

  • The system automatically sets the context to that organization
  • The organization switcher is hidden — the user only sees that organization's data
  • All branding (color, logo, name, favicon) matches the organization

Typical SaaS workflow

  1. You run NationForge on a single server
  2. Create an organization for each client in the admin panel
  3. Configure: brand name, logo, primary color, custom domain
  4. Set the CNAME record in the client's DNS
  5. The client accesses the app at e.g. app.theirparty.com — with their own branding, with no mention of NationForge anywhere

Important notes

  • Subdomain and Custom Domain must be globally unique (two organizations cannot share the same value)
  • Custom Domain format: subdomain.tld or sub.domain.tld (do not include the https:// prefix)
  • Subdomain may only contain ASCII letters, numbers and hyphens, up to 63 characters