FairEmail/SETUP.md

67 lines
3.0 KiB
Markdown
Raw Normal View History

2018-09-19 06:38:29 +00:00
# Setup help
2018-09-19 10:09:31 +00:00
Setting up FairEmail is fairly simple.
2018-09-19 06:38:29 +00:00
You'll need to add at least one account to receive email and at least one identity if you want to send email.
2018-11-14 20:58:33 +00:00
2018-09-19 06:38:29 +00:00
## Requirements
2018-12-30 08:15:49 +00:00
An internet connection is required to setup accounts and identities.
2018-12-29 19:19:06 +00:00
## Quick setup
Just enter your name, email address and password and tap *Quick setup*.
2018-12-29 19:40:36 +00:00
This will work for most major email providers.
2018-12-29 19:19:06 +00:00
If the quick setup doesn't work, you'll need to setup an account and an identity in another way, see below for instructions.
To use Gmail, you'll need to enable access for "less secure" apps,
see [here](https://support.google.com/accounts/answer/6010255) for Google's instructions
or go [directy to the setting](https://www.google.com/settings/security/lesssecureapps).
Less secure is relative and other providers just allow access in the same way,
but if you are concerned you can complete the setup by setting up an account and an identity in another way too, see below.
2018-09-19 06:38:29 +00:00
2018-11-14 20:58:33 +00:00
2018-11-08 11:17:26 +00:00
## Account - to receive email
2018-09-19 06:38:29 +00:00
To add an account, tap on *Manage accounts* and tap on the orange *add* button at the bottom.
Select a provider from the list, enter the username, which is mostly your email address and enter your password.
If you use Gmail, tap *Select account* to fill in the username and password.
Tap *Check* to let FairEmail connect to the email server and fetch a list of system folders.
After reviewing the system folder selection you can add the account by tapping *Save*.
If your provider is not in the list of providers, select *Custom*.
Enter the domain name, for example *gmail.com* and tap *Get settings*.
If your provider supports [auto-discovery](https://tools.ietf.org/html/rfc6186), FairEmail will fill in the host name and port number,
else check the setup instructions of your provider for the right IMAP host name and port number.
2018-11-09 11:25:51 +00:00
For more about this, please see [here](https://github.com/M66B/open-source-email/blob/master/FAQ.md#authorizing-accounts).
2018-09-19 06:38:29 +00:00
2018-11-14 20:58:33 +00:00
2018-11-08 11:17:26 +00:00
## Identity - to send email
2018-09-19 06:38:29 +00:00
Similarly, to add an identity, tap on *Manage identity* and tap on the orange *add* button at the bottom.
Enter the name you want to appear in de from address of the emails you send and select a linked account.
Tap *Save* to add the identity.
See [this FAQ](https://github.com/M66B/open-source-email/blob/master/FAQ.md#FAQ9) about using aliases.
2018-11-14 20:58:33 +00:00
2018-11-08 11:17:26 +00:00
## Permissions - to access contact information
2018-09-19 06:38:29 +00:00
If you want to lookup email addresses, have contact photos shown, etc, you'll need to grant read contacts permission to FairEmail.
Just tap *Grant permissions* and select *Allow*.
2018-11-14 20:58:33 +00:00
2018-11-08 11:17:26 +00:00
## Battery optimizations - to continuously receive email
2018-09-19 06:38:29 +00:00
On recent Android versions, Android will put apps to sleep when the screen is off for some time to reduce battery usage.
If you want to receive new emails without delays, you should disable battery optimizations for FairEmail.
Tap *Disable battery optimizations* and follow the instructions.
2018-11-14 20:58:33 +00:00
2018-09-19 06:38:29 +00:00
## Questions
2018-11-14 20:58:33 +00:00
If you have a question or problem, please [see here](https://github.com/M66B/open-source-email/blob/master/FAQ.md).