Installing the game on Linux

From Vintage Story Wiki
Other languages:

Vintage Story uses the .NET Framework. On a Windows machine, .NET is integrated with the OS or at least easily installed. Although the .NET Framework was originally designed to target Windows platforms only, it can also be run on other Operating Systems, specifically Linux, with some additional steps.


Installing mono

In order to play Vintage Story on Linux, you will need to use a utility called mono. This will allow you to run other .NET Framework applications too, and also create your own mods.

  • When installing mono on Ubuntu/Debian/Raspbian/CentOS/Fedora, please refer to the instructions here.
  • When installing mono on Arch Linux or any Arch-based distro (Manjaro, Antergos, etc), refer to the instructions here.

Installing openal

OpenAL is a cross-platform audio library, needed for the game sounds in Vintage Story. You may have it installed already, as standard or for another game or application. If you don't have it already, install it using this command: apt-get install libopenal-dev Any issues with this, search up how to install OpenAL.

Launching the game

After installing mono (and perhaps also openal), you're ready to start the game.

  • Open a new terminal.
  • Navigate to the game folder.
  • Type mono Vintagestory.exe and hit enter. (Some people have reported that this needs to be run from the game's install folder, the first time)

The game files also contain a script, install.sh that is intended to install the game in ~/ApplicationData/vintagestory/ and create a shortcut on your desktop. Apparently this install script doesn't work for everyone, so you may need to take these steps manually, or edit the script slightly e.g. to create the target install folder. Please refer to the forum thread linked below.

Troubleshooting

If you have any issues, the Forum thread on working linux setups might help you.

Some players have reported needing to run sudo mono Vintagestory.exe to launch the game the first time: this may depend on how it was installed.

If you cannot log in, try running sudo cert-sync /etc/ssl/certs/ca-certificates.crt or sudo cert-sync /etc/pki/tls/certs/ca-bundle.crt.