← Moonlight Mod GuidesGuide · 7 min read

Moonlight Mod on macOS and Linux

Platform-specific notes for macOS and Linux, including installer behavior, supported layouts, and update expectations.

Moonlight Mod on macOS and Linux featured image

This guide focuses on a maintainable approach: use official upstream sources, make one meaningful change at a time, and keep a clear recovery path if a Discord or Moonlight update changes behavior.

macOS expectations

The official documentation provides a macOS installer but notes that signing and persistence across Discord updates can require extra attention. Keep the installer available for re-patching.

Linux installation paths

The installer supports specific Linux layouts. User-local Discord installs and user Flatpak installs are the documented paths, while system package-manager layouts may not be supported by the installer.

Prefer documented packages

On Linux, use the documented Flatpak or Nix options when they fit your system rather than forcing files into a package-managed Discord installation.

Troubleshoot by platform

Do not apply Windows folder instructions to macOS or Linux. Confirm the platform-specific support notes first, then check Moonlight issues for changes related to recent Discord updates.

Reminder: Moonlight is a Discord client mod. The official documentation warns that client mods are against Discord's Terms of Service, so consider that policy risk before installation.

Useful upstream links

Moonlight GitHub project ↗ · Installer repository ↗ · Official documentation ↗