Skip to main content
Help center
Start typing for instant answers...
Back to website
Contact Support
Sign in
Mattermost Knowledge Base
Self-Managed
Self-Managed
Troubleshooting for on-prem deployments.
General
Choosing a GIPHY API Key in Mattermost: Your Own Key or the Built-in Default
Cannot Pin or Unpin Messages Older Than the Post Edit Time Limit After Upgrading to v11.7.0
Microsoft Entra ID OIDC Authentication Requires a Client Secret; Managed Identity Not Supported
How to Migrate or Upgrade a PostgreSQL Database to a New Host or Version
Mattermost Upgrade Fails in staging environment due to Database Ownership and Migration Errors
Mattermost 11.x Upgrade Error: Hidden Archived Channels
See all 34 articles
CLI & MMCTL
mmctl Fails With a Credentials Error, and Deactivated AD/LDAP Users Keep Reactivating
Troubleshooting: Migrating a User from GitLab OAuth to SAML in Mattermost
Troubleshooting Guide: Delays in Managing Personal Access Tokens in Mattermost
Delete old archived channels
Locked Out of System Administrator Account
Licensing
Eligibility for Mattermost Staging/Testing Licenses
How to Resolve the "Invalid Signature" Error in Mattermost when requesting a Trial License
Updating a Mattermost Enterprise License
Infrastructure and Monitoring
Playbooks "Add Channel to Sidebar Category" Action Fails After MySQL to PostgreSQL Migration
Configure Read/Write Splitting for Mattermost with a Patroni-Managed PostgreSQL Cluster
Why Using DataSourceReplicas Is Recommended: Node-Role vs SQL-Aware Proxies
MaxOpenConns multiplies across data sources and HA nodes, causing connection exhaustion
Elasticsearch/OpenSearch ClientKey Path Overwritten with Masked Value on Config Save (v10.11.15-v10.11.17)
Mattermost Fails to Start After apt Upgrade: Port 443 Permission Denied
See all 35 articles
SAML Integration
SAML SSO with Entra ID: Resolving Signature Verification Errors
Solving "Duplicate Username" SAML Login Warning in Mattermost
AD and LDAP Integration
LDAP User Remains Deactivated After Returning - AuthData Mismatch on IdAttribute Change
Understanding LDAP `objectGUID` Encoding in Mattermost
LDAP Configuration Troubleshooting in Mattermost (Bind & Sync)
Resolving “An account with that email already exists” During SAML Login in LDAP-Integrated Deployments
Using ldapsearch
LDAP Deactivates Users Unexpectedly
See all 8 articles
Plugins
AI Services List Is Empty After Upgrading from Mattermost Agents v1 to v2
Mattermost Agents v2: OpenAI compatible AI Service Fails with "No Valid Keys" Error Due to Missing API Key
GitLab Plugin v1.12 Upgrade Leaves Existing Instances Without Migrated OAuth Configuration
Calls Recording Fails With "failed to initialize job service" After Reboot
MS Teams Meetings Plugin Fails After Upgrading to Mattermost 10.11.6
Auto Translate Plugin Error: AWS Region Must Be Lowercase
See all 10 articles
Return to top
Can't login, AD/LDAP setup, Server troubleshooting