Documentation - Install Guide

Windows

If you get a permission denied error during install, right click the installer and Run as Administrator. Alternatively, you can change the install location to a user-writable folder (like “[My] Documents”) during the install process.

GNU/Linux or BSD

AppImage

More information and options.

Standard Package

macOS

There are no official macOS packages, but you can build the game yourself by following Building from Source. macOS support has only recently returned and has not been tested by the developers yet, so please report any problems on our Discord or Discussions.

Building from Source

Building from source gives you the latest development version of the game on GNU/Linux, BSD or macOS.

Dependencies

Compile and Run

To update later, run git pull and git submodule update --init in the base folder, then compile again.

CMake and Xcode

The game can also be built with CMake, which can generate an Xcode project on macOS:

If you get stuck

Don’t panic! If you have trouble working out how to install and run the game, you can get assistance on our Discord or Discussions. Please be ready to provide as much information as possible, especially what operating system you’re on and specifically which package you’re trying to install!

Important Notice About Unofficial Packages

Red Eclipse is available only through the official installation methods described on this page or via Steam. Packages found on Flathub, Snap, Flatpak, AUR, Linux distribution repositories, the Ubuntu Software Store, or any other third-party source are not official, not maintained, and not supported by the Red Eclipse development team. These unofficial packages may be outdated, incomplete, or insecure, and can cause issues that we cannot assist with. For the best experience and to ensure you’re receiving verified, up-to-date builds, please install Red Eclipse exclusively through the official methods provided here or via Steam.