Skip to content

Document macOS MDM-managed configuration support (Desktop v6.2.0+)#8962

Merged
esethna merged 1 commit into
v11.7-documentationfrom
claude/issue-8960-20260512-1639
May 14, 2026
Merged

Document macOS MDM-managed configuration support (Desktop v6.2.0+)#8962
esethna merged 1 commit into
v11.7-documentationfrom
claude/issue-8960-20260512-1639

Conversation

@Combs7th
Copy link
Copy Markdown
Contributor

Adds a short admin-facing section to the Desktop MSI installer and group policy guide noting that, from Mattermost Desktop v6.2.0, the same organization-level settings available via Windows group policy can be managed on macOS via managed preferences delivered through an MDM solution.

Refs mattermost/desktop#3692
Resolves #8960

Generated with Claude Code

Adds a short admin-facing section noting that, from Mattermost Desktop
v6.2.0, the same organization-level settings available via Windows group
policy can be managed on macOS via managed preferences delivered through
an MDM solution.

Refs mattermost/desktop#3692
Resolves #8960

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
@Combs7th Combs7th changed the base branch from master to v11.7-documentation May 12, 2026 16:43
@Combs7th Combs7th added 1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor labels May 12, 2026
@Combs7th Combs7th added this to the v11.7.0 milestone May 12, 2026
@Combs7th Combs7th requested a review from devinbinnie May 12, 2026 16:44
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 12, 2026

Review Change Stack
No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ae2dca41-2cc4-4ca7-bac8-027623ada5b0

📥 Commits

Reviewing files that changed from the base of the PR and between d63b6e0 and f9dd597.

📒 Files selected for processing (1)
  • source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst

📝 Walkthrough

Walkthrough

This pull request adds a documentation section describing macOS managed device management (MDM) configuration support to the Mattermost Desktop deployment guide. The addition documents that starting with Desktop v6.2.0, administrators can manage supported desktop configuration on macOS via MDM, with feature parity to existing Windows group policy controls, and notes the requirement to restart the application after configuration updates.

Changes

macOS MDM Configuration Documentation

Layer / File(s) Summary
macOS MDM configuration section
source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst
New section documents macOS MDM support for managing Mattermost Desktop configuration starting with v6.2.0, including support for the same configuration items as Windows group policy (predefined server lists, server management controls, and update notification controls), and specifies that admins must deploy an MDM configuration profile and restart the app after changes.

🎯 1 (Trivial) | ⏱️ ~2 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely summarizes the main change: documenting macOS MDM-managed configuration support for Desktop v6.2.0+, which directly matches the single-file documentation addition.
Description check ✅ Passed The description is directly related to the changeset, explaining that a section was added to document macOS MDM-managed configuration support, referencing the upstream Desktop PR and linked issue.
Linked Issues check ✅ Passed The PR fully satisfies issue #8960 requirements: it confirms PR evidence (mattermost/desktop#3692), identifies the correct docs file, provides admin-facing content about macOS MDM configuration management capabilities, and avoids out-of-scope areas like changelogs or implementation details.
Out of Scope Changes check ✅ Passed All changes are in-scope and directly address the linked issue: only the target documentation file was modified with admin-facing content about macOS MDM support, with no changelog, upgrade notes, or implementation-detail additions.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/issue-8960-20260512-1639

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@Combs7th
Copy link
Copy Markdown
Contributor Author

Heya @devinbinnie - I have a first docs pass up for the macOS managed Desktop configuration update:

Could you take a quick look and confirm:

  1. The macOS MDM / managed preferences wording is accurate.
  2. Whether we should publish the exact macOS preference domain.
  3. The correct update-control key spelling: EnableAutoUpdates vs. EnableAutoUpdater.

Thanks!

@github-actions
Copy link
Copy Markdown
Contributor

Newest code from mattermost has been published to preview environment for Git SHA f9dd597

Copy link
Copy Markdown
Member

@devinbinnie devinbinnie left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Thanks @Combs7th!

@amyblais amyblais removed the 1: Dev Review Requires review by a core commiter label May 13, 2026
@Combs7th Combs7th requested a review from esethna May 14, 2026 04:05
@Combs7th
Copy link
Copy Markdown
Contributor Author

@esethna - Ready for merge.

@esethna esethna merged commit bd364c3 into v11.7-documentation May 14, 2026
7 checks passed
@esethna esethna deleted the claude/issue-8960-20260512-1639 branch May 14, 2026 18:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

2: Editor Review Requires review by an editor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update Desktop App managed configuration docs for macOS MDM

4 participants