How do I connect mobile devices to Citadel?
Citadel integrates seamlessly with modern mobile operating systems (iOS and Android) using open, standard internet protocols for email, calendars, and address books.
Calendars and Contacts (CalDAV & CardDAV)
Citadel includes native support for industry-standard CalDAV (calendaring) and CardDAV (contacts/address books).
Apple iOS (iPhone & iPad)
iOS includes native, system-level support for CalDAV and CardDAV accounts without requiring any third-party apps:
- Open Settings → Mail (or Calendar / Contacts) → Accounts → Add Account.
- Select Other.
- Choose Add CalDAV Account (for calendars) or Add CardDAV Account (for contacts).
- Enter your Citadel server hostname (e.g.,
citadel.example.org), along with your username and password.
- iOS will discover your calendars and address books automatically via standard service discovery.
Android
Android does not bundle CalDAV/CardDAV support into the base OS, but you can synchronize directly with Android's native Calendar and Contacts apps using DAVx⁵ (available on Google Play and F-Droid):
- Install and open DAVx⁵.
- Add a new account and choose Login with URL and user name.
- Enter your server address (e.g.,
https://citadel.example.org/) and your Citadel credentials.
- Select the calendar rooms and address book rooms you wish to synchronize. DAVx⁵ will sync them directly into Android's native calendar and contacts storage in the background.
Email (IMAP)
Mobile email clients connect to Citadel using standard IMAP for retrieving mail and SMTP for sending mail:
- Polling Interval: Citadel Server does not support the IMAP IDLE extension. Configure your mobile email client to use regular IMAP with a low refresh / fetch interval (such as every 5 or 15 minutes) so that incoming messages are retrieved promptly.
- Security: Always enable TLS encryption (IMAP over port 993 and SMTP submission over port 587 or 465) to protect your credentials and data over mobile networks.
- Recommended Apps: Any standard mobile IMAP client works seamlessly, including Apple Mail on iOS, as well as Thunderbird for Android, K-9 Mail, or FairEmail on Android.