Translations of this page?:

Gmail configuration

Gmail accounts are fully supported by the Feng Office e-mail client.

While Feng Office auto-detects Gmail accounts and fills out most of the configuration information automatically, it is always helpful to know that:

  1. Your Gmail accounts must allow access from external clients.
  2. If the browser auto-fills your password, it may be entering a wrong password.
  3. Google may be preventing access to your account through different security measures

So if you can't connect immediately (or Feng Office says 'connected' but retrieves 0 e-mails), don't despair. You'll get it to work. But you may need to check for connection issues following the checklist and instructions below.

Troubleshooting your gmail connection

Depending on the way your Gmail or GoogleMail account is set up, the following obstacles may arise:

  • You don't have IMAP access enabled on your Gmail account.
  • Your Gmail account is blocking external application.
  • Your Gmail account has 'captcha' activated for log-in.
  • Your Google account has two-way authentication enabled.
  • Other Gmail configuration issues

Here is how to troubleshoot each one of them:

You don't have IMAP access enabled on your Gmail account

Your account is not enabled for IMAP use.

Please visit your Gmail account settings page and enable your account for IMAP access.

Here are the steps:

  1. Sign in to your Google account.
  2. Click on Settings in the upper-right corner of your gmail screen.
  3. Click on the ‘Forwarding and POP/IMAP’ tab.
  4. In the IMAP Access section, click on Enable IMAP.
  5. Click on Save Changes.

Gmail account is blocking external application

Gmail may be blocking external applications (including Feng Office).

If that is the case, you can enable it here:

Here are the steps:

  1. Log in to your Gmail account and do the following
  2. Click on your profile picture (top right corner) and then select My Account
  3. Click on Sign-in & security
  4. Scroll down to the Connected apps and sites section and click on Manage apps
  5. Scroll down to the Recent Activity section, and access to Devices. In there, make sure that Gmail is not blocking the server where Feng Office is running. For instance, if you are setting this email account in Feng Office's cloud, do not worry if you see there is connection attempt from Germany or the USA as we have our servers for trials there.

Gmail account account has 'captcha' activated

Gmail is not letting you connect because your account has the “Captcha” security setting activated. If that is the case, you can disable the “captcha” feature here:

Unlock the Gmail CAPTCHA

Your Google account has two-way authentication enabled

If you have two-step authentication enabled ( Learn more about Google two step authentication here) you need to create a 16-digit passcode to give Feng Office permission to access your Google Account.

Here are the steps to do it:

  1. Click on Get Started
  2. Follow instructions on the page
  3. Generate a password for Feng Office
    • This will give you a 16 character code in a yellow bar. Copy that password and paste it in your Feng Office e-mail settings.
  4. Done!

Once you are finished, you won't see that App password code again. However, you will see a list of apps and devices you’ve created App passwords for.

The generated password is the one to be used when configuring the e-mail account in Feng Office

See more details here:

Other Gmail configuration issues

Your account may have a different set of configuration values than the standard.

If that is the case, you may need to change the default configuration retrieved by Feng office to match your Gmail settings.

You can find more information about Gmail settings here:

And here:

(Feng Onsite only): make sure your server allows Google to connect

If you are installing Feng Office in your own server, make sure that your Firewall or any other security setting are not blocking the SSL connections.

(Feng Sky and Supported Feng Onsite): contact us

If you tried all of the above and your Gmail account is still not connecting, please contact us through the support channels. The support team will gladly help you set it up on your Feng Sky account or on your supported Feng Onsite installation.


PLEASE NOTE: Comments to the wiki should only contain suggestions and questions that help us to improve the manual (and not the software). These comments will be deleted as soon as the information has been integrated into the manual.

Posts that do not contribute to the DOCUMENTATION of the project will be DELETED.

Ask QUESTIONS on the product here.
Report BUGS here.
Propose NEW FEATURES here.

Enter your comment
email/gmail_configuration.txt · Last modified: 2017-07-10 17:36 by conrado
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 3.0 Unported

Terms of Service | Privacy and Security policies | Copyright © 2020