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.
Check what changed
Review the newest release notes before updating. Fixes often target a recent Discord change, while extension or mapping updates can affect specific customizations.
Use the installer first
The official installer is designed to manage Moonlight installation and patching. Running the current installer is safer than copying random build files into Discord folders.
Stable versus nightly
Stable is the better default for most users. Nightly builds can include newer fixes but may also contain changes that have had less real-world testing.
After the update
Launch Discord and test core functionality before enabling extra extensions. If anything fails, compare the behavior with extensions disabled before reinstalling the client.
Useful upstream links
Moonlight GitHub project ↗ · Installer repository ↗ · Official documentation ↗