Setup guide

Setting up Android Email

Complete guide to configuring your CodaMail account on Android devices with K-9 Mail.

← Back to Support Documentation

🛡️ Why K-9 Mail?

We recommend K-9 Mail, installed from F-Droid, over the default Android email app for several important reasons:

  • Better support for multiple identities (email aliases).
  • Built-in OpenPGP encryption support.
  • Enhanced privacy features.
  • More detailed configuration options.
  • Open-source software with regular security updates.

Our recommended choice is K-9 Mail from F-Droid. If you desire to remain as free from Google as possible, use the F-Droid version: it is compiled from source and does not contain the Google proprietary components included in Play Store builds, and it carries no telemetry.

What about Thunderbird for Android? K-9 Mail became Thunderbird for Android in 2024. Both apps remain available and are the same software under the hood, built and released together from the same source code, so every step in this guide applies to either one. We recommend K-9 Mail from F-Droid over Thunderbird from the Play Store.

📋 Before You Begin

Make sure you’ve created an App Password with IMAP or POP3 and SMTP enabled in Settings → App Passwords (in the webmail) before starting this setup process. This is required for external email clients to connect to your account; the app password takes the place of your account password in the client.

Android Setup Tip: Install K-9 Mail from F-Droid (recommended) or Thunderbird from the Play Store or F-Droid, and have your CodaMail username and app password ready.

⚙️ Step 1: Initial Setup

  • Launch K-9 Mail (or Thunderbird).
  • If this is your first time, continue past the welcome screen to add an account.
  • Enter your full email address and your app password.
  • Tap “Manual setup” and use the settings in the next two steps.

📧 Step 2: Incoming Server Settings (IMAP)

  • Server: mail.pnsh.com
  • Security: SSL/TLS
  • Port: 993
  • Username: Your account name only (do not include @codamail.com)
  • Authentication Type: Password
  • Password: Your app password

📤 Step 3: Outgoing Server Settings (SMTP)

  • Server: smtp.pnsh.com
  • Security: SSL/TLS
  • Port: 465
  • Require Authentication: Yes
  • Username: Your account name only (do not include @codamail.com)
  • Authentication Type: Password
  • Password: Your app password

✅ Step 4: Account Options

  • Account Name: Enter a name for this account (e.g., “CodaMail”).
  • Your Name: Your name as you want it to appear on outgoing messages.
  • Email Check Frequency: Set according to your preferences.
  • Tap “Done” to complete setup.

📮 Setting Up Multiple Identities (Aliases)

To use multiple email addresses or aliases for sending mail:

  • Open K-9 Mail (or Thunderbird).
  • Tap the three lines (hamburger menu) to open the navigation drawer, then open Settings.
  • Select your CodaMail account.
  • Tap Sending mail, then Manage identities.
  • Use the menu to add a New identity.
  • Fill in:
    • Description (optional name for this identity).
    • Email address (your alias address).
    • Your name (can be different for each identity).
    • Reply-to address (optional).
  • Tap the checkmark to save.

When composing a message, tap the “From” field to choose which identity to use.

🔐 Setting Up OpenPGP Encryption

K-9 Mail supports OpenPGP encryption with OpenKeychain:

  • Install OpenKeychain from F-Droid or the Google Play Store.
  • In K-9 Mail, go to Settings and select your account.
  • Select your CodaMail account.
  • Tap “End-to-end encryption”.
  • Select OpenKeychain as your crypto provider.
  • Follow the prompts to set up your keys.

🔧 Troubleshooting

If you encounter any issues:

Tip: Double-check that your username is entered without @codamail.com and that SSL/TLS is enabled for both servers.

  • Verify that IMAP and/or POP access is enabled in your app password settings.
  • Ensure SSL/TLS is enabled for both incoming and outgoing servers.
  • Verify the correct ports are being used (993 for IMAP, 465 for SMTP).
  • If using OpenPGP, ensure OpenKeychain is properly installed and configured.
  • Try restarting the app and attempting the setup again.
  • Contact our helpdesk if you continue to have problems.

📞 Need Help?

If you need additional assistance with setting up email on your Android device, 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 your Android device and takes advantage of CodaMail’s privacy-focused features and K-9 Mail’s advanced security capabilities.