You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
FairEmail/SETUP.md

66 lines
3.1 KiB

6 years ago
# Setup help
Setting up FairEmail is fairly simple.
6 years ago
You'll need to add at least one account to receive email and at least one identity if you want to send email.
6 years ago
The quick setup will add an account and an identity in one go for most major providers.
6 years ago
6 years ago
## Requirements
An internet connection is required to set up accounts and identities.
## Quick setup
4 years ago
Just select the appropriate provider or *Other provider* and enter your name, email address and password and tap *Check*.
6 years ago
This will work for most major email providers.
If the quick setup doesn't work, you'll need to setup an account and an identity in another way, see below for instructions.
6 years ago
## Set up account - to receive email
6 years ago
To add an account, tap the *Accounts* button and tap the 'plus' button at the bottom and select IMAP (or POP3).
6 years ago
Select a provider from the list, enter the username, which is mostly your email address and enter your 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 hostname and port number,
else check the setup instructions of your provider for the right IMAP hostname, port number and protocol (SSL/TLS or STARTTLS).
6 years ago
For more about this, please see [here](https://github.com/M66B/FairEmail/blob/master/FAQ.md#authorizing-accounts).
6 years ago
## Set up identity - to send email
6 years ago
Similarly, to add an identity, tap the *Identities* button and tap the 'plus' button at the bottom.
5 years ago
Enter the name you want to appear in the from address of the emails you send and select a linked account.
6 years ago
Tap *Save* to add the identity.
If the account was configured manually, you likely need to configure the identity manually too.
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 hostname and port number,
else check the setup instructions of your provider for the right SMTP hostname, port number and protocol (SSL/TLS or STARTTLS).
6 years ago
See [this FAQ](https://github.com/M66B/FairEmail/blob/master/FAQ.md#FAQ9) about using aliases.
6 years ago
6 years ago
## Grant permissions - to access contact information
6 years ago
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*.
## Setup battery optimizations - to continuously receive emails
6 years ago
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.
## Questions or problems
6 years ago
5 years ago
If you have a question or problem, please [see here](https://github.com/M66B/FairEmail/blob/master/FAQ.md) for help.