Webmail, calendars and contacts
Open webmail from the panel without a password, sign in to SnappyMail directly, and sync each mailbox's calendars and contacts over CalDAV/CardDAV with phones and Thunderbird.
ZoPanel adds two optional services to the mail server: webmail (SnappyMail), for reading and sending mail in a browser, and calendars and contacts (Radicale), which gives every mailbox its own CalDAV calendars and CardDAV address books. Both sign in with the mailbox address and password. Install them when your users need mail without a desktop app or want their calendar and contacts synced across devices.
Install (administrator)
Both services need the mail server. See Email.
| Service | Install from | Port | Requirements |
|---|---|---|---|
| Webmail | Email → Install webmail, or Components → Webmail | 2096 | A PHP version installed on the server |
| Calendars and contacts | Components → Calendars & contacts (CalDAV/CardDAV) | 2080 | The mail server |
You can also choose them when installing the server: --with webmail,dav (see Installation). The installer opens the port in the firewall. Webmail downloads the latest SnappyMail release from GitHub, and calendars use the Radicale package of your distribution.
Both services use the panel's certificate. Set up Settings → Panel domain & SSL first, and open both services with the panel domain or the mail hostname (the certificate names both when the mail hostname points to the server) so that browsers and devices see a trusted certificate. See Panel settings.
Webmail
Open webmail from the panel (no password)
- Open Email and choose the domain.
- On the mailbox's row, click the envelope icon Open webmail (no password needed).
Webmail opens in a new tab, already signed in to that mailbox. Customers, resellers and administrators can do this for every mailbox they manage, and each login is recorded in the activity log.
How it works: the panel never knows mailbox passwords. Instead, the server issues a login code that opens only that one mailbox and is valid for 12 hours, and SnappyMail turns it into a single-use link valid for about 10 seconds. There is no master password. Changing the mailbox's password or deleting the mailbox revokes the code at once.
Sign in directly
Users who do not have panel access open:
https://<panel domain>:2096
and sign in with the full email address and the mailbox password. The Webmail button at the top of the Email page and in the Email client settings card opens the same address.
What to know about webmail
- Webmail connects to this server's IMAP and SMTP itself; there is nothing to configure per domain. The SnappyMail admin panel is turned off because ZoPanel manages the domains.
- One upload, such as an attachment, can be up to 25 MB.
- Filters and autoreplies are not edited in webmail. Use Rules and autoreply in the panel; they apply in webmail too. See Mail rules and limits.
- Mail sent from webmail counts toward the account's hourly sending limit like any other SMTP login.
- Mailboxes of a suspended hosting account cannot sign in.
Calendars and contacts (CalDAV/CardDAV)
Each mailbox gets its own calendars and address books on:
https://<panel domain>:2080/
Sign in with the full email address and the mailbox password. Each user sees only their own collections, which are stored under https://<panel domain>:2080/<address>/. Deleting a mailbox, or disabling email for its domain, also deletes its calendars and contacts.
Every mailbox starts with a calendar named Calendar (…/<address>/calendar/) and an address book named Contacts (…/<address>/contacts/), so apps that can only use existing collections, such as Thunderbird, have something to sync right away. Mailboxes that already had calendar data are left as they were. To add more calendars or address books, use an app that can create them: Apple Calendar and Contacts on iPhone, iPad and Mac, or DAVx⁵ on Android.
iPhone and iPad
- Open Settings → Calendar → Accounts → Add Account → Other (on recent iOS versions, Calendar is under Settings → Apps).
- Tap Add CalDAV Account.
- Server:
panel.example.com:2080. User Name: the full address. Password: the mailbox password. Tap Next. - The Calendar calendar appears in the Calendar app. To add another, tap Calendars → Add Calendar and choose this account.
For contacts, tap Add CardDAV Account in the same place and use the same values.
Mac
- Open Calendar → Settings → Accounts and click +, then choose Other CalDAV Account.
- Set Account Type to Advanced.
- Enter the full address and password, Server Address
panel.example.com, Server Path/, Port2080, and tick Use SSL. - Click Sign In. Add more calendars with File → New Calendar and choose this account.
For contacts, use Contacts → Settings → Accounts and add a CardDAV account with the same server, port and login.
Android (DAVx⁵)
Android has no built-in CalDAV or CardDAV support. Install DAVx⁵ (Google Play or F-Droid), then:
- Tap + and choose Login with URL and user name.
- Base URL:
https://panel.example.com:2080/. Enter the full address and the mailbox password, then tap Login. - Choose Create account.
- On the account screen, tick the collections to sync. Use the menu to Create calendar or Create address book if you want more.
The calendars and contacts then appear in the phone's own Calendar and Contacts apps.
Thunderbird
- Calendar: choose New Calendar → On the Network, enter the full address as Username and
https://panel.example.com:2080/as Location, click Find Calendars, enter the password and pick the calendars. - Contacts: in the address book, choose New Address Book → Add CardDAV Address Book, enter the username and
https://panel.example.com:2080/as the location, then pick the address books.
Outlook
Outlook does not support CalDAV or CardDAV by itself. It needs a third-party add-in that syncs CalDAV/CardDAV, such as the open-source Outlook CalDav Synchronizer.
Troubleshooting
| Message or symptom | Cause and fix |
|---|---|
| "webmail is not installed" | Install it with Email → Install webmail or in Components. |
| Installing webmail fails with "install a PHP version first" | Install any PHP version under Components, then install webmail again. |
| "webmail did not create a login link" / "webmail PHP version not found" | The webmail service is not running correctly. As administrator, check systemctl status zp-webmail and reinstall webmail if needed. |
| The one-click tab opens on the login screen | The link is valid for only a few seconds and only once. Click the icon again; do not reuse or bookmark the address. |
| Browser warns about the certificate on port 2096 or 2080 | Open the service with the panel domain or the mail hostname, after Settings → Panel domain & SSL is set up. |
| Port 2096 or 2080 does not load | The network you are on may block non-standard ports (common in offices and hotels). Try another network. |
| Calendar login keeps failing | Use the full address and the current mailbox password. After 6 failed logins, Fail2ban bans the IP; the administrator can lift it with Unban on Security. Mailboxes moved from another panel may need a new password (set it with the key icon) before calendars accept it. |
| Account is added but shows no calendars or contacts | The mailbox had calendar data before it got the default collections, or they were deleted. Create a calendar or address book from Apple Calendar, Apple Contacts or DAVx⁵. |