---
title: "Mailopus documentation"
description: "For people running their own Mailopus server. Mailopus runs on Cloudflare today, in your own account."
canonical_url: "https://docs.mailopus.net"
---
# Mailopus documentation

> For people running their own Mailopus server. Mailopus runs on Cloudflare today, in your own account.

<u-page-hero>
<template v-slot:title="">

Mailopus documentation

</template>

<template v-slot:description="">

For people running their own Mailopus server. Mailopus runs on Cloudflare today, in your own account.

</template>

<template v-slot:links="">
<u-button size="xl" to="https://docs.mailopus.net/setup" trailing-icon="i-lucide-arrow-right">

Set up your server

</u-button>

<u-button size="xl" to="https://github.com/mailopus/server" color="neutral" icon="i-simple-icons-github" variant="outline">

Public repo

</u-button>
</template>
</u-page-hero>

<u-container className="max-w-3xl,pb-24">

## Start here

1. [Set up your server](https://docs.mailopus.net/setup). Requirements, deploy, DNS, Email Routing, Email Sending and claiming it with a passkey.
2. [Addresses and domains](https://docs.mailopus.net/addresses). Adding addresses, `+` aliases, the catch-all route, more domains, more people.

## Using it

- [Sign-in and discovery](https://docs.mailopus.net/sign-in). How app.mailopus.net finds your Worker, where passkeys and sessions live, adding a device, recovery.
- [Mail apps](https://docs.mailopus.net/proxy). Running the IMAP and SMTP proxy, app passwords, and setting up Apple Mail, Thunderbird and Outlook.
- [Spam](https://docs.mailopus.net/spam). What goes to Junk, blocked senders, remote classifiers, writing your own rules.
- [Configuration](https://docs.mailopus.net/configuration). Every variable, secret and binding, notifications, Swiftly signatures, Gmail import, backups and JMAP for other clients.
- [Troubleshooting](https://docs.mailopus.net/troubleshooting). Symptoms and fixes, from deploy to mail apps.

</u-container>

## Resources for Agents

- [API catalog: every service document this site publishes](https://docs.mailopus.net/.well-known/api-catalog)
- [Sitemap (XML)](https://docs.mailopus.net/sitemap.xml)
- [Sitemap (Markdown): every page on the site](https://docs.mailopus.net/sitemap.md)
- [llms.txt: index of the documentation for LLMs](https://docs.mailopus.net/llms.txt)
- [llms-full.txt: the full documentation as a single file](https://docs.mailopus.net/llms-full.txt)
- [OpenAPI document: every route this site serves to agents](https://docs.mailopus.net/openapi.json)


## Sitemap

See the full [sitemap](https://docs.mailopus.net/sitemap.md) for all pages.
