Non-Windows Install

Non-Windows Install
  • Views Views: 341
  • Last updated Last updated:
  • Linux Install​

    Linux Install

    This will be a general guide on installing the Star Wars Galaxies Restoration client on Linux. This guide will make the assumption that you know how to install the required content, normally I use Flatpaks to install the required software.

    Software you will need
    • ProtonUp QT
    • Lutris
    1. First install the latest Proton-GE (9.25 at the time of this writing)
    2. Browse to this link and install the SWG Restoration client
    3. Then once its installed and patched
    4. change the runner to Proton X.XX (whatever version is the latest)

    Alternative Linux Install

    I was able to get this to work as well, as the previous instructions weren't working for me.

    Software you will need:
    • SWG Restoration Install file from the official site
    • Faugus Launcher
    • Steam
    1. First open Faugus Launcher and add the SWG Restoration Install file.
    2. Run the install and let it go until it finishes and asks if you want to open SWG Resotration. Unclick it and do not open it yet.
    3. Open Steam
    4. Add SWG Restoration.exe, it will probably be in /home/USERNAME/Faugus/swg-restoration/drive_c/Program Files/SWG Restoration/SWG Restoration.exe
    5. Right click SWG Restoration.exe in steam and click on Properties
    6. Go to Compatibility
    7. Click on Force the use of a specific Steam Play compatibility tool
    8. Choose Proton Hotfix
    9. Close out and click Play
    10. Steam will launch the Restoration launcher and finish updating/installing the game and I was able to get it open after that

    Yet another Alternative Linux Install - Arch

    By ManaWei
    • Software you will need:
      - SWG Restoration install - from the official link
      - winetricks
    1. Install the game in the directory you want it, don't run it yet.
    2. Open winetricks in the console and select the "default wineprefix"
    3. Choose "Install a Windows DLL or component"
    4. Choose the following componets
      d3dcompiler_43
      d3dx9
      d3dx10
      xact
      xact_x64
      vcrun2022
    5. Press "OK" and let it process, just say yes to all the scary popups.
    6. Next, cancel back, go into the "Change settings" and grab the following
      win10
      hidewineexports=enable
      windowmanagerdecorated=n
      windowmanagermanaged=y
    7. Presss "OK" and let it run,
    8. Cancel out of winetricks and run the game. - should be working now.

    Using the 64Bit Client

    By Rayst and Zephyris13

    To be able to use the x64 Client with linux, a few extra steps are required.

    Using ProtonTricks GUI:
    1. Open ProtonTricks.
    2. Choose SWG Restoration
    3. Choose the default WINE Prefix.
    4. Choose Install a Windows DLL or component
    5. Choose the following components
      d3dc9
      d3dcompiler_43
      d3dx10
      dxvk
      xact
      vcrun2022
    6. You will get several popups, just click OK through them.
    7. At some point, you will get a Setup dialog box for Microsoft Visual C++ 2022 Redistributable (I got two dialog boxes, second one said 'Setup Failed' but everything worked fine)
    8. One all is done, go back to Steam and from Compatibility choose Proton Hotfix
    Enjoy playing SWG Restoration with the 64bit client!

    If you want to do the above but instead are more comfortable using the terminal, the equivalent steps are:

    1. Find the Prefix ID ~/.steam/steam/steamapps/compatdata/ (just look for the correct folder)
    2. Fire up a terminal and do the following-
      Code:
      killall -9 wineserver
      killall -9 wine
      protontricks [your Prefix ID] vcrun2015
      (note: vcrun2022 worked as well, but vcrun2015 is the stated minimum requirement)
      protontricks [your Prefix ID] -q d3dx9 d3dcompiler_43 d3dx10 xact
    3. Once all is done, go back to Steam and from the Compatibility choose Proton Hotfix
    If all went well, you should be able to play the game with the 64bit client.

    MacOS install​

    Written 26th Feb 2026 by jimathy
    This is not officially supported by Restoration developers (or Star Wars Galaxies in general) but I have not noticed any issues as of yet with this method.

    Crossover 26 - Paid

    All of this was done and tested on the latest versions of MacOS and Crossover Preview

    I'm no expert on the MacOS environment, but one thing I know is doing things over and over until it works.
    After lots of trial and error, the main issue seemed to be simply missing DirectX components + invisible launcher issues.
    Installing a specific DirectX Bundle seems to make it work perfectly in crossover/wine.

    This requires Crossover for Mac which comes with a two week trial
    Required Downloads:

    Create an empty bottle​

    It's easiest to create a new "bottle" for this, but can be installed to any previously used on in theory.
    1. Bottom left of Crossover [+ Install]
    2. Select: Install an unlisted application
    3. Select: Install
    4. Make sure its a New Bottle
    5. Name it SWGR
    6. Set/Leave it as Windows 10
    7. Select the directx_Jun2010_redist.exe you downloaded
      (This is an extractor to then get to the proper exe we need)
    8. Click Yes
    9. In the box set the location to
      Code:
      C:\users\crossover\Downloads\DirectX
      (this will extract it to your Mac's Download folder)
    10. Click Ok
    11. Confirm create folder

    Install missing DirectX components​

    This is required to allow the swgclient_r.exe to launch in this environment
    1. Go back to your bottle in Crossover
    2. Select: Install Application to Bottle
    3. Select: Install
    4. Navigate into your new folder you extracted DirectX installer to
    5. Select: DXSETUP.exe
    6. Select: Choose Installer
    7. Click Accept
    8. Click Next
    9. Click Next
    10. Click Finish
    11. Done!

    Install Star Wars Galaxies Restoration​

    1. Go back to your bottle in Crossover
    2. Select: Install Application to Bottle
    3. Select: Install
    4. Select SWG Restoration Install.exe from your downloads
    5. Select: Choose Installer
    6. Click: Agree
    7. Install to:
      Code:
      C:\SWG Restoration
    8. Finish

    Update launch command to fix launcher issues​

    1. Go back to your bottle
    2. Select: Run Command
    3. In the command Command section enter:
      Code:
      "C:\SWG Restoration\SWG Restoration.exe" --disable-gpu --in-process-gpu --disable-gpu-compositing --disable-gpu-rasterization --disable-software-rasterizer --use-gl=swiftshader
    4. Select: Save Command as Launcher
      This overrides the current applications run command in the bottle so you don't need to do this every time
    5. Go back to bottle your bottle
    6. Run SWG Restoration from the icon in your bottle
    7. Enter login details and then wait for patch/update

    Launch the Game​

    1. Wait for download to finish
    2. Select: PLAY
    3. Will prompt to install required DirectX components
    4. Select: OK
    5. Select: Next
    6. This will instantly complete, we have all the required DirectX Components and more
    7. Select: Finish
    8. Select: PLAY
    9. First time setup asks to set graphic options
      I enabled Windowed and Borderles. I personally run this on a Macbook Air M4 2025, I set to 1710 x 1107 @ 60 Hz
    And we're in!

    Sikarugir - FREE

    Written 4th March 2026 by jimathy

    This is a tricky and has a less user friendly start and requires some terminal usage
    But its arguably tidier and cleaner and ends up acting like a native Mac Application.
    I got it working fairly easily and it launched without issue when done.

    Required Downloads:

    Install Homebrew​

    Open you mac terminal and run this command:
    Code:
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    Install Sikarugir​

    Open your mac terminal and run these commands:
    Code:
    brew upgrade
    brew install --cask Sikarugir-App/sikarugir/sikarugir

    If you are running a newer Silicon Mac (you cant use bootcamp) install Rosetta2 too
    Code:
    usr/sbin/softwareupdate --install-rosetta --agree-to-license

    Creating up your wrapper​

    1. Open Sikarugir.app in your Mac Applications folder
    2. This will open the Sikarugir Creator window
    3. Click: Download Template and wait until its done
    4. Set the engine to WS12WineSikarugir10.0_4
    5. Click Create
    6. Name it SWGR
    7. Tell it to create it in your Applications Folder
    8. Wait for finish creating and a popup will appear
    9. Select: Launch It

    Setting up your new wrapper​

    You should now be looking at its Configure.app
    1. Tick DirectX to Metal translation layer - (DXMT)
    2. This isn't needed but: Save this image and Set the icon to it:
      Code:
      https://swgr.org/styles/resto/SWGR-Holo-192.webp

    Install missing DirectX components​

    1. Select: Install software
    2. Select the directx_Jun2010_redist.exe you downloaded
    3. Popup will appear saying "Maybe the installer failed?"
    4. Ignore this and Select: OK
    5. Go back to the installer (it should be in your dock)
    6. (This is an extractor to then get to the proper exe we need)
    7. Click Yes
    8. In the box set the location to
      Code:
      C:\users\ [your name] \Downloads\DirectX
      (this will extract it to your Mac's Download folder)
    9. Click Ok
    10. Confirm create folder
    Back in the Configure app:
    1. Install software
    2. Direct to the new folder you created and DXSETUP.exe
    3. Popup will appear saying "Maybe the installer failed?"
    4. Ignore this and click ok
    5. Go back to the installer in your dock
    6. Click Accept
    7. Click Next
    8. Click Next
    9. Click Finish

    Install Star Wars Galaxies Restoration​

    Back in the Configure app:
    1. Install software
    2. Direct to SWG Restoration Install.exe
    3. Set install location to:
    4. C:\SWG Restoration
    5. Click Agree
      This sometimes appears to crash the Configure app with a "Busy" message that never goes away.
      Force close this and re-open your SWGR.app you created this should bring you back to the configure app as we havent set an app to open yet

    Launch the Game​

    1. Wait for download to finish
    2. Select: PLAY
    3. Will prompt to install required DirectX components
    4. Select: OK
    5. Select: Next
    6. This will instantly complete, we have all the required DirectX Components and more
    7. Select: Finish
    8. Select: PLAY
    9. First time setup asks to set graphic options (This takes a whle to show up)
      I enabled Windowed and Borderles. I personally run this on a Macbook Air M4 2025, I set to 1710 x 1107 @ 60 Hz

    Update launch command to fix launcher issues​

    Back in the Configure app:
    1. Set launcher link to:
    2. Code:
      "C:\SWG Restoration\SWG Restoration.exe" --disable-gpu --in-process-gpu --disable-gpu-compositing --disable-gpu-rasterization --disable-software-rasterizer --use-gl=swiftshader
    3. The extra variables are to make the launcher show as its invisible without them
    4. Login and update/patch

    And we're in!

    Now the launcher link is set. When selecting the new app, it will open the SWGR launcher directly!

    Troubleshooting​

    Weird FPS Limit​

    I had a very odd issue of the game running at 120fps even though VSync was on (which should make it 60fps) which was causing unessesary stress on the cpu/gpu.
    This requires ReShade, but I recommend running the game in windowed/borderless mode because in fullscreen it needs to complie everything every time you tab in or out.
    I spent a full 2 days of trying different methods to get this working.
    1. Download ReShade (with full add-on support) latest from this link
    2. Crossover Specific:
      1. Go back to your bottle in Crossover
      2. Select: Install Application to Bottle
      3. Select: Install
      4. Select ReShade_Setup_*.*.*_Addon.exe from your downloads
      5. Select: Choose Installer
    3. Sikarugir Specific:
      1. Right click your SWGR.app
      2. Show Package Contents
      3. Open the contents folder
      4. Run Configure.app
      5. Tools > Config Utility > Libraries
      6. New override for Library type d3d9 and click Add
      7. Close that and go back to Configuration in the Configure app
      8. Install Software
      9. Select ReShade_Setup_*.*.*_Addon.exe from your downloads
    4. It will show a warning, just press OK
    5. Select: Browse... at the bottom of the window
    6. Guide to your installation My Computer > C: > SWG Restoration > x64 and select SwgClient_r.exe
    7. Select: Next
    8. Select: DirectX 9
    9. Here you can either add effects of choose uncheck all for a blank installation
    10. Then it asks for what addons to install, just click next
    11. ReShade is now installed to and will load when you start the game
      If the installer still shows as open and in your dock, just Cancel the install in CrossOver and then Quit All Applications in your bottle. It's already finished.
    12. Then we now need to download renodx-fpslimiter.addon64 from this link
    13. Go to your bottle and choose Open C: Drive to access the files and folder of the bottle
    14. Navigate to C: > SWG Restoration > x64 and move this new downloaded file to here
    15. Then, launch the game and access ReShade overlay with keyboard Home button (if you don't have one use fn + left arrow)
    16. For me it showed the FPS limiter in a small window, you can drag this to the side and resize it as needed
    17. Set it to the desired fps (recommended 60) and that should be remembered through closing and opening

    Steam Deck Setup​

    Steam Deck Setup

    Linux Install (Lutris)​

    This will be a general guide on installing the SWGR client on Linux - the steps are exactly the same for setting up the Steam Deck. This guide will make the assumption that you know how to install the required content, normally I use Flatpaks to install the required software.

    Software you will need
    • ProtonUp QT (or ProtonPlus)
    • Lutris
    First install the latest Proton-GE (10.28 at the time of this writing)
    Browse to this link and install the SWG Restoration client
    Then once its installed and patched, change the runner to Proton X.XX (whatever version is the latest)

    Linux Install (Steam)​

    Software you will need
    • Steam
    • protontricks (for installing Directx9 into the SWGR Proton directory)
    • Proton-GE (follow the installation instructions on the README)
    Steps To Install
    1. Download the SWG Restoration (SWGR) Installer
    2. Add the SWGR Installer to Steam's Non-Steam Games (Games > Add a Non-Steam Game to My Game Library)
    3. In the game's Steam properties (it will be named SWG Restoration Install.exe)
      1. Set "Start In" to be the directory you'd like the game files to be located (Example /home/username/.local/share/swgr)
      2. Set the game's compatibility tool to Proton-GE
    4. Launch the installer from Steam and complete the installation (uncheck start SWGR at the end of the installation process)
    5. Find where within steam the SWGR launcher was installed. Run the following in the terminal
      Code:
      find ~/.local/share/Steam/ -name 'SWG Restoration.exe'

      It should be something like
      Code:
      /home/username/.local/share/Steam/steamapps/compatdata/123456789/pfx/drive_c/Program Files/SWG Restoration/SWG Restoration.exe
    6. Note down the App ID (it's the folder name with only numbers. In the example above it's 123456789)
    7. In the game's Steam properties
      1. Update the target to be the full path of SWG Restoration.exe
      2. Update the game name to SWG Restoration
    8. Install Directx9 and configure SWGR's Proton settings using the App ID in the earlier step. Run the following in the terminal, replacing APP_ID_HERE:

      Code:
      protontricks <APP_ID_HERE> d3dx9_39 dxvk win10 windowmanagerdecorated=n windowmanagermanaged=y hidewineexports=enable
      Using the App Id in the example:
      Code:
      protontricks 123456789 d3dx9_39 dxvk win10 windowmanagerdecorated=n windowmanagermanaged=y hidewineexports=enable

    You've now installed and can run the SWG Restoration Launcher from Steam.

    Steam Deck - Black Screen with Audio Fix​

    Upgrade Proton-GE to the latest version with ProtonUp, and make sure you have ProtonTricks installed.

    Follow the instructions to install the game via lutris, but do not add it to steam through Lutris, you'll need to add the game to steam as a non-steam game instead of a shortcut to lutris.
    1. Head over to steam and click on the + sign in the bottom left of the screen.
    2. Select: Add a non-steam game
    3. Browse to the SWG Restoration install from Lutris at:
      Code:
      /home/deck/Games/Star Wars Galaxes - An Empire Divided
      or whatever name you chose for the game folder.
    4. Select SWG Restoration.exe
    5. Select properties on the new steam game and change the compatibility mode to the same Proton version as Lutris.
    6. Launch the game once so it will appear in Proton Tricks, but close it right after.

    Launch Proton Tricks and find the non-steam game in the list of games and either double-click it.
    Proton Tricks will take some time to open again, it will not hang!

    1. The checkbox select the default wineprefix should be selected
    2. Click ok
    3. Select Change settings and click Ok
    4. Check the boxes for hidewineexports=enable, win10, windowmanagerdecorated=n, windowmanagermanaged=y and click okay.
    Again, Proton Tricks will take some time and some scary looking pop-ups will appear after a long while, they can be ignored.
    1. Finally you should be able to see all the options again
    2. Select: Install a Windows DLL or component and click Ok
    3. Check the boxes for d3dx9_39 and dxvk and then click Ok
    Once again some scary looking pop-ups will appear after a long while, though they should just be telling you to check the documentation.

    If everything worked as planned, this non-steam game, named SWG Restoration.exe by default, should work in desktop and gaming mode!

    I found that renaming the game in gaming mode to SWG Legends would pull up the best community control schemes, (defib's steam deck controls is the set i use, with slight alterations).