Team chat (Mattermost)¶
The team chat module installs Mattermost Team Edition platform inside NethServer.
Mattermost is an Open Source, private cloud Slack-alternative. Check out the excellent official documentation: https://docs.mattermost.com/.
Mattermost installation needs a dedicated virtual host, an FQDN like
Before proceeding with the configuration, make sure to create the corresponding DNS record. If NethServer act as the DNS server of your LAN, please refer to DNS.
If your server is using a Let’s Encrypt certificate as default, make also sure to have a corresponding public DNS record. See Server certificate for more info.
Please note that the mobile app cannot connect to servers with self-signed certificates!
How to configure:
- Access Team chat page inside the Server Manager
- Check Enable Mattermost Team Edition, then enter a valid FQDN inside Virtual host name field (eg.
- Open the entered host name inside the browser, eg:
https://chat.nethserver.org. At first access, a wizard will create the administrator user
The following features are enabled by default:
- mail notifications
- push notifications for mobile apps
- redirect from HTTP to HTTPS
Mattermost authentication is not integrated with any Account Provider. The Mattermost administrator should take care of users and teams creation.
The administrator should always use Mattermost wizard to create the admin user, then send team invitation link to each user.
If the system administrator still needs bulk user creation, he/she can rely on
The command will:
- create a default team named as the Company from Organization contacts
- read all users from local or remote Account Providers and create them inside Mattermost
Please note that:
- users disabled in the Server Manager or already existing in Mattermost will be skipped
- a random password will be generated for each user
- the first imported user will be set as administrator if no admin has been already created
mattermost-bulk-user-create ... Creating default team: example (Example Org) ... OK Skipping locked user: 'goofy' Skipping locked user: 'admin' Creating user: 'pluto' with password '6aW221o7' ... OK ...
Users are not automatically synced inside Mattermost.
Each time a user is created or removed, remember to execute
mattermost-bulk-user-create command or
manually create the user using Mattermost administration web interface.
Forcing a common default password¶
It’s possible to set a default password for each new Mattermost user, just append the default password to command invocation.