* Add workspace organization guide and retire channel naming conventions page Splits product how-to from organizational guidance. The new admin guide at administration-guide/manage/admin/workspace-organization is the single home for team structure, channel naming conventions, sidebar categories, channel creation models, and notification load. The end-user channel-naming-conventions page is removed. Its product rules move to create-channels as a channel name rules section plus a how-to for adding emojis to channel names. organize-using-teams keeps only its how-to content and links to the new guide instead of recommending a single team. Legacy URLs for the removed page redirect to the new guide. Co-authored-by: Cursor <cursoragent@cursor.com> * Polish workspace organization docs with visuals and review edits. Add screenshots from the draft, refine team/channel guidance and cross-links, and keep the teams how-to page pointing to the new admin guide. Co-authored-by: Cursor <cursoragent@cursor.com> * Update docs/main/administration-guide/manage/admin/workspace-organization.mdx Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update docs/main/administration-guide/manage/admin/workspace-organization.mdx Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com> * Update docs/main/administration-guide/manage/admin/workspace-organization.mdx Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com> * Clarify when a security boundary calls for separate teams. Replace the developer and security operations example with cases where groups must stay hidden from each other, and align the use-when labels. Co-authored-by: Cursor <cursoragent@cursor.com> * Remove the unused single-team workspace screenshot. The guide never references it, so it should not ship with the docs change. Co-authored-by: Cursor <cursoragent@cursor.com> --------- Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com>
Mattermost is an open core, self-hosted collaboration platform that offers chat, workflow automation, voice calling, screen sharing, and AI integration. This repo is the primary source for core development on the Mattermost platform; it's written in Go and React, runs as a single Linux binary, and relies on PostgreSQL. A new compiled version is released under an MIT license every month on the 16th.
Deploy Mattermost on-premises, or try it for free in the cloud.
Learn more about the following use cases with Mattermost:
Other useful resources:
- Download and Install Mattermost - Install, setup, and configure your own Mattermost instance.
- Product documentation - Learn how to run a Mattermost instance and take advantage of all the features.
- Developer documentation - Contribute code to Mattermost or build an integration via APIs, Webhooks, slash commands, Apps, and plugins.
Table of contents
- Install Mattermost
- Native mobile and desktop apps
- Get security bulletins
- Get involved
- Learn more
- License
- Get the latest news
- Contributing
Install Mattermost
- Download and Install Mattermost Self-Hosted - Deploy a Mattermost Self-hosted instance in minutes via Docker, Ubuntu, or tar.
- Get started in the cloud to try Mattermost today.
- Developer machine setup - Follow this guide if you want to write code for Mattermost.
Other install guides:
- Deploy Mattermost on Docker
- Mattermost Omnibus
- Install Mattermost from Tar
- Ubuntu 20.04 LTS
- Kubernetes
- Helm
- More server install guides
Native mobile and desktop apps
In addition to the web interface, you can also download Mattermost clients for Android, iOS, Windows PC, macOS, and Linux.
Get security bulletins
Receive notifications of critical security updates. The sophistication of online attackers is perpetually increasing. If you're deploying Mattermost it's highly recommended you subscribe to the Mattermost Security Bulletin mailing list for updates on critical security releases.
Get involved
- Contribute to Mattermost
- Find "Help Wanted" projects
- Join Developer Discussion on a Mattermost server for contributors
- Get Help With Mattermost
Learn more
- API options - webhooks, slash commands, drivers, and web service
- See who's using Mattermost
- Browse over 700 Mattermost integrations
License
See the LICENSE file for license rights and limitations.
Get the latest news
- X - Follow Mattermost on X, formerly Twitter.
- Blog - Get the latest updates from the Mattermost blog.
- Facebook - Follow Mattermost on Facebook.
- LinkedIn - Follow Mattermost on LinkedIn.
- Email - Subscribe to our newsletter (1 or 2 per month).
- Mattermost - Join the ~contributors channel on the Mattermost Community Server.
- IRC - Join the #matterbridge channel on Freenode (thanks to matterircd).
- YouTube - Subscribe to Mattermost.
Contributing
Please see CONTRIBUTING.md. Join the Mattermost Contributors server to join community discussions about contributions, development, and more.




