How to Install the Cubion Launcher (Windows, Mac & Linux)

Welcome! This step‑by‑step guide helps you install Cubion on Windows, macOS or Linux. We’ll cover system requirements, downloading safely, running the installer on each platform, and getting ready to play.

Check System Requirements

Before installing Cubion, make sure your system meets these minimum requirements. Note that Cubion will automatically install the correct Java version for you:

Windows

• OS: Windows 10 (64-bit) or newer
• RAM: 4GB minimum (8GB recommended)
• Java: Java 17 or newer (will be installed automatically if needed)
• Storage: 2GB free space for launcher + game files

macOS

• OS: macOS 10.15 (Catalina) or newer
• RAM: 4GB minimum (8GB recommended)
• Java: Java 17 or newer (included with installer)
• Storage: 2GB free space for launcher + game files

Linux

• OS: Ubuntu 18.04+, Fedora 32+, or equivalent
• RAM: 4GB minimum (8GB recommended)
• Java: OpenJDK 17 or newer
• Storage: 2GB free space for launcher + game files

Download Cubion

1. Visit the official Cubion website at cubion.io
2. Click the Download button for your operating system
3. The download will start automatically

Security Note: Always download Cubion from the official website to protect against malware and ensure you get the authentic launcher.

Installation Instructions

Install on Windows

1. Run the Installer

   • Double-click the downloaded cubion-windows.exe file
   • If Windows SmartScreen appears, click “More info” then “Run anyway”

2. Installation Wizard

   • Choose your installation directory (default is recommended)
   • Select whether to create desktop and start menu shortcuts
   • Click “Install” to begin the installation

3. First Launch

   • Launch Cubion from your desktop shortcut or Start menu
   • The launcher will automatically update to the latest version
   • You’re ready to log in with your Microsoft account!

Install on macOS

1. Mount the DMG

   • Double-click the downloaded cubion-macos.dmg file
   • A window will open showing the Cubion application

2. Install the Application

   • Drag the Cubion icon to your Applications folder
   • Wait for the copy process to complete

3. First Launch

   • Open Cubion from your Applications folder or Launchpad
   • If macOS shows a security warning, go to System Preferences > Security & Privacy and click “Open Anyway”
   • Enter your admin password if prompted

Install on Linux

1. Make the AppImage Executable

   chmod +x cubion-linux.AppImage
   

2. Run Cubion

   ./cubion-linux.AppImage
   

3. Optional: Install to Applications

   • Right-click the AppImage and select “Integrate and run”
   • Or move it to /opt/cubion/ for system-wide access

4. Desktop Integration (Optional)

   # Create desktop entry
   mkdir -p ~/.local/share/applications
   cat > ~/.local/share/applications/cubion.desktop << EOF
   [Desktop Entry]
   Name=Cubion
   Exec=/path/to/cubion-linux.AppImage
   Icon=cubion
   Type=Application
   Categories=Game;
   EOF
   

Initial Setup

After installation, you’ll need to complete the initial setup:

1. Login with Microsoft Account

1. Click Login on the main screen
2. Select Microsoft Account (recommended) or Mojang Account
3. A browser window will open - log in with your Minecraft account
4. Return to Cubion once authentication is complete

2. Configure Settings

1. Click the Settings gear icon
2. Memory Allocation: Set RAM allocation (4-8GB recommended)
3. Java Settings: Cubion will use the best Java version automatically
4. Theme: Choose your preferred launcher theme

3. Install Your First Modpack

1. Click Browse Modpacks on the main screen
2. Choose from CurseForge or Modrinth
3. Select a popular modpack like “All the Mods” or “FTB Academy”
4. Click Install and wait for completion
5. Click Play to launch!

Troubleshooting Installation Issues

Windows Issues

“Windows protected your PC” warning

• Click “More info” → “Run anyway”
• This is normal for new software

Installation fails

• Run as Administrator: Right-click installer → “Run as administrator”
• Temporarily disable antivirus during installation

macOS Issues

“Cubion can’t be opened because it’s from an unidentified developer”

• Go to System Preferences → Security & Privacy
• Click “Open Anyway” next to the Cubion warning

Cubion won’t launch

• Try: System Preferences → Security & Privacy → Privacy → Full Disk Access
• Add Cubion to the list of allowed applications

Linux Issues

AppImage won’t run

# Install fuse if missing
sudo apt install fuse libfuse2  # Ubuntu/Debian
sudo dnf install fuse fuse-libs  # Fedora

Permission denied

chmod +x cubion-linux.AppImage

Missing dependencies

# Install required libraries
sudo apt install libc6 libstdc++6 libgcc1  # Ubuntu/Debian

Updating Cubion

Cubion automatically checks for updates when you launch it. To manually update:

1. Open Cubion
2. If an update is available, you’ll see a notification
3. Click Update Now to download and install
4. Restart Cubion to complete the update

Next Steps

Now that Cubion is installed, you’re ready to:

• Browse and install modpacks
• Configure performance settings
• Set up multiple instances
• Join the community on Discord

Getting Help

If you encounter any issues:

• Check our Knowledge Base for common solutions
• Ask for help in our Discord community
• Email us at main@cubion.io

Welcome to the Cubion community! Enjoy your enhanced Minecraft experience.