Cargando

Cargando...

Skip to content
CubicLauncherDocs

Installation

Install CubicLauncher on Windows, Linux, macOS, Nix/NixOS and Docker. Follow the instructions for your operating system to get started.

Installing CubicLauncher is a straightforward process. Follow the instructions for your operating system to get started.

Prerequisitesedit

CubicLauncher does not need Java installed to open, but it does need it to play Minecraft. You can use the launcher's managed JREs or configure an external one. See What is Java.

As a general guide, CubicLauncher can install and detect Java 8, 17, 21 and 25:

  • Java 8 for old Minecraft versions.
  • Java 17 for modern versions that require it.
  • Java 21 for the most recent versions.
  • Java 25 for versions or loaders that request it.
Tip

CubicLauncher does not need Java installed on the system to run, but you need Java installed to play Minecraft.

Windowsedit

  1. Download the .exe or .msi installer from our downloads page.
  2. Run the file and follow the installer steps.
  3. Once finished, CubicLauncher will be ready on your desktop.

Linuxedit

We offer support for multiple formats on Linux:

  • RPM: Download, grant execution permissions and open.
  • AppImage: Download, grant execution permissions and open.
  • Debian/Ubuntu: Install the .deb package using sudo apt install ./cubiclauncher.deb.
  • ARCH PKGBUILD: Local compilation is required. Binaries generated by GitHub CI (Ubuntu) may not be compatible with Arch Linux due to its rolling release model. Guide.
  • Nix/NixOS: Install the latest stable channel with nix profile add github:CubicLauncherDevs/CubicLauncher/latest-release. Optionally configure the Cachix cache with nix run nixpkgs#cachix -- use cubiclauncher. Guide.
  • Docker: Pull the multi-architecture image with docker pull ghcr.io/cubiclauncherdevs/cubiclauncher:latest and run it with access to X11 or Wayland, the GPU and a data volume. Guide.

NVIDIA and Wayland: blank windows or crashesedit

If the launcher stays blank, flickers or crashes when resizing, see Linux graphics issues: NVIDIA and Wayland. The guide explains WEBKIT_DISABLE_COMPOSITING_MODE=1 cubiclauncher, WebKitGTK alternatives and how to apply a workaround to a desktop shortcut.

macOSedit

  1. Download the corresponding file (.dmg, x64.dmg, .app.tar.gz or x64.app.tar.gz).
  2. If you downloaded a .dmg or x64.dmg, open it and drag CubicLauncher to your Applications folder.
  3. If you downloaded an .app.tar.gz or x64.app.tar.gz, extract it and move CubicLauncher.app to your Applications folder.
  4. The first time you open it, you may need to allow execution from System Preferences > Security & Privacy.