💾 Install & Update Problems

Wine prefix creation failed

  • If the LUG Helper install log shows an error similar to:
    warning: WINE is /path/to/bin/wine, which is neither on the path nor an executable file
    To fix, cat /proc/mounts and make sure the mount point is not marked noexec. You may need to explicitly set defaults or exec.
  • If the install log shows an error similar to:
    SHA256 mismatch or no valid cabinets found
    To fix, delete the winetricks cache in ~/.cache/winetricks/ and try installing again

RSI Launcher installation hangs at Updating Game Content

  • The Launcher sometimes hangs during this phase of the install process
  • Completely quit the launcher, ensuring no lingering wine processes remain, then verify files

RSI Launcher error: Unable to Create Folder

  • This is a known issue with the RSI Launcher, possible error code 8004
  • Manually create the LIVE/PTU/TECH-PREVIEW directory after installing the RSI Launcher with the Helper. For a default install path, you can run:
    mkdir -p "~/Games/star-citizen/drive_c/Program Files/Roberts Space Industries/StarCitizen/LIVE"
    

RSI Launcher fails to start

  • Possible cause: Outdated glibc
    • Log message may include could not load ntdll.so ... version 'GLIB-C_x.xx not found'
    • Update to the latest release of a non-LTS distro

RSI Launcher executable is missing

  • Automatic update sometimes fails or is interrupted
  • Follow manual update instructions

RSI Launcher doesn’t auto-update

RSI Launcher freezes within a few seconds of opening

RSI Launcher Black or white window

  • Try editing the launch script to add the RSI Launcher flags --in-process-gpu --disable-gpu. For example:
      "$wine_path"/wine "C:\Program Files\Roberts Space Industries\RSI Launcher\RSI Launcher.exe" --in-process-gpu --disable-gpu > "$launch_log" 2>&1
    

RSI Launcher empty or crash

  • Try logging out and back in, or reset the launcher by pressing Ctrl+Shift+Alt+R
  • Delete the rsilauncher directory in the wine prefix’s Appdata
    star-citizen/drive_c/users/<your username here>/AppData/Roaming/rsilauncher
  • Try disabling Nvidia Smooth Motion
  • If using Pop!_OS Cosmic, this is a known issue.
    • Try using the LUG Helper’s Open Wine prefix configuration
      option in the Maintenance menu to turn on virtual desktop mode
    • Try xwayland-run package
      ############################################################################
      # Launch the game
      ############################################################################
      xwayland-run -- "$wine_path"/wine "C:\Program Files\Roberts Space Industries\RSI Launcher\RSI Launcher.exe" > "$launch_log" 2>&1
      
    • Try switching to Experimental Wine Wayland
    • Try gamescope, or an alternative compositor

RSI Launcher minimizes and won’t re-open

  • Try to restore the window using the taskbar icon
  • If that doesn’t work, open your Wine prefix, then delete the rsilauncher directory in the wine prefix’s Appdata
    star-citizen/drive_c/users/<your username here>/AppData/Roaming/rsilauncher
  • To avoid the problem in the future, turn on Enable close-to-quit in the RSI Launcher settings

RSI Launcher indicates You are currently offline

  • Log out and back in

Launch Error - Settings.json not found

  • Verify game files

RSI Launcher Error Code 60101

Installing Star Citizen on an NTFS-formatted drive

  • Don’t; it probably won’t work and will likely only corrupt your game files.
  • Ensure that you are using a Recommended 64 bit linux distro
  • Override environment variable WINEARCH=64

openSUSE Tumbleweed: Wine prefix creation failed

  • If SELinux is enabled (default) on openSUSE, the selinux-policy-targeted-gaming package is required or game installation will fail.
  • Manually install selinux-policy-targeted-gaming from the openSUSE repos. Alternatively, both Steam and Lutris pull in this package as a dependency.