Your logo in webmail and Colabora

01 Test your logo

Choose the logo file. The simulator suggests the colors, shows how the webmail sign-in, the inbox and Colabora look, and builds a .zip with everything the panel needs to activate your brand: the logo and symbol already at the right size, the colors and the addresses.

Your logo does not leave your computer. Everything happens in your browser: nothing is sent to lua.email until you yourself upload the .zip in the panel.

Choose the logo or drag the file here. PNG, SVG, JPG or WebP, preferably with a transparent background.

What goes in the .zip

• yourcompany-logo.png: the logo at 128 pixels tall and up to 440 wide, tightly cropped, for the webmail and Colabora sign-in, printing and the empty reading pane.
• yourcompany-simbolo.png: the symbol at 256 × 256 pixels, for the top of the sidebar, the browser tab, the phone shortcut and the top of Colabora.
• marca.json: the company name, the two addresses and their DNS records, the website or support link, the colors (main, accent and text), the top bar and the theme.
• LEIA-ME.txt: the next steps. And the original folder, with the file you chose, unchanged, if it is up to 2 MB.

02 Summary

03 Where the logo appears

The change applies only to your company's address. People who sign in through webmail.lua.email still see the lua.email brand.

Dark mode: each person can turn on dark mode in webmail. The sign-in screen stays light. Inside webmail, the background turns dark, the top bar stays in the main color (or graphite, if you choose it) and links use the pure main color. In Lua Next, links and buttons use the main color adjusted to read well on the dark background, and the side bar stays dark or in the main color. The symbol sits on the top bar in both modes: if it has the same color as the bar, choose the graphite bar or send a symbol with a background. In the simulator, switch "Screen mode" to check.

We ask for double the size shown on screen (440 × 128 for a 220 × 64 space) so the logo stays sharp on high-density screens, like recent laptops and phones.

04 Main logo

• Horizontal: symbol and name side by side work better than the stacked version.
• Tight crop: don't leave extra transparent margin around it. The whole image is fitted into the space, so empty margin makes the logo smaller.
• Different proportion: keep the height at 128 pixels and adjust the width up to 440. A squarer logo can be, for example, 256 × 128.
• Readable when small: on the sign-in screen the logo is at most 64 pixels tall. Slogans, addresses and thin lettering disappear at that size. Use the version without a slogan.
• Colors: the sign-in screen has a white background. Inside webmail, users can turn on dark mode, and an all-black logo disappears against the dark background. Prefer a colored version that works on both backgrounds.

05 Square symbol

In small spaces, like the top of the sidebar (about 28 × 28 pixels) and the browser tab icon, a horizontal logo is too small to read. That's why we also ask for the brand's symbol on its own, without the name. Without the symbol, we use the main logo scaled down in those places.

• PNG with a transparent background, 256 × 256 pixels.
• Symbol centered, filling almost the whole square.
• If your brand has no symbol, send the initial of the name in the style of the logo.

06 How to send it and what happens next

1. Use the simulator and download the .zip. It already has the logo and symbol at the right size, named yourcompany-logo.png and yourcompany-simbolo.png, and a file with the company name, the addresses and the colors. If you prefer to prepare them by hand, name the files this way.
2. Sign in to the panel as the domain administrator, open the domain and, in the domain settings, click Webmail with your brand. Click Upload brand .zip, choose the file and check the preview of what will change; nothing is saved until you Confirm and apply. If you prepared the files by hand, fill in the fields on the screen itself (name, site, colors, logo and symbol) and click Save. Step by step with screenshots in the panel manual.
3. Create the DNS records for the two addresses, webmail and Colabora (chapter 07). You can create them right away: they don't change anything in your email.
4. On confirming, the panel turns on both addresses by itself (there is no button to turn them on). If the DNS is at Edgium, it is automatic. If it is at another provider, the screen shows the DNS records to copy (two IP addresses and a TTL of 300 seconds): create those records and click Check now. The screen shows the progress of each name. Until the DNS is set up and validated, webmail and Colabora with your brand do not work: use the regular webmail. The whitelabel is per domain and has no cost for now.
5. Once the DNS records are live, the certificate and HTTPS follow on their own (the panel checks by itself every hour; use Check now if you have already created the records). The panel follows the DNS, CDN, Certificate and HTTPS steps and runs a final access test; while it runs, the state is Checking access. When it is ready, the domain administrators get an email. Then just open webmail.yourcompany.com and colabora.yourcompany.com and check.

To change the logo later, just upload a new .zip the same way. The change does not take the webmail offline, and browsers show the new version on their own, with no need to clear the cache.

07 Addresses and DNS records

Your brand needs two addresses on the company domain. The simulator fills in both when you type the domain, and they go in the .zip.

Create both in your domain's DNS, pointing to lua.email. The final values appear in the panel, on the webmail with your brand screen; the ones below are the simulation values:

webmail.yourcompany.com.   3600  IN  A  168.196.92.254
webmail.yourcompany.com.   3600  IN  A  168.196.93.254
colabora.yourcompany.com.  3600  IN  A  168.196.92.254
colabora.yourcompany.com.  3600  IN  A  168.196.93.254

• The addresses only open after the DNS points to lua.email. Once both records are live, the certificate (the browser padlock) and HTTPS follow on their own. Before that, the browser cannot find the address or shows a security warning.
• If your domain's DNS is on Cloudflare, leave these two records without proxy (gray cloud). With the proxy on, the certificate can't be issued and the webmail sign-in at Colabora won't work.
• In DNS panels that ask only for the name, type webmail and colabora, without the domain and without the trailing dot.

If your company email is at lua.email

The records below only apply when your mailboxes are hosted with us. If your email stays with another provider, don't change them: create just the two addresses above. The exact values for your domain, including the DKIM key, are in the painel.lua.email admin panel, ready to copy. The format is this:

; receive: the domain's email goes to lua.email
yourcompany.com.                      3600  IN  MX   5 mx.secure.edgium-dns.net.

; send: authorizes lua.email (a single SPF record per domain)
yourcompany.com.                      3600  IN  TXT  "v=spf1 include:spf.lua.email -all"

; signature: selector and key of YOUR domain, copied from the panel
<seletor>._domainkey.yourcompany.com. 3600  IN  TXT  "v=DKIM1; k=rsa; p=<chave do painel>"

; policy and reports (start with p=none)
_dmarc.yourcompany.com.               3600  IN  TXT  "v=DMARC1; p=none; rua=mailto:dmarc@yourcompany.com; adkim=r; aspf=r; pct=100"

; Outlook, iPhone and the phone's Exchange account set themselves up automatically
_autodiscover._tcp.yourcompany.com.   3600  IN  SRV  0 0 443 autodiscover.lua.email.

; optional: contacts and calendar through the domain (iPhone, Mac, DAVx⁵)
_carddavs._tcp.yourcompany.com.       3600  IN  SRV  0 1 443 dav.lua.email.
_caldavs._tcp.yourcompany.com.        3600  IN  SRV  0 1 443 dav.lua.email.

; optional: programs that find IMAP and SMTP through the domain
_imaps._tcp.yourcompany.com.          3600  IN  SRV  0 1 993 mail.lua.email.
_submission._tcp.yourcompany.com.     3600  IN  SRV  0 1 587 mail.lua.email.

; optional, recommended: automatic email setup (phone and email programs); use the value shown in the panel
autodiscover.yourcompany.com.         3600  IN  A    <value shown in the panel>
autoconfig.yourcompany.com.           3600  IN  A    <value shown in the panel>

What each record does, how to check it and what to avoid is in the DNS chapter of the webmail manual.

08 Before you send

• PNG with a transparent background
• Main logo at 440 × 128 pixels (or 128 tall and up to 440 wide)
• Cropped tight, with no leftover transparent margin
• No slogan or small text
• Visible on both white and dark backgrounds
• Square symbol of 256 × 256 pixels
• Company name for the tab title
• Domain and the two addresses: webmail. and colabora. (or another name for Colabora)
• DNS records for the two addresses created
• Top bar (Lua+) or side bar (Lua Next) in the main color or dark, the default theme, and whether people can switch theme and color
• Support link (optional), starting with https://
• Brand main color in hexadecimal (optional, for the Lua+ and Lua Next themes)
• Each file up to 200 KB

Questions about the file? Write to suporte@lua.email or see the contact page.

09 Frequently asked questions