mattermost / mattermost/mattermost-operator

Mattermost Operator defaults to multiple replicas, breaking core messaging for non-Enterprise users

Open
#447 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
143
Forks
90
Avg merge
5d 23h
Merged PRs (30d)
2

Description

The Mattermost Operator currently defaults to a configuration that enables High Availability (HA) features (specifically replicas > 1) which are functionally unstable without an active Enterprise clustering license.

In the Community Edition, running multiple replicas leads to a fragmented state. This results in messages randomly failing to appear on clients until a manual refresh is performed.

Current Behavior: The Operator deploys multiple replicas by default. The system enters a "split-brain" state regarding real-time delivery.

Expected Behavior: The Operator should detect the absence of a license or default to replicas: 1 for community installations. High Availability should be an explicit opt-in feature, accompanied by a warning that it requires an Enterprise license to function correctly.

Proposed Mitigation/Fix:

  1. Change Defaults: Set the default replica count to 1 in the Custom Resource Definition (CRD) or the Operator logic.

  2. License Validation: If replicas > 1 is requested, the Operator should log a warning if no valid clustering license is detected.

  3. Documentation: Explicitly state in the README/Documentation that multiple replicas are unsupported and unstable in the Community Edition.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the Custom Resource Definition and Operator logic that set the default replica count, then inspect any existing license-handling entry points. Check the README or documentation for current Community Edition guidance; done means Community installations default to one replica, multi-replica requests receive the specified warning or validation, and the limitation is documented.

Written by the indexing model from the issue text.

Assessment

Tech stack
go, kubernetes
Domain
devops, infrastructure
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.