mailinabox README

The project's README from github.com/mail-in-a-box/mailinabox. As one markdown file: README.md.

Mail-in-a-Box

By @JoshData and contributors.

Mail-in-a-Box helps individuals take back control of their email by defining a one-click, easy-to-deploy SMTP+everything else server: a mail server in a box.

Please see https://mailinabox.email for the project's website and setup guide!

Our goals are to:

Additionally, this project has a Code of Conduct, which supersedes the goals above. Please review it when joining our community.

In The Box

Mail-in-a-Box turns a fresh Ubuntu 22.04 LTS 64-bit machine into a working mail server by installing and configuring various components.

It is a one-click email appliance. There are no user-configurable setup options. It "just works."

The components installed are:

It also includes system management tools:

Internationalized domain names are supported and configured easily (but SMTPUTF8 is not supported, unfortunately).

It also supports static website hosting since the box is serving HTTPS anyway. (To serve a website for your domains elsewhere, just add a custom DNS "A" record in you Mail-in-a-Box's control panel to point domains to another server.)

For more information on how Mail-in-a-Box handles your privacy, see the security details page.

Installation

See the setup guide for detailed, user-friendly instructions.

For experts, start with a completely fresh (really, I mean it) Ubuntu 22.04 LTS 64-bit machine. On the machine...

Clone this repository and checkout the tag corresponding to the most recent release (which you can find in the tags or releases lists on GitHub):

$ git clone https://github.com/mail-in-a-box/mailinabox
$ cd mailinabox
$ git checkout TAGNAME

Begin the installation.

$ sudo setup/start.sh

The installation will install, uninstall, and configure packages to turn the machine into a working, good mail server.

For help, DO NOT contact Josh directly --- I don't do tech support by email or tweet (no exceptions).

Post your question on the discussion forum instead, where maintainers and Mail-in-a-Box users may be able to help you.

Note that while we want everything to "just work," we can't control the rest of the Internet. Other mail services might block or spam-filter email sent from your Mail-in-a-Box. This is a challenge faced by everyone who runs their own mail server, with or without Mail-in-a-Box. See our discussion forum for tips about that.

Contributing and Development

Mail-in-a-Box is an open source project. Your contributions and pull requests are welcome. See CONTRIBUTING to get started.

The Acknowledgements

This project was inspired in part by the "NSA-proof your email in 2 hours" blog post by Drew Crawford, Sovereign by Alex Payne, and conversations with @shevski, @konklone, and @GregElin.

Mail-in-a-Box is similar to iRedMail and Modoboa.

The History

mailinabox (mail-in-a-box/mailinabox)

Searching Database…

15.4K ·GitHub
Mailinabox
Что это?Она превращает чистую машину в полноценный собственный почтовый сервер — SMTP, IMAP, веб-почта, синхронизация контактов и календаря, DNS, фильтрация спама и резервное копирование — одной командой установки, так что любой человек может вести свою почту сам, не завися от провайдеров.
Это облачный сервис, на который я регистрируюсь, или программа, которую я запускаю сам?Это бесплатный открытый код, который вы устанавливаете на свой сервер — хостингового варианта нет. Установщик ставит, удаляет и настраивает пакеты, превращая чистую машину в готовый почтовый сервер.
Как превратить сервер в Mail-in-a-Box?Клонируйте этот репозиторий, переключитесь на последний тег релиза и выполните 'sudo setup/start.sh' — дальше скрипт всё сделает сам. После этого веб-панель управления (она же работает как API) управляет почтовыми пользователями, алиасами, DNS-записями и резервными копиями.
Какая машина мне нужна для начала?Совершенно чистая (именно так — README настаивает) машина с 64-битной Ubuntu 22.04 LTS — никаких других дистрибутивов, никаких следов прежних настроек и никаких параметров установки, которые можно менять; всё задумано так, чтобы просто работало.
Gmail и другие провайдеры правда будут принимать письма с моего сервера?Не гарантировано: другие почтовые сервисы могут блокировать письма с вашего сервера или отправлять их в спам — это сложность для всех, кто держит почту на своём сервере, с этим проектом или без него. В форуме проекта собирают советы, как с этим справляться.
Моя почта остаётся на железе, которое контролирую я?Да — почта, контакты и календари живут на вашей собственной машине. Развитие децентрализации и приватности в интернете прямо заявлено как цель проекта, а отдельная страница с деталями безопасности описывает, как защищается ваша приватность.
Что именно устанавливается на машину?Postfix (SMTP), Dovecot (IMAP), Nextcloud для CardDAV/CalDAV плюс z-push ActiveSync, веб-почта Roundcube, SpamAssassin и postgrey, DNS-сервер nsd4 с автоматическими записями SPF/DKIM/DMARC/DNSSEC, сертификаты Let's Encrypt, а также резервное копирование через duplicity, файрвол ufw, fail2ban и мониторинг munin.
Может ли этот сервер ещё и сайт хостить?Да — хостинг статических сайтов включён, тем более что сервер всё равно отдаёт HTTPS. Для доменов, размещённых в другом месте, просто добавьте в панели управления свою DNS-запись типа A, указывающую на другой сервер.
Насколько сильно я могу настраивать систему под себя?Почти никак, и это сделано специально: параметров установки, которые можно менять, нет, а отказ от настройки «для продвинутых» — явная цель проекта, чтобы конфигурация оставалась автоматизированной, проверяемой и воспроизводимой.
Какие проекты похожи на этот?Автор отмечает, что Mail-in-a-Box похож на iRedMail и Modoboa. Проект начался в 2013 году: он объединил собственную конфигурацию почтового сервера с рецептом 'NSA-proof your email in 2 hours' и проектом Sovereign.
What are similar projects?mailcow-dockerized, docker-mailserver, stalwart, odysseus, BillionMail, omamail, mail, xdp-dns-evadeproxy
Which topics is it in?mailserver, mail, imap, smtp, ubuntu, decentralized, dns, backup, tls, email, monitoring, networking
Creator
mail-in-a-box
Size
3.8 MB
Stars
15.4K
Updated
CommitSep 26Releasev77Sep 26
Age
13y
Commits · 90 Days