Vortex Mail

← All guides

Add a Gmail account

Vortex Mail has no server of its own and, for now, no Google app of its own either: Gmail is reached with an app password, or with a small Google app that you create once, for free, in your own Google account.

This will get simpler. An official Vortex Mail Google app is being set up. Once it is available, adding a Gmail account will come down to “Sign in with Google”, without creating anything. This guide will be updated then.

Which method?

Mail only: app password

  1. In your Google account, turn on 2-Step Verification (Security › 2-Step Verification). Google requires it for app passwords.
  2. Create an app password at myaccount.google.com/apppasswords, named for example “Vortex Mail”. Google shows a 16-letter password: copy it.
  3. In Vortex Mail: Settings › Accounts › Add account, enter your Gmail address; the server settings are filled in.
  4. Paste the app password in the Password field, click Test settings, then add the account.

Mail, calendar and contacts: your own Google app

The app lives in your Google account and is only used by you. Creating it is free.

1. In the Google Cloud console

  1. Open console.cloud.google.com with your Google account and create a project, named for example “Vortex Mail”.
  2. In APIs & Services › Library, enable the CalDAV API and the CardDAV API (search for them by name).
  3. Set up the consent screen (Google Auth Platform, or “OAuth consent screen” depending on the console version): audience External, an app name, your address as support and developer contact.
  4. In Data access (or “Scopes”), add these three permissions by hand: https://mail.google.com/, https://www.googleapis.com/auth/calendar and https://www.googleapis.com/auth/carddav.
  5. In Clients (or “Credentials”), create an OAuth client ID of type Desktop app. Google gives you a client ID (ending in .apps.googleusercontent.com) and a client secret (starting with GOCSPX-).
  6. In Audience, either add your Gmail address as a test user, or publish the app (“In production”): see “Testing or in production” below.

2. In Vortex Mail

  1. Settings › Accounts › Add account, enter your Gmail address.
  2. In Authentication, choose OAuth2 (sign-in in the browser).
  3. Paste the Google client ID and the Client secret. They go into your system’s keyring and are never shown again.
  4. Click Sign in with Google: your browser opens. Choose your account and accept the permissions, then come back to Vortex Mail and add the account.

Mail, calendars and contacts of the account then appear in Vortex Mail. The same Google app can serve several of your Gmail addresses.

Testing or in production