White-label the customer panel

Why white-label

If you're reselling hosting, your customers shouldn't see "NovaPanel" anywhere — they should see your brand. White-label mode replaces the logo, favicon, panel name and login-page copy so the panel looks like a product you built.

This is a Pro-tier feature. Community installs can't enable it. Confirm Pro at https://<your-host>:2087/license.

What gets replaced

• Logo. Top-left of every page, and on the login page. PNG or SVG, ~28-32px tall.
• Favicon. Browser tab icon. SVG preferred so it scales to any tab density.
• Panel name and company name. Replaces "NovaPanel" in the sidebar and in the browser tab title.
• Login page copy. Replace "Sign in to NovaPanel" with your own welcome title and subtitle, plus a login background image.
• Footer, legal links and support email. Your own footer HTML, terms and privacy URLs, and a support address on the login page instead of support@novapanel.dev.

What does NOT change. Two things people expect to be covered and aren't:

• The UI colours. The brand palette is compiled into the stylesheet, so buttons, links and badges stay NovaPanel blue whatever you set. See Step 3.
• Notification emails. The alert emails the panel sends are NovaPanel-branded in the template itself — they embed our logo and wordmark and cannot be re-skinned. They only ever go to your own admin address, though, so no customer sees one. See Step 5.

Note also that branding is not customer-panel-only: the admin panel on port 2087 picks up the same logo, panel name, tab title and favicon, and its login page renders your custom logo, welcome title, subtitle and footer HTML too.

Step 1 — Open Branding settings

Admin → Branding — it's its own item in the sidebar, under Config, not a page inside Settings. Locked behind a Pro license; if saving fails with an upgrade message you're on Community.

Step 2 — Point at your logo

In Logo & Favicon. There's no uploader — the logo and favicon are plain URL fields, so host the files yourself (your own site, a CDN, an S3 bucket) and paste the address in. A small static preview appears beside each field once the URL resolves. Both PNG and SVG work; SVG is sharper. Aim for ~32px tall — wider is fine, the panel scales width to fit.

There's one logo slot, used everywhere: the login page and the sidebar both draw the same image. There is no separate login logo, and no "Advanced" section.

Step 3 — Colours (don't bother)

The Colors card has two pickers, Primary Color and Accent. They currently have no visual effect: they set CSS variables that no stylesheet reads, while the actual brand palette is compiled into the build from tailwind.config.js. Whatever you pick, buttons, links and badges stay NovaPanel blue.

Set them anyway if you like — the values are stored, so they'll take effect when the palette becomes dynamic — but don't hold up a launch over them, and don't promise a customer a colour-matched panel. There's also no contrast or accessibility checker.

Step 4 — Customise the login page

In Login Page:

• Welcome Title: e.g. "Sign in to Acme Hosting"
• Subtitle: short subline, e.g. "Manage your sites, mail, and DNS in one place."
• Background Image: a URL, same as the logo
• Show feature highlights: toggle off for a plainer login

Footer copy is not here. The Legal & Footer card further down has Terms of Service and Privacy Policy URLs plus a raw Footer HTML textarea — that's where "Need help? Email us" belongs. It is rendered as unescaped HTML, so only paste markup you control. The Support Email field in the General card is separate again, and shows up as a bare mailto: link in the login footer only — there's no "Need help?" link anywhere inside the panel itself.

Step 5 — Outbound email

There is nothing to white-label here, and it's worth knowing why before you promise a customer otherwise. NovaPanel only sends one kind of mail: operational alerts, and only to your admin address. There is no customer-facing mail in the product at all — no password-reset email, no mailbox-quota warning to the account owner.

You can set the From address those alerts come from: Admin → Settings, in the Notifications card, the From address (optional) field. There is no Reply-to field. The message body itself is fixed and NovaPanel-branded — it embeds our logo and wordmark — but since it only reaches you, that isn't a leak.

If you do set a custom From address, make sure that domain has matching SPF / DKIM records — see email setup for the right DNS to publish.

Step 6 — Save and verify

Click Save Branding — nothing you've typed is stored until you do. Preview next to it isn't a preview pane; it just opens the panel in a new tab, so save first or you'll be looking at the old branding. Then open a private/incognito window at https://<your-host>:2083 (the customer panel) and check your logo and copy. Try logging in as a test customer to confirm the post-login pages all carry the brand.

Reverting

On the Branding page, click Reset to Default. That only refills the form with the stock values — it saves nothing, so follow it with Save Branding to actually restore NovaPanel's stock UI (and if you change your mind, just navigate away without saving). Your customer accounts and data are untouched either way — only the visual layer changes.