Installation#

Mensury uses one launcher to install the client, manage Java, and keep everything up to date. You do not need to download a separate Minecraft version, Fabric, or Java runtime first.

Before you start#

You need:

a supported Windows, macOS, or Linux device
an internet connection for the initial download and updates
a Microsoft account that owns Minecraft: Java Edition
enough free storage for Minecraft, the Mensury Client, Java, and future updates

See System Requirements for the current hardware and operating system guidance.

Download Mensury#

Select Join Discord and choose the package for your operating system. Only download Mensury from the official website.

Windows#

Download the Windows .exe installer.
Open it and complete the installation.
Launch Mensury Client from the installer, Start menu, or desktop shortcut.

Windows or your browser may show a security warning while Mensury is still building reputation as a new app. Check that the file came from the official Mensury website before continuing.

macOS#

Download the macOS .dmg file.
Open it and move Mensury Client to Applications.
Open Mensury from Applications.

If macOS blocks the first launch, open System Settings → Privacy & Security and choose Open Anyway for Mensury.

Linux#

Choose the package that fits your setup:

.deb: Open the package in your software manager and select Install. Enter your password if asked.
AppImage: Make the downloaded file executable, then open it. AppImages run directly and do not install system-wide.

You can make an AppImage executable from Properties → Permissions or from a terminal:

chmod +x ~/Downloads/Mensury-*.AppImage

What the launcher installs#

On the first play, the launcher prepares the files Mensury needs:

the current Mensury Client build
Minecraft and its required libraries
a compatible Java runtime
required Fabric libraries
optional mods you choose during setup

These game files are separate from the launcher application. By default, they live in the system data directory under a folder named Mensury. You can see the exact location or move it to another drive under Settings → Folders → Game Files.

Updates#

The launcher checks for Launcher and Client updates automatically. Client files, managed libraries, and the mod catalog are prepared before play when an update is available.

Your personal files are kept separate from managed files. Updating Mensury does not remove your worlds, screenshots, resource packs, shader packs, or manually added mods.

After installation#

Open the launcher, sign in with the Microsoft account that owns Minecraft: Java Edition, review the first-time setup, and select Play. Continue with the First Launch Guide for a walkthrough.

Uninstalling Mensury#

The desktop app is named Mensury Client, even though it also contains the launcher. Removing the app uninstalls the launcher itself. Downloaded game files are kept so that an uninstall, repair, or later reinstall does not erase personal Minecraft data.

Remove the app using the method for your platform:

Windows: Open Settings → Apps → Installed apps, find Mensury Client, and select Uninstall.
macOS: Close Mensury, open Applications, and move Mensury Client to the Trash.
Linux (.deb): Remove Mensury Client through the same software manager or package manager you used to install it.
Linux (AppImage): Close Mensury and delete the .AppImage file.

Removing all game files#

If you want a full removal, delete the separate Mensury game files folder after uninstalling the app.

Before uninstalling, open Settings → Folders → Game Files → Open Folder and note its location. This is the safest way to find it because the folder may have been moved to another drive. The default location is:

Windows: %APPDATA%\Mensury
macOS: ~/Library/Application Support/Mensury
Linux: $XDG_DATA_HOME/Mensury, or ~/.local/share/Mensury when XDG_DATA_HOME is not set