diff --git a/community-containers/stalwart/readme.md b/community-containers/stalwart/readme.md index cdd1db04..b34f04db 100644 --- a/community-containers/stalwart/readme.md +++ b/community-containers/stalwart/readme.md @@ -1,23 +1,17 @@ -> [!WARNING] -> The Stalwart server is under development. +> [!CAUTION] +> Be aware that the mail server is the most difficult service to deploy. > -> The stability of Stalwart services is not guaranteed. -> Do not use this feature as a main mail server without a redundancy system and without knowledge. -> -> To learn or use as a secondary server enjoy it and please report bugs at [docjyj/aio-stalwart](https://github.com/docjyj/aio-stalwart/issues). +> Do not use this feature as a main mail server or without a redundancy system and without knowledge. ## Stalwart mail server This container bundles stalwart mail server and auto-configures it for you. ### Notes -- This is only intended to run on a VPS with static ip-address. -- Check with `sudo netstat -tulpn` that no other service is using port 25, 143, 465, 587, 993 nor 4190 yet as otherwise the container will fail to start. -- You need to configure a reverse proxy in order to run this container since stalwart needs a dedicated (sub)domain! For that, you might have a look at https://github.com/nextcloud/all-in-one/tree/main/community-containers/caddy. -- Currently, only `mail.$NC_DOMAIN` is supported as subdomain! So if Nextcloud is using `your-domain.com`, Stalwart will use `mail.your-domain.com`. -- The data of Stalwart will be automatically included in AIOs backup solution! -- After adding and starting the container, you need to run `docker inspect nextcloud-aio-stalwart | grep STALWART_USER_PASS` to obtain the system administrator password (username: `admin`). With this information, you can log in to the web interface at `https://mail.your-domain.com/login` -- See https://stalw.art/docs/install/docker/ for next steps. -- Additionally, you might want to install and configure [snappymail](https://apps.nextcloud.com/apps/snappymail) or [mail](https://apps.nextcloud.com/apps/mail) inside Nextcloud in order to use your mail accounts for sending and retrieving mails. +Documentation is available on the container repository. +This documentation is regularly updated and is intended to be as simple and detailed as possible. +Thanks for all your feedback! + +- See https://github.com/docjyJ/aio-stalwart#getting-started for getting start with this container. - See https://stalw.art/docs/faq for further faq and docs on the project - See https://github.com/nextcloud/all-in-one/tree/main/community-containers#community-containers how to add it to the AIO stack diff --git a/community-containers/stalwart/upgrading.md b/community-containers/stalwart/upgrading.md deleted file mode 100644 index 958f4355..00000000 --- a/community-containers/stalwart/upgrading.md +++ /dev/null @@ -1,29 +0,0 @@ -> [!NOTE] -> Unless the starting script tells you, you have no action to do to update. - -# UPGRADING - -During a major server update, this message will be displayed: - -> Your data is in an old format. -> -> Make a backup and see https://github.com/nextcloud/all-in-one/blob/main/community-containers/stalwart/upgrading.md -> -> To avoid any loss of data, Stalwart will not launch. - -If there is no update, delete the `/opt/stalwart-mail/aio.lock` file from the container. Beware of data loss. - -See https://github.com/stalwartlabs/mail-server/blob/main/UPGRADING.md - -> [!CAUTION] -> Before each update don't forget to make a backup. - -## Upgrading from 0.7.x to 0.8.x - -Before upgrading, do a backup of your data ! - -```bash -sudo docker run --rm -v nextcloud_aio_stalwart:/opt/stalwart-mail -it --entrypoint /usr/local/bin/stalwart-mail stalwartlabs/mail-server:v0.7.3 --config /opt/stalwart-mail/etc/config.toml --export /opt/stalwart-mail/export -sudo docker run --rm -v nextcloud_aio_stalwart:/opt/stalwart-mail -it --entrypoint /usr/local/bin/stalwart-mail stalwartlabs/mail-server:v0.8.0 --config /opt/stalwart-mail/etc/config.toml --import /opt/stalwart-mail/export -sudo docker run --rm -v nextcloud_aio_stalwart:/opt/stalwart-mail -it --entrypoint /bin/rm alpine /opt/stalwart-mail/aio.lock -```