Files
team/docs/main/product-overview/self-hosted-subscriptions.mdx
fd3b125b31 Reconcile Product Overview content drift from docs repo (P13 sub-phase 4.1) (#37476)
* Fix broken checkmark icons and zoom-breaking tables on Plans and Cloud pages

The Plans page referenced a Sphinx-era static image path that doesn't
exist in the Docusaurus site, rendering broken icons. The Cloud
subscriptions comparison table was a mangled RST-to-MDX conversion
artifact (nested dl/dt/dd, literal ASCII borders, unresolved checkmark
substitutions) with fixed column widths that clipped content on zoom.
Both tables now use the site's checkmark.svg icon and scroll
horizontally within their own container instead of breaking the page.

* Reconcile Product Overview content drift from docs repo

Applies content that landed in mattermost/docs between 2026-05-14 and
2026-07-13 (v11.7/v11.8 server releases, v10.11 dot releases, v6.2/v5.13.7
desktop releases, v2.40-2.41.3 mobile releases, and related subscription/
FAQ/deprecation copy updates) to the corresponding MDX pages in
docs/main/product-overview, per phase P13 sub-phase 4.1 of the docs
migration plan.

* Fix duplicate changelog bullet and admin console path in Product Overview

- Remove duplicate flagged-post-visibility bullet from the v11.7.3 changelog entry.
- Correct subscription.mdx admin console path to include the Reporting menu, matching the path used elsewhere in the docs.

---------

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-14 12:18:58 +03:00

117 lines
8.7 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "Self-Hosted"
---
## Buy a subscription
To purchase a commercial subscription for Mattermost Enterprise or Mattermost Professional, please visit our pricing page online: [https://mattermost.com/pricing/](https://mattermost.com/pricing/)
## Apply your license
Once downloaded, your Mattermost license is ready to use and is applied via the Mattermost System Console.
![Apply the Mattermost Enterprise license using the System Console.](/images/mattermost_enterprise_license.png)
System admin access is required in order to apply the license. If you're not a Mattermost system admin, contact your organization's Mattermost system admin for assistance.
### Mattermost installed
Check your email for a purchase confirmation from Mattermost. Download the attached license. In Mattermost, follow the steps provided in **System Console \> About \> Edition and License** to apply your license key.
You can also use the [mmctl](/administration-guide/manage/mmctl-command-line-tool#mmctl-license) to apply the license.
### Mattermost not yet installed
If you haven't yet installed and deployed a Mattermost instance, visit the [Deployment Guide](/deployment-guide/deployment-guide-index) to get started. For information on creating a system admin account, visit our [Administrator Tasks](/administration-guide/upgrade/admin-onboarding-tasks) documentation.
## Add more users to your subscription
If at any time you'd like to add more users to your Mattermost subscription, talk to a [Mattermost Expert](https://mattermost.com/contact-sales/)
## Quarterly true-up reports
When you buy an annual Mattermost subscription, you agree to provide Mattermost with quarterly reports of the actual number of activated users within your system. An activated user is a user who has a Mattermost account and doesn't show as **Deactivated** in **System Console \> User Management \> Users**.
Single-channel guests are tracked separately from activated users. Guests in exactly one channel are free up to a 1:1 ratio with licensed seats, while guests in multiple channels continue to count as activated users. Direct messages and group messages don't affect whether a guest is counted as a single-channel guest.
We'll send you an email notice around the end of the quarter reminding you to send us your report.
![The timeframes followed for the true-up notifications.](/images/true-up-schedule.png)
If you have more total activated users than you purchased in your annual subscription, your Customer Success Manager will provide you with a true-up quote for the new users added. The additional invoice will be pro-rated based on the number of months left in your subscription term, including the months for the calendar quarter for the time you pull the report. Mattermost won't provide downward adjustments. Mattermost will invoice based on Mattermost’s [current list prices](https://mattermost.com/pricing/).
A system admin must take a screenshot of the **System Console \> Reporting \> System Statistics** page and send it to Mattermost in an email.
- Please ensure your screenshot is taken from the top of the page and includes **Total Activated Users**, **Single-channel Guests**, and **Monthly Active Users**.
- Please include the date of the screenshot in the file name.
- We don't need your server address, so if it appears on your screenshot, you can redact it from the image.
<Tip>
Not sure where to take the screenshot? Please reach out to your account executive, your Customer Success Manager, [[email protected]](mailto:[email protected]), or [create a support ticket](https://support.mattermost.com/hc/en-us/requests/new?ticket_form_id=11184911962004) for assistance.
</Tip>
## Renew your subscription
System admins will be alerted 60 days prior to license expiry via a banner in Mattermost. You can also dismiss the banner and renew your license at a later date via **System Console \> Edition and License**. To renew your license, talk to a [Mattermost Expert](https://mattermost.com/contact-sales/)
## Frequently asked questions
### What is the minimum number of users I can purchase on a subscription?
The minimum purchase for a Mattermost license subscription is **more than 10 users** (i.e., at least 11). There is no set maximum — you can buy as many user seats as your organization requires.
### What is a true-up report and why is the true-up notice necessary?
A true-up report is our quarterly request for you to provide us with the actual number of activated users within your system to determine if you have more activated users now than when you bought your subscription.
As your organization grows, you may need to add additional users during your subscription period. Mattermost needs to have insight into changes in your activated user count so that we can charge you appropriately for your self-hosted license usage. Additionally, we don’t want to over estimate/charge activated users at your renewal time.
Single-channel guests are visible separately in reporting and on the **Edition and License** page. They don't count toward the primary paid seat count up to a 1:1 ratio with licensed seats, and exceeding that allowance generates system-admin warnings rather than hard limits.
When you receive the quarterly true-up notice from Mattermost, please share your activated user count with us.
### How do I renew my subscription if I don't have internet access?
If you don't have access to the internet, please [create a support ticket](https://support.mattermost.com/hc/en-us/requests/new?ticket_form_id=11184911962004) for assistance.
### Can I use my Mattermost license on more than one server?
Each license covers one deployment — either a single server, or multiple nodes in a High Availability configuration that share a single database. If you need to run a second independent server, that requires its own license. Contact your account team for assistance.
### Can I use my license in a non-production environment?
Non-production environments are provisioned with a dedicated license key separate from the production license. Customers with Premier Support are eligible for up to four non-production license keys. Customers without Premier Support should contact their account team for assistance.
### Where can I find my new license key?
Once your payment is successfully processed, your license key will be provided via email.
### How will I know when to renew my subscription?
You'll be notified 60 days prior to your subscription expiry, via a blue banner displayed at the top of your Mattermost window. This banner is only visible to system admins.
You can select **Renew license now** to begin the renewal process. You can also select the **x** to dismiss the notification. The notification is reactivated when your browser is refreshed or you reload the Mattermost Desktop App.
### How long does it take to renew a subscription?
Once you’ve started the renewal process, we'll be in contact with you to confirm your order and send you the order form. There may be additional paperwork required. Once we have the signed order form and (if applicable) the necessary paperwork from you, we're able to process the renewal and issue your license key within 24 hours.
### What happens when my subscription expires?
If you don't renew before your subscription expires, your server is automatically downgraded to [Mattermost Entry](/product-overview/editions-and-offerings). Users can still access and use Mattermost; however, paid features will no longer be available.
When you renew, the subscription features will become available with the previous configuration (provided no action such as user migration has been taken).
### Why can't I dismiss the expiry notification banner?
If there's a red expiry announcement banner stating ``Enterprise license is expired and some features may be disabled. Please contact your system admin for details.``, it means your subscription has expired. This announcement banner persists until the license is renewed, and is visible to all users.
Once a new license is applied, the banner will no longer be visible.
If you don't plan to renew your subscription, revoke the expired license in **System Console \> Edition and License**.
### Where can I find the license agreement for Mattermost Enterprise Edition?
Mattermost Enterprise Edition is the name for the binary of the Mattermost self-hosted Enterprise and Professional editions. This edition can be used for free without a license key as commercial software functionally equivalent to the open source Mattermost Team Edition licensed under MIT. When a license key is purchased and applied to Mattermost Enterprise Edition, additional features unlock. The license agreement for Mattermost Enterprise Edition is included in the software and also available [here](https://mattermost.com/enterprise-edition-license/).