Klinger: [Category:Web Applications]]

2024-06-05T17:46:58Z

[Category:Web Applications]]

← Older revision		Revision as of 17:46, 5 June 2024
Line 74:		Line 74:
	[[Category:Applications]]		[[Category:Applications]]
	[[Category:Server]]		[[Category:Server]]
	[[Category:~~Messaging~~]]		[[Category:Web Applications]]

Mic92: imported from old wiki

2024-06-05T07:41:45Z

imported from old wiki

New page

[https://mattermost.com/ Mattermost] is an open source, self-hosted Slack-alternative. As an alternative to proprietary SaaS messaging, Mattermost brings all your team communication into one place, making it searchable and accessible anywhere.<ref>https://wiki.archlinux.org/title/Mattermost</ref>

== Installation ==
Add <code>mattermost</code> to your <code>environment.systemPackages</code>.

<syntaxhighlight lang="nix">
environment.systemPackages = with pkgs; [
mattermost
];
</syntaxhighlight>

== Setup ==
=== Mattermost ===
To setup Mattermost, you need to enable its service, and provide it with a site url.
<syntaxhighlight lang="nix">
services.mattermost = {
enable = true;
siteUrl = "https://mattermost.example.com"; # Set this to the URL you will be hosting the site on.
};
</syntaxhighlight>

After a rebuild, Mattermost will now be accessible at <code>http://127.0.0.1:8065</code>. To set it up to match your <code>siteUrl</code>, follow the Nginx config below.

=== Nginx ===
While optional, if you are hosting Mattermost alongside other web services, or need SSL (https), you will likely want to set up a web server like Nginx.

==== Installation ====
Add <code>nginx</code> to your <code>environment.systemPackages</code>.

<syntaxhighlight lang="nix">
environment.systemPackages = with pkgs; [
mattermost
nginx
];
</syntaxhighlight>

==== Setup ====
The following is an example Nginx setup that enables SSL, and configures <code>mattermost.example.com</code> to route to Mattermost.

<syntaxhighlight lang="nix">
# Allow ports 80 and 443 for Nginx
networking.firewall.allowedTCPPorts = [ 80 443 ];

# Set up for SSL certification
security.acme = {
acceptTerms = true;
defaults.email = "webmaster@example.com"; # Replace with your preferred email address.
};

# Configure Nginx
services.nginx = {
enable = true;
recommendedProxySettings = true;
recommendedTlsSettings = true;
virtualHosts = {
# Replace with the domain from your siteUrl
"mattermost.example.com" = {
forceSSL = true; # Enforce SSL for the site
enableACME = true; # Enable SSL for the site
locations."/" = {
proxyPass = "http://127.0.0.1:8065"; # Route to Mattermost
proxyWebsockets = true;
};
};
};
};
</syntaxhighlight>

After a rebuild, Mattermost will now be accessible at <code>siteUrl</code> (assuming you have configured your DNS).

== References ==
<references />

[[Category:Applications]]
[[Category:Server]]
[[Category:Messaging]]

Mattermost - Revision history

Klinger: [Category:Web Applications]]

Mic92: imported from old wiki