1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/mailman3_ynh.git synced 2024-09-03 19:36:17 +02:00
mailman3_ynh/README.md

133 lines
4.5 KiB
Markdown
Raw Normal View History

2019-09-20 12:55:12 +02:00
# Mailman3 for YunoHost
[![Integration level](https://dash.yunohost.org/integration/mailman3.svg)](https://dash.yunohost.org/appci/app/mailman3)
[![Install Mailman3 with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=mailman3)
*[Lire ce readme en français.](./README_fr.md)*
2019-09-22 17:56:54 +02:00
> This package allow you to install Mailman3 quickly and simply on a YunoHost server.
2019-09-20 12:55:12 +02:00
2019-09-22 17:56:54 +02:00
*If you don't have YunoHost, please see [here](https://yunohost.org/#/install) to know how to install and enjoy it.*
2019-09-20 12:55:12 +02:00
2019-09-22 18:32:29 +02:00
## Status
**Experimental.**
2019-09-20 12:55:12 +02:00
## Overview
This is GNU Mailman, a mailing list management system distributed under the terms of the GNU General Public License (GPL) version 3 or later. Mailman is written in Python which is available for all platforms that Mailman is supported on, including GNU/Linux and most other Unix-like operating systems (e.g. Solaris, *BSD, MacOSX, etc.).
2019-09-22 17:50:24 +02:00
> http://docs.mailman3.org/en/latest/userguide.html
2019-09-20 12:55:12 +02:00
2019-09-22 17:30:44 +02:00
**Shipped version:** 3.2.0
2019-09-20 12:55:12 +02:00
## Screenshots
![](https://image.slidesharecdn.com/hyperkitty-160201173833/95/hyperkitty-a-web-interface-for-gnu-mailman-3-8-638.jpg?cb=1454349750)
## Demo
* [Official demo](https://lists.mailman3.org/mailman3/lists/)
2019-09-22 17:30:51 +02:00
No user/password is provided, so you must sign up.
2019-09-20 12:55:12 +02:00
## Post-installation steps
### Setup Admin User
You must [configure the admin user](http://docs.mailman3.org/en/latest/config-web.html#setting-up-admin-account):
```bash
$ cd /usr/share/mailman3-web
$ python3 manage.py createsuperuser
```
You should then attempt to log in with this user account in the web UI. Once you've logged in, a confirmation mail will be sent to your email address that you specified. Therefore, you should have something like [Rainloop](https://github.com/YunoHost-Apps/rainloop_ynh) installed to view mail on your YunoHost installation.
2019-09-22 18:24:01 +02:00
### Setup your main domain
You'll need to log in as administrator and visit the `/admin/site/site`.
If you're Mailman3 is setup on `myyunohost.org` then that would be the following:
> myyunohost.org/admin/site/site
2019-09-20 12:55:12 +02:00
## Configuration
Mailman3 is made up of 3 moving parts:
* Mailman3 Core: https://mailman.readthedocs.io
* Postorious: https://postorius.readthedocs.io
* Hyperkitty: https://hyperkitty.readthedocs.io
There is also documentation for "the suite" which is all the parts together:
* https://docs.mailman3.org
On your YunoHost, all the configuration files you need to worry about are in:
* `/etc/mailman3/`
It is important to note that this package makes use of the [mailman3-full](http://docs.mailman3.org/en/latest/prodsetup.html#distribution-packages) Debian package contained in the Debian Stretch backports repository.
2019-09-22 18:25:46 +02:00
Finally, you also configure things through the Django web admin available at `/admin/`.
2019-09-20 12:55:12 +02:00
## Documentation
* [Official documentation](http://docs.mailman3.org/en/latest/index.html)
## YunoHost specific features
#### Multi-users support
* No LDAP support
* HTTP Auth is supported
* Only one installation per YunoHost
#### Supported architectures
* x86-64b - [![Build Status](https://ci-apps.yunohost.org/ci/logs/mailman3%20%28Apps%29.svg)](https://ci-apps.yunohost.org/ci/apps/mailman3/)
* ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/mailman3%20%28Apps%29.svg)](https://ci-apps-arm.yunohost.org/ci/apps/mailman3/)
## Limitations
* Migrating from Mailman 2.X is not supported. This is a manual and
experimental process. Please see [the documentation](https://docs.mailman3.org/en/latest/migration.html).
* Mailman3 must be configured to use a root domain (myyunohost.org and not myyunohost.org/mailman3).
* You must have a HTTPS certificate installed on the root domain.
## Mirroring
* https://github.com/YunoHost-Apps/mailman3_ynh
* https://hack.decentral1.se/yunohost-packages/mailman3_ynh
## Links
* Report a bug: https://github.com/YunoHost-Apps/mailman3_ynh/issues
* App website: http://docs.mailman3.org/en/latest/index.html
* Upstream app repository: https://gitlab.com/mailman/mailman-suite
* YunoHost website: https://yunohost.org/
---
Developers info
----------------
**Only if you want to use a testing branch for coding, instead of merging directly into master.**
Please make your pull request against the [testing branch](https://github.com/YunoHost-Apps/mailman3_ynh/tree/testing).
To try the testing branch:
```
$ yunohost app install https://github.com/YunoHost-Apps/mailman3_ynh/tree/testing --debug
```
Or to upgrade from the testing branch:
```bash
$ yunohost app upgrade mailman3 -u https://github.com/YunoHost-Apps/mailman3_ynh/tree/testing --debug
```