System Requirements
Before installing LiquidLauncher, ensure your system meets these requirements:
- OS: Windows 10 or later
- RAM: Minimum 4 GB (8 GB or more recommended for optimal performance)
- Disk Space: At least 2 GB free space for launcher and game files
- WebView2: Automatically installed with the launcher
- OS: macOS 10.15 (Catalina) or later
- Architecture: Support for both Intel (x86_64) and Apple Silicon (ARM64)
- RAM: Minimum 4 GB (8 GB or more recommended)
- Disk Space: At least 2 GB free space
- OS: Ubuntu 22.04 or equivalent (any modern distribution with GTK 3.24+)
- Dependencies:
libwebkit2gtk-4.1, libappindicator3, libglib2.0-0
- RAM: Minimum 4 GB (8 GB or more recommended)
- Disk Space: At least 2 GB free space
LiquidLauncher automatically manages Java runtime downloads. You don’t need to install Java manually.
Download LiquidLauncher
Download the latest version of LiquidLauncher for your operating system:
Windows
Download the .msi or .exe installer
macOS
Download the .dmg for Intel or Apple Silicon
Linux
Download the .AppImage or .deb package
Visit the GitHub Releases page to find the latest version and see release notes. Installation Instructions
Download the Installer
Download either the .msi or .exe installer from the releases page.The .msi installer is recommended for most users. The .exe is a portable installer.
Run the Installer
Double-click the downloaded installer file. Windows may show a security warning:
- Click More info if you see “Windows protected your PC”
- Then click Run anyway
This is normal for applications that aren’t widely distributed yet. Complete Installation
Follow the installation wizard:
- Accept the license agreement
- Choose installation location (default is recommended)
- Click Install
- Wait for the installation to complete
The WebView2 runtime will be installed automatically if needed. Launch the Application
Once installed, launch LiquidLauncher from:
- Start Menu shortcut
- Desktop shortcut (if created)
- Or navigate to the installation directory
Troubleshooting Windows Installation
WebView2 Installation Failed
If WebView2 fails to install automatically:
- Download WebView2 Runtime manually
- Install it before running LiquidLauncher
- Restart your computer and try again
Antivirus Blocking Installation
Some antivirus software may flag the installer:
- Add an exception for LiquidLauncher in your antivirus
- Temporarily disable antivirus during installation
- Download from official sources only to ensure file integrity
Cannot Write to Installation Directory
If you get permission errors:
- Right-click the installer
- Select Run as administrator
- Choose a different installation directory with write permissions
Download the DMG
Download the appropriate .dmg file for your Mac:
- Apple Silicon (M1/M2/M3):
LiquidLauncher_aarch64.dmg
- Intel:
LiquidLauncher_x64.dmg
Not sure which chip you have? Click the Apple menu → About This Mac to check.
Open the DMG
Double-click the downloaded .dmg file to mount it. A Finder window will open.
Install the Application
Drag the LiquidLauncher icon to the Applications folder in the Finder window.
Launch LiquidLauncher
Open LiquidLauncher from your Applications folder.First launch: macOS will show a security warning because the app isn’t from the App Store:
- Click OK to dismiss the warning
- Open System Settings → Privacy & Security
- Click Open Anyway next to the LiquidLauncher message
- Confirm by clicking Open
Troubleshooting macOS Installation
'LiquidLauncher' cannot be opened
If macOS blocks the app from opening:Method 1: Using System Settings
- Go to System Settings → Privacy & Security
- Scroll to the Security section
- Click Open Anyway next to LiquidLauncher
Method 2: Using Terminalxattr -cr /Applications/LiquidLauncher.app
App is damaged and can't be opened
This can happen if the download was corrupted:
- Delete the downloaded
.dmg file
- Clear your browser cache
- Download the file again from the official GitHub releases
- Verify the file size matches what’s shown on GitHub
Wrong Architecture Downloaded
If the app won’t launch:
- Check your Mac’s chip type: Apple menu → About This Mac
- Download the correct version:
- Apple Silicon: ARM64/aarch64 version
- Intel: x64/x86_64 version
Download the Package
Download the appropriate package for your distribution:
- AppImage: Universal, works on all distributions
- DEB: For Debian/Ubuntu-based distributions
AppImage is recommended if you’re unsure which to choose.
Install Dependencies
Install required system libraries:Ubuntu/Debian:sudo apt-get update
sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev \
librsvg2-dev libglib2.0-0 libx11-dev xorg-dev libglu1-mesa-dev
sudo dnf install webkit2gtk4.1 libappindicator-gtk3 librsvg2 glib2
sudo pacman -S webkit2gtk libappindicator-gtk3 librsvg glib2
Install LiquidLauncher
Make the AppImage executable and run it:chmod +x LiquidLauncher_*.AppImage
./LiquidLauncher_*.AppImage
sudo mv LiquidLauncher_*.AppImage /usr/local/bin/liquidlauncher
Install the DEB package:sudo dpkg -i liquidlauncher_*.deb
Launch the Application
Run LiquidLauncher from:
- Application menu (search for “LiquidLauncher”)
- Terminal:
liquidlauncher (if installed system-wide)
- Or double-click the AppImage file
Troubleshooting Linux Installation
If you get library errors:ldd ./LiquidLauncher_*.AppImage
If the AppImage doesn’t start:
- Check if it’s executable:
ls -l LiquidLauncher_*.AppImage
- Make it executable:
chmod +x LiquidLauncher_*.AppImage
- Try running from terminal to see error messages
- Ensure FUSE is installed:
sudo apt-get install fuse
Wayland Compatibility Issues
If you’re using Wayland and experience issues:Try forcing X11 mode:GDK_BACKEND=x11 ./LiquidLauncher_*.AppImage
First Launch Setup
After installation, LiquidLauncher will:
-
Create data directories in your system’s default location:
- Windows:
%APPDATA%\LiquidLauncher
- macOS:
~/Library/Application Support/LiquidLauncher
- Linux:
~/.local/share/LiquidLauncher
-
Check for updates automatically on startup
-
Initialize configuration with default settings
You can change the data directory location later in Settings → General → Data Location.
Next Steps
Now that you have LiquidLauncher installed, continue to the Quickstart Guide to:
- Set up your Minecraft account
- Select a LiquidBounce version
- Launch your first game
Quickstart Guide
Get up and running in minutes
Account Management
Learn about Microsoft and offline accounts
Updating LiquidLauncher
LiquidLauncher includes automatic update functionality:
Automatic Check
The launcher checks for updates every time it starts.
Update Notification
If an update is available, you’ll see a prompt:
“A Launcher update is available. Would you like to install it now?”
Download and Install
Click Yes to download and install the update. The launcher will restart automatically.
Don’t close the launcher while an update is being installed. This could corrupt the installation.
Uninstallation
If you need to uninstall LiquidLauncher:
- Open Settings → Apps → Installed apps
- Search for “LiquidLauncher”
- Click the three dots → Uninstall
- Follow the uninstaller prompts
To remove all data:Remove-Item -Recurse -Force $env:APPDATA\LiquidLauncher
- Open Finder → Applications
- Drag LiquidLauncher to the Trash
- Empty the Trash
To remove all data:rm -rf ~/Library/Application\ Support/LiquidLauncher
For DEB package:sudo apt-get remove liquidlauncher
rm -rf ~/.local/share/LiquidLauncher
Your Minecraft game files and LiquidBounce data are stored separately and won’t be removed by uninstalling the launcher.
