Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

adapt to removed gmail-oauth2 #299

Merged
merged 3 commits into from
Aug 14, 2024
Merged

adapt to removed gmail-oauth2 #299

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1837211
adapt to removed gmail-oauth2
r10s Aug 14, 2024
2460643
2fa is needed before creating app-password
r10s Aug 14, 2024
65d6215
add deep link for app-password generation
r10s Aug 14, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 15 additions & 6 deletions _providers/gmail.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,16 +18,18 @@ server:
opt:
delete_to_trash: true
before_login_hint: |
For Gmail accounts, you need to create an app-password if you have "2-Step Verification" enabled. If this setting is not available, you need to enable "less secure apps".
last_checked: 2021-08
For Gmail accounts, you need to create an app-password and have "2-Step Verification" enabled.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Better to flip this. Afair it's impossible to create an app password w/o having 2-Step Verification already enabled

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

makes sense, i added a commit

last_checked: 2024-08
website: https://gmail.com
---

To use Delta Chat with your Gmail email address you have to take **one of the following actions**. We prefer the first one, because it is the easiest. If that doesn't suit you, try one of the other options.
To use Delta Chat with your Gmail email address,
you need to enable **2-Step Verification** in your Google Account
and then **Create an app-specific password**.

* **Authenticate using "oauth"**: *This currently works only with Delta Chat Android.* Delta Chat automatically tries this method for recognized Gmail-accounts, it is the extra login dialog you get to see when trying to log in with Delta Chat for the first time. If you cancelled that dialog you may simply start the login process again to authenticate with "oauth".
* **Create an app-specific password**: This method is only viable if you use "2-Step Verification" for logging into Gmail. It means to create an additional password that allows access to your emails, which you use only for one device or app. Please [follow Google's instructions](https://support.google.com/accounts/answer/185833), and then use the newly generated password to log in with Delta Chat.
* **Allow "less-secure apps"**: This sounds like a bad idea, but it actually just enables a very commonly used way to access emails, so don't let yourself be scared away. Please [switch this feature on](https://myaccount.google.com/lesssecureapps), and then log in with Delta Chat just normally.
This means to create an additional password which you use only for one device or app.
Please [follow Google's instructions](https://support.google.com/accounts/answer/185833),
and then use the newly generated password to log in with Delta Chat.

If you still have login problems,
make sure IMAP is enabled in the Gmail web interface
Expand All @@ -36,3 +38,10 @@ at **Settings / See all settings / Forwarding and POP/IMAP / IMAP access / Enabl
## Further information

Gmail places some limits on the [amount of emails you may send and receive per day](https://support.google.com/mail/answer/22839).

In the past, we supported Google's Oauth as well.
Due Google adding more and more bureaucracy in that area,
we dropped support for that.
This allows our small open source project
using our limited resources
in areas with larger impact.
Loading