Troubleshooting¶
The most common situations after installation and how to solve them.
| Symptom | Likely cause | Solution |
|---|---|---|
| The admin console does not open | Looking on 443 | Use https://<server>:9071/ and open 9071 in the firewall. |
| Profelis menus do not appear | Browser or zimlet cache | zmprov flushCache zimlet, then Ctrl+Shift+R. |
| No passkey button on the sign-in page | Passkey mode is off (default) | Turn it on in 2FA and passkey policy. |
| Two-factor authentication does not work | Class name mistyped ($ escaping) |
The zmlocalconfig value must show ProfelisTwoFactorAuth$AuthFactory in full; quote the command with single quotes. |
| The theme is not applied | Skin cache or write permission | zmprov flushCache skin; with server protection, reinstall in maintenance mode. |
| DLP does not block messages | Not connected to Postfix | sudo ./install.sh --wire-postfix; see DLP milter connection. |
| The mobile device list is empty | Z-Push or agent missing | Check the mobile agent installation and settings. |
| 403 when returning from the identity provider (SSO) | CSRF permission not active yet | zmmailboxdctl restart. |
Try these first
Caches, server protection maintenance mode and a hard browser reload solve most problems. Then run sudo ./install.sh --verify.
If you cannot solve a problem, contact Profelis support with the profelis lines from /opt/zimbra/log/mailbox.log.