Setup guide

Setting up Evolution

Complete guide to configuring your CodaMail account in Evolution for Linux.

← Back to Support Documentation

📋 Before You Begin

Ensure that you’ve created an app password in Settings → App Passwords with IMAP/POP access enabled before starting this setup process. This is required for external email clients to connect to your account.

Evolution Tip: Evolution is the default email client for GNOME desktop environments and provides excellent integration with Linux systems. Have your CodaMail username and password ready.

🚀 Step 1: Open Evolution Account Setup

  • Open Evolution on your Linux system.
  • If it’s your first time running Evolution, the setup assistant will start automatically.
  • Otherwise, go to File → New → Mail Account.
  • Click Next to begin the setup process.

📧 Step 2: Identity Information

  • Enter your identity information:
    • Full Name: As you want it to appear in messages
    • Email Address: Your full CodaMail address (e.g., username@codamail.com)
    • Reply-To: Leave blank unless you want replies sent to a different address
    • Organization: Optional
  • Click Next to continue.

📥 Step 3: Receiving Email (IMAP) Configuration

  • Select Server Type: IMAP.
  • Configure the server settings:
    • Server: mail.pnsh.com
    • Username: Your account name only (without @codamail.com)
    • Port: 993
    • Use secure connection: SSL on a dedicated port
  • Authentication:
    • Authentication: Password
    • Check “Remember password” if desired.
  • Click Next to continue.

📤 Step 4: Sending Email (SMTP) Configuration

  • Select Server Type: SMTP.
  • Configure the server settings:
    • Server: smtp.pnsh.com
    • Port: 587 (or 465 for SSL)
    • Server requires authentication: Checked
    • Use secure connection: STARTTLS after connecting (for port 587)
  • Authentication:
    • Type: PLAIN
    • Username: Your account name only (without @codamail.com)
    • Check “Remember password” if desired.
  • Click Next to continue.

✅ Step 5: Account Options and Summary

  • Configure account options:
    • Check for new messages every: 10 minutes (adjustable)
    • Automatically synchronize remote mail locally: Recommended for offline access
  • Enter an Account name: (e.g., “CodaMail” or “Personal Email”).
  • Review the account summary to ensure all settings are correct.
  • Click Next and then Apply to complete the setup.
  • Evolution will now test the connection and start synchronizing your email.

⚙️ Advanced Settings & Features

Folder Subscriptions

To manage which IMAP folders are visible in Evolution:

  • Right-click on your CodaMail account in the folder list.
  • Select Properties.
  • Go to the Receiving Options tab.
  • Click Show only subscribed folders.
  • Use the subscription manager to select which folders to display.

Integration with GNOME

  • Calendar Integration: Evolution includes built-in calendar support.
  • Contacts: Address book integration with GNOME Contacts.
  • Desktop Notifications: New mail notifications in the GNOME shell.
  • GNOME Online Accounts: Can also be configured through System Settings.

📅 Calendar & Contacts Sync

Evolution has excellent support for CalDAV and CardDAV synchronization with CodaMail:

  • Calendars: Go to File → New → Calendar and select CalDAV.
  • Contacts: Go to File → New → Address Book and select CardDAV.
  • Use the random username and random password you generated using Settings → DAV Server.
  • See our complete DAV setup guide for detailed server URLs and instructions.

🔧 Troubleshooting

If you encounter issues during setup:

  • Authentication Failed: Ensure your username is entered without @codamail.com in both IMAP and SMTP settings.
  • Connection Issues: Verify that your firewall allows connections on ports 993 (IMAP) and 587 (SMTP).
  • SSL Certificate: Accept the certificate if prompted, our certificates are valid and secure.
  • Folder Not Showing: Check folder subscriptions as described in Advanced Settings.
  • Sending Failed: Double-check SMTP authentication is enabled with the correct username.
  • Slow Performance: Adjust synchronization settings to download headers only for large folders.

Distribution-Specific Tips

  • Ubuntu/Debian: Install Evolution with: sudo apt install evolution.
  • Fedora: Evolution is pre-installed, update with: sudo dnf update evolution.
  • openSUSE: Install with: sudo zypper install evolution.
  • Arch Linux: Install with: sudo pacman -S evolution.

📞 Need Help?

If you need additional assistance with Evolution setup or encounter any issues not covered in this guide, please contact our support team at helpdesk@codamail.com.

We’re here to help ensure your email setup works perfectly with Evolution on your Linux desktop.