Setting Up FAF Linux

From FA Forever Wiki
Jump to: navigation, search

Supreme Commander: Forged Alliance (the game) runs under Linux using wine.

The community client (the client) is written in Python3/PyQt5, which means that the client runs straight away on Linux.

Install the python client

Arch Linux

You need AUR access, so install something like yaourt. Then install my package with

yaourt -S python-fafclient

This should install wine as a dependency. Now you can install the game using wine. You can use your default wine prefix or create a new one. A nice UI tool for handling wine prefixes is PlayOnLinux.


There's no .deb package yet, please create one. Some discussion about that is in

Here are preliminary instructions how to make the client run from source on Ubuntu 17.04:

install required packages:

sudo apt-get install python3-pycparser python3-dateutil python3-requests python3-cffi python3-semantic-version python3-virtualenv python3-dev liblua5.1-0-dev xdelta3 git

set up a virtualenv to install non-packaged python libraries:

mkdir fafclient && cd fafclient
python3 /usr/lib/python3/dist-packages/ -p python3 --system-site-packages venv
source ./venv/bin/activate
pip install ipaddress lupa trueskill marshmallow-jsonapi pyqt5

install the faf-uid smurf protection executable:

sudo wget -O /usr/bin/faf-uid
sudo chmod +x /usr/bin/faf-uid

clone and run the client:

git clone
python ./client/src


There is an experimental overlay available at, along with installation instructions. You will need layman to set it up. Note that wine is not a dependency of these packages, you will have to install it on your own.

Run from source

See basic instructions at

Install Supreme Commander : Forged Alliance

Install using steam

You can trick the native Linux steam client to download your steam copy of Forged Alliance for you. Close steam and create the file


with the following contents

	"appid"			"9420"
	"Universe"		"1"
	"installdir"	"ForgedAlliance"
	"StateFlags"	"1026"

Now open the steam client and it should start downloading FA immediately.

You need to install directx runtime in wine with

winetricks d3dx9


winetricks xact

Install using the retail ISO

Just launch the setup from the CD (ISO).

After installation



and enable "emulate virtual screen" option in graphics tab and enter you display resolution.

After installation run the game without the client, setup graphics and make sure everything works like sound etc. The bloom renderer graphics setting may not work. If the game does not start again, delete the #Game.prefs

Client setup

First thing is to point your client to your game directory using Options -> Settings -> Game Path... If you install FA using the Retail ISO, your game path probably is

~/.wine/drive_c/Program Files/THQ/Gas Powered Games/Supreme Commander - Forged Alliance

When using the steam download, your game path probably is


I created some client settings so you can adjust how the client starts the game using wine. The are only accessible through the #FA Lobby.ini file while the client is not running (because it overwrites the file on close).

exe=/usr/bin/wine                                         <- points to your wine binary, defaults to 'wine'
prefix=/home/linuxmasterrace/.PlayOnLinux/wineprefix/faf  <- points to your WINEPREFIX path, defaults to '~/.wine'
cmd_prefix=primusrun                                      <- prefix the program start for something like switchable graphics

File locations

FA Lobby.ini

The settings file of the client is located at

~/.config/ForgedAllianceForever/FA Lobby.ini

It contains all settings of the client.



Look here if something goes wrong.


Your maps are located at

~/Documents/My Games/Gas Powered Games/Supreme Commander Forged Alliance/Maps

but this path may be altered by the documents directory set up in wine and localization of your system.


Your game.prefs contains all game settings, like graphics settings, keybindings and active UI mods. It is located at

~/.wine/drive_c/users/USER/Local Settings/Application Data/Gas Powered Games/Supreme Commander Forged Alliance/Game.prefs

but this path depends on your WINEPREFIX and probably on the Windows version you set up in wine.