This page is for owners and administrators who want Hermetry to look like their own application to their members and customers. It puts the steps in order and says what each one changes. The fields themselves are explained in Branding and Web addresses and custom domains; this page links there instead of repeating them.
Everything here is done inside your own organisation, by its own owners and administrators.
Before you start
| You need | Why |
|---|---|
| The Admin role | To change branding and the mail sender, and to verify a domain |
| The Owner role | To add or delete a custom domain, make a domain primary, and reset all branding at once |
| A plan that includes custom domains | Only for step 2. The Domains page says “Your plan includes up to n custom domains.” when it does. |
| Access to your DNS provider | To prove you own the domain and point it to Hermetry |
| Your images, ready as PNG, JPEG, GIF, WebP, AVIF or ICO | SVG is not accepted. Sizes are in the table in step 1. |
| A sender address of your own | For step 4, for example alerts@example.com |
Step 1: brand the app and the sign-in page
Open Branding (Settings > Branding). The page has three cards.
- In Visual Identity, upload the images and pick the two colours. An uploaded image is saved at once (“Logo (light theme) saved.”); colours are saved with Save Branding.
- In Brand Info, enter the Brand Name and the Tagline. Left empty, the organisation’s own name is shown.
- In Sign-in page, upload a Sign-in wallpaper and enter a Privacy policy address and a Terms of service address. They appear under the sign-in card. Left empty, no link is shown.
- Select Save Branding. The page says “Branding saved.”
| Field | Prepare |
|---|---|
| Logo (light theme) | A horizontal logo, 48 px tall, at most 192 px wide |
| Logo (dark theme) | The same on a dark background. Without it the light logo is used. |
| App icon (light theme) | A square image, shown at 28 px in the header. Without it the favicon is used. |
| App icon (dark theme) | Without it the light icon is used |
| Favicon | A square PNG or ICO image, 32 × 32 px or larger |
| Sign-in wallpaper | A wide photo or pattern, 1920 px wide or more |
| Primary Color, Secondary Color | Hex colours such as #1a2b3c |
| Privacy policy and terms addresses | An address that starts with https://, or with a single / for a page on the same site |
Watch the notes under each colour. Hermetry warns when text on buttons in the colour is hard to read (below 4.5:1) or when links in it are hard to see on a white page (below 3:1), and tells you when buttons use a slightly darker shade so their text stays readable. To go back to the default for one colour, choose No color in the colour picker and save. To remove an image, select Remove and save.
A field you leave empty uses the platform look. Fields and tips are in Branding.
Step 2: connect your own domain
Every organisation keeps its free address, <slug>.<platform domain>. It always works and cannot be removed, so it stays your way back in whatever happens to a custom domain.
- Open Domains (Settings > Domains) and select Add Domain. Use a subdomain such as
iot.example.com. Adding a domain needs the Owner role. - At your DNS provider, create the two records the page shows: the CNAME that points your domain to Hermetry, and the DNS Challenge Record that proves you own it.
- Open the domain and select Verify DNS. On success the page says “Domain verified successfully.” DNS changes can take up to 48 hours to reach everyone; if verification fails, wait and verify again.
- Wait a few minutes, then select Force SSL check. You never upload a certificate: Hermetry obtains one for the verified domain and renews it itself. The domain serves once a check sees its certificate working.
The records, the statuses and the certificate card are explained in Web addresses and custom domains.
Step 3: make your domain the primary
The primary domain is the address Hermetry uses in links it builds for your organisation, for example in notification mail. Your free address is primary until you change it.
- Open the domain and select Make primary. It is offered only for a verified domain whose certificate is in place.
- Confirm Make this the primary domain? (“Links and e-mails will use iot.example.com.”).
Making a domain primary needs the Owner role. While the primary domain does not serve, for example because the plan no longer includes it, links use your free address instead, so a link always lands on an address that works. If you delete the primary domain, your free address becomes primary again.
Step 4: set the mail sender
Open Email (Settings > Email). In Sender Identity, enter a From Name and a From Email and save. The From Name is used only together with a From Email; without a From Email, mail goes out from the platform’s sender.
If the page also shows SMTP Configuration, your organisation may send through its own mail server; fill it in with your provider’s details. If it does not, mail goes out through the platform’s mail service.
You do not edit the mail templates. Every mail Hermetry sends for your organisation is filled with your brand: the brand name, the logo, and the primary colour on its buttons. Mail never carries the favicon, the wallpaper or the legal links. Delivery, quotas and spam advice are in Email.
Note
Account and security mail (sign-in codes, password resets, e-mail verification, invitations) shows your brand but is always sent from the platform’s own sender, and its links open on the platform’s main address, not on your domain.
Step 5: check what people see
Open a private browser window and go through what a member or customer sees.
| Where | What they see |
|---|---|
| The sign-in and sign-up pages at your free address or custom domain | Your logo, brand name, colours and wallpaper, the privacy and terms links under the card |
| The browser tab | Your favicon |
| The app after sign-in | Your app icon in the header, your brand name, your colours on buttons, links, highlights and charts, in both light and dark theme |
| Notification mail | Your brand name, logo and button colour, your sender identity, links on your primary domain |
| Account and security mail | Your brand name, logo and button colour, the platform’s sender, links on the platform’s main address |
Members who belong to several organisations and sign in on the platform’s main address pick the organisation after signing in. To land them on your branded sign-in page directly, share your custom domain or your free address.
If something does not look right
| Message or symptom | Cause | Fix |
|---|---|---|
| “Choose a PNG, JPEG, GIF, WebP, AVIF or ICO image. SVG is not accepted.” | The image is an SVG or another type | Export it as PNG or WebP |
| “The image is too large.” | The file is over the upload limit | Make the file smaller |
| “… is locked by the platform operator and cannot be changed here.” | The platform operator fixed this field | Leave it; the other fields still save |
| “Someone changed the branding after you opened this page. Your changes are still here; reload to see theirs.” | Another administrator saved in the meantime | Copy your changes, reload, and apply them again |
| Dark text on a dark header | No dark-theme logo or icon | Upload Logo (dark theme) and App icon (dark theme) |
| “Verification failed. Check your DNS settings.” | The challenge record is missing or not visible yet | Check the record at your DNS provider and verify again later |
| Make primary is not offered | The domain is not verified, or its certificate is not in place yet | Finish step 2, then select Force SSL check |
| Your domain shows Paused (not in plan) | The plan no longer includes the domain | Your free address keeps working; the domain comes back when the plan includes it again |
| Mail still shows the platform’s sender | No From Email is set, or it is account and security mail | Set a From Email in step 4; security mail always uses the platform’s sender |
To start again from the platform look, an Owner selects Reset to defaults on the Branding page and confirms Reset branding. It clears every branding field: logos, icons, favicon, colours, wallpaper, name, tagline and legal links.

