|
| 1 | +--- |
| 2 | +order: 1550 |
| 3 | +icon: /media/zohomail.svg |
| 4 | +label: Zoho Mail |
| 5 | +tags: guides |
| 6 | +--- |
| 7 | + |
| 8 | +# Setting up Zoho Mail using is-a.dev subdomain |
| 9 | + |
| 10 | +This guide will walk you through the process of setting up custom email in Zoho Mail with your is-a.dev subdomain. |
| 11 | + |
| 12 | +## Getting Started |
| 13 | + |
| 14 | + |
| 15 | + |
| 16 | +1. Visit the [Zoho Mail homepage](https://www.zoho.com/mail/), fill in the required details, and click **SIGN UP FOR FREE** to create your account. If you already have one, visit [here](https://www.zoho.com/mail/login.html) to login to your existing account. |
| 17 | +2. You must have an is-a.dev subdomain to set up and use Zoho Mail services. Learn more in our [GitHub repository](https://github.com/is-a-dev/register). |
| 18 | +3. A valid mobile number and an email address for verification purposes is **required** to access Zoho Mail. |
| 19 | + |
| 20 | +## Verify your domain |
| 21 | +After logging in to your Zoho Mail account, follow the steps given to verify your domain ownership. |
| 22 | + |
| 23 | +1. Click **Add now** under the **Add an existing domain** section on the Domain Addition page. |
| 24 | + |
| 25 | +  |
| 26 | + |
| 27 | +2. Enter `your-domain.is-a.dev` subdomain and the name of your organization in the pop-up. The organization name can be your personal name too. Click **Add now** to proceed. |
| 28 | + |
| 29 | +  |
| 30 | + |
| 31 | +3. Once your domain is added, click **Proceed to payment**. If you want to skip this and continue with your free plan, then click **Change my plan**. |
| 32 | + |
| 33 | +  |
| 34 | + |
| 35 | +5. On Zoho's domain setup page, select **Add TXT record to DNS** from the dropdown. It is recommended, but you can also use the last HTML file option for quick setup. |
| 36 | + |
| 37 | +  |
| 38 | + |
| 39 | + You need to copy the **TXT value / content** and create a new file or update an existing file, for example `your-domain.json`. After that, please open a pull request in [our repository](https://github.com/is-a-dev/register) and **wait for the pull request to be merged**. |
| 40 | + |
| 41 | + ```json |
| 42 | + { |
| 43 | + "owner": { |
| 44 | + "username": "github-username", |
| 45 | + |
| 46 | + }, |
| 47 | + "records": { |
| 48 | + "TXT": ["Paste TXT Value / Content Here"] |
| 49 | + } |
| 50 | + } |
| 51 | + ``` |
| 52 | + |
| 53 | +6. Now that you have verified ownership of your domain, click **Create** to create your first email using your is-a.dev subdomain. |
| 54 | + |
| 55 | +  |
| 56 | + |
| 57 | + |
| 58 | +## DNS Mapping |
| 59 | + |
| 60 | +After you verified your domain, you may see the **Setup Users ** and **Setup Groups ** sections, where you can set up your users (such as [email protected]) and groups. For now, you can skip these and move on to **DNS Mapping **. |
| 61 | + |
| 62 | +### MX and SPF Records |
| 63 | + |
| 64 | +1. Now you need to add the **MX** and **SPF records** for your domain. You will need to update the existing file that you used to verify the domain and add the TXT record. |
| 65 | + |
| 66 | +  |
| 67 | + |
| 68 | + Copy the **MX** values and **TXT** values for the SPF record and update your file. This is the most important step, please be careful. |
| 69 | + |
| 70 | + ```json |
| 71 | + { |
| 72 | + "owner": { |
| 73 | + "username": "github-username", |
| 74 | + |
| 75 | + }, |
| 76 | + "records": { |
| 77 | + "TXT": [ |
| 78 | + "TXT Value / Content Will Be Stay Here From Old Content", |
| 79 | + "v=spf1 include:zohomail.com ~all" |
| 80 | + ], |
| 81 | + "MX": [ |
| 82 | + { |
| 83 | + "target": "mx.zoho.com", |
| 84 | + "priority": 10 |
| 85 | + }, |
| 86 | + { |
| 87 | + "target": "mx2.zoho.com", |
| 88 | + "priority": 20 |
| 89 | + }, |
| 90 | + { |
| 91 | + "target": "mx3.zoho.com", |
| 92 | + "priority": 50 |
| 93 | + } |
| 94 | + ] |
| 95 | + } |
| 96 | + } |
| 97 | + ``` |
| 98 | + |
| 99 | +### DKIM Record |
| 100 | + |
| 101 | +2. Now only **DKIM record** is left, for this you have to create a **new file** named `zmail._domainkey.your-domain.json`. Please note that *your-domain* should be replaced with the is-a.dev subdomain that you own. |
| 102 | + |
| 103 | + Paste the following content in your `zmail._domainkey.your-domain.json` file: |
| 104 | + |
| 105 | + ```json |
| 106 | + { |
| 107 | + "owner": { |
| 108 | + "username": "github-username", |
| 109 | + |
| 110 | + }, |
| 111 | + "records": { |
| 112 | + "TXT": "Paste the DKIM Value Here" |
| 113 | + } |
| 114 | + } |
| 115 | + ``` |
| 116 | + |
| 117 | + After you have done all, please create a Pull Request in [our repository](https://github.com/is-a-dev/register) and wait for it to get merged. |
| 118 | + |
| 119 | + |
| 120 | +## You're all set |
| 121 | + |
| 122 | + |
| 123 | + |
| 124 | +After all your pull requests has been merged, you will see the same page as above, if you see it, you are all set and your email is now ready to use with the is-a.dev subdomain. Enjoy your custom email! |
0 commit comments