The panel shows the VMStack brand until you set your own. Administrators set the panel's brand; resellers can be allowed a brand of their own that their customers see instead.
The panel's brand#
Go to System › Settings › Branding. The page has these sections:
| Section | Fields |
|---|---|
| Name | Product name: up to 40 characters. Used in page titles, on the sign-in page and as the panel's name in mail. |
| Logo | Two slots: one for light backgrounds and one for dark. If only one is set it is used for both. |
| Favicon | The browser tab icon (also used as the Apple touch icon). |
| Accent colour | The colour of primary buttons. Refused if the text on it would have a contrast below 4.5:1. Status colours (online, warning, fault) never change. |
| Sign-in page | A Message under the logo (plain text, up to 300 characters) and a Background image. |
| From name, From address and Footer: the same settings as System › Settings › Mail and Email templates. | |
| Help links | Support (an https:// link or mailto:) and Terms of service (https://). Shown under the sign-in form, at the foot of the sidebar for customers, and under every mail. Empty: not shown. |
Press Save. Reset to default (confirmed) goes back to the VMStack name, logo, favicon and colour and a plain sign-in page; the mail sender and footer stay.
Once a name or a logo is set, the VMStack logo is never shown by accident: where no logo is set, the name is written instead.
Image rules#
| Image | Formats | Limits |
|---|---|---|
| Logo | PNG, JPEG, WebP | at most 1 MB, 16 to 4000 px high |
| Favicon | PNG, JPEG, WebP | square, 32 to 2048 px, at most 512 KB |
| Background | PNG, JPEG, WebP | at least 640 px wide, at most 8000 px, at most 4 MB |
SVG is refused. Every upload is decoded and redrawn, so metadata and anything appended to the file are dropped. Logos are scaled to at most 192 px high and 1200 px wide, the favicon to 256×256, the background to a JPEG at most 2560 px wide.
Mail from the panel starts with the logo for light backgrounds, embedded in the message (no remote images, no tracking).
A reseller's own brand#
A reseller's brand is off until an administrator allows it.
- Open the reseller under Customers › Users.
- In Own brand and mail, tick Its own brand and, if wanted, Its own mail.
- Press Save.
Turning a switch off later keeps what the reseller set up, unused.
The reseller then has Customers › Branding in its sidebar, with two tabs.
Branding tab#
The reseller sets Your name (required: the brand is shown once it has a name), logos, favicon and accent colour (same rules as above), the sign-in message and background, Your own domain, help links and the footer of its customers' mail.
Who sees which brand:
- A signed-in reseller and its customers see the reseller's brand while it is allowed and named.
- Administrators and the panel's direct customers see the panel's brand.
- Before sign-in, the host name decides: a page opened on the reseller's own domain shows its brand.
- Anything the reseller leaves empty is plain (the neutral default), never the panel owner's name, logo, links or footer.
Own domain#
The panel only recognises the domain; it does not serve it. To make it work:
- The reseller enters a host name such as
panel.reseller.example.com(it must not be the panel's own host and must be unique among resellers). - A DNS record (for example a CNAME) points that name at the panel.
- Your web server or tunnel in front of the panel serves that name with a valid certificate and passes it to the panel.
The panel does not issue certificates for reseller domains, and links in mail still point at the panel's own address.
Mail tab#
With Its own mail allowed the reseller can:
- Write its own text for the mails its customers get (not administrator alerts or the reseller's own mails). Each mail is listed as "Your own text" or "The panel's text"; the editor is the same as Email templates, with a preview in the reseller's brand. Whether a mail is sent at all stays the panel's choice.
- Use my own mail server: Host, Port, Security (STARTTLS, TLS or none), User name, Password (stored encrypted, never shown again) and From address. Send a test to myself sends with the saved settings (5 an hour).
If the reseller's server fails (connection, TLS, sign-in or a server error), the same mail is sent through the panel's own mail from the panel's address with the reseller's sender name. The Mail log row says panel_fallback, and the reseller's Mail page shows "Failing since …" until a mail or test goes through again. Administrators see the failure on the reseller's page, where they can also clear the mark.
The reseller's customers' mail carries the brand: its name as sender name (unless the reseller set its own sender name under Settings › Notifications), its logo, footer and links. The domain of the reseller's From address must allow its server to send (SPF, DKIM).
API#
GET|PATCH /branding (scopes branding:read, branding:write) reads and changes text fields of the panel's brand for an administrator's key, or the reseller's own brand for a reseller's key. GET|PATCH /users/{id}/reseller-branding sets the two switches. Images, SMTP settings and mail text are changed in the panel only. See the API reference.
The billing modules ship with the VMStack logo for the billing system's module list; they do not take your brand.