Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion src/guides/bsky-handle.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
order: 100
order: 200
icon: /media/bluesky.svg
label: Bluesky Custom Handle
tags: guides
Expand Down
2 changes: 1 addition & 1 deletion src/guides/discord-verification.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
order: 200
order: 900
icon: /media/discord.svg
label: Discord Domain Connection
tags: guides
Expand Down
2 changes: 1 addition & 1 deletion src/guides/other.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
order: 900
order: 100
label: Other services
icon: server
tags: guides
Expand Down
124 changes: 124 additions & 0 deletions src/guides/zoho-mail.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
---
order: 1550
icon: /media/zohomail.svg
label: Zoho Mail
tags: guides
---

# Setting up Zoho Mail using is-a.dev subdomain

This guide will walk you through the process of setting up custom email in Zoho Mail with your is-a.dev subdomain.

## Getting Started

![](../media/zohomail/step_1.png)

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.
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).
3. A valid mobile number and an email address for verification purposes is **required** to access Zoho Mail.

## Verify your domain
After logging in to your Zoho Mail account, follow the steps given to verify your domain ownership.

1. Click **Add now** under the **Add an existing domain** section on the Domain Addition page.

![](../media/zohomail/step_2.png)

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.

![](../media/zohomail/step_3.png)

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**.

![](../media/zohomail/step_4.png)

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.

![](../media/zohomail/step_5.png)

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**.

```json
{
"owner": {
"username": "github-username",
"email": "example@example.org"
},
"records": {
"TXT": ["Paste TXT Value / Content Here"]
}
}
```

6. Now that you have verified ownership of your domain, click **Create** to create your first email using your is-a.dev subdomain.

![](../media/zohomail/step_6.png)


## DNS Mapping

After you verified your domain, you may see the **Setup Users** and **Setup Groups** sections, where you can set up your users (such as example@your-domain.is-a.dev) and groups. For now, you can skip these and move on to **DNS Mapping**.

### MX and SPF Records

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.

![](../media/zohomail/step_7.png)

Copy the **MX** values and **TXT** values for the SPF record and update your file. This is the most important step, please be careful.

```json
{
"owner": {
"username": "github-username",
"email": "example@example.org"
},
"records": {
"TXT": [
"TXT Value / Content Will Be Stay Here From Old Content",
"v=spf1 include:zohomail.com ~all"
],
"MX": [
{
"target": "mx.zoho.com",
"priority": 10
},
{
"target": "mx2.zoho.com",
"priority": 20
},
{
"target": "mx3.zoho.com",
"priority": 50
}
]
}
}
```

### DKIM Record

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.

Paste the following content in your `zmail._domainkey.your-domain.json` file:

```json
{
"owner": {
"username": "github-username",
"email": "example@example.org"
},
"records": {
"TXT": "Paste the DKIM Value Here"
}
}
```

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.


## You're all set

![](../media/zohomail/step_8.png)

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!
15 changes: 9 additions & 6 deletions src/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,18 +12,21 @@ Here you'll find detailed guides, the JSON file structure, and more. If you'd li
You can read about the domains' JSON file structure [here](useful/domain-structure).

## Guides
- [GitHub Pages](guides/github-pages)
- [Cloudflare Pages](guides/cloudflare-pages)
- [Vercel](guides/vercel)
- [Codeberg Pages](guides/codeberg-pages)
- [Netlify](guides/netlify)
- [ImprovMX](guides/improvmx)
- [Zoho Mail](guides/zoho-mail.md)
- [DanBot Hosting](guides/dbh)
- [Discord Domain Verification](guides/discord-verification)
- [GitHub Pages](guides/github-pages)
- [Hashnode Blogs](guides/hashnode)
- [ImprovMX](guides/improvmx)
- [Netlify](guides/netlify)
- [Other Services](guides/other)
- [Railway](guides/railway)
- [Render](guides/render)
- [Replit](guides/replit)
- [Vercel](guides/vercel)
- [Discord Domain Verification](guides/discord-verification)
- [Bluesky Custom Handle](guides/bsky-handle)
- [Other Services](guides/other)

## Useful
- [Domain Structure](useful/domain-structure)
Expand Down
5 changes: 5 additions & 0 deletions src/media/zohomail.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/media/zohomail/step_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/media/zohomail/step_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/media/zohomail/step_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/media/zohomail/step_4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/media/zohomail/step_5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/media/zohomail/step_6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/media/zohomail/step_7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/media/zohomail/step_8.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.