Jump to content

The recommended way to install on Linux is unnecessarily complicated.


Recommended Posts


Hello, I would like to start off by saying that I have never used the install.sh script included with the Linux Tarball of VintageStory. Also, the developers state, here on this website, that Linux requires a lot of manual tweaks. That's sort of true I guess. Here's the process I go through to install the game.


Step 1a) For Debian-based distributions: install Mono. You can follow the instructions to install Mono by clicking here. I know the Ubuntu and Arch Linux process, so if needed, I can walk people through the steps on those distributions of Linux. On Ubuntu, it is (unfortunately) more involved, and requires a decent understanding of APT repositories. However, you get the benefit of having access to the mono build coming directly from the mono-project itself.

Step 1b) On Arch (and it's derivatives), mono can be found in the repositories, so pacman is the only tool you'll need. 

sudo pacman -S mono




Step 2a) On Debian-based distributions, download the Linux (Full) tarball from your Vintage Story account to


Next open a terminal and change directory into the directory you installed it to:

cd ~/.local/bin/

Finally, extract the tarball in place:

tar -xvf vs_archive_<version>.tar.gz

and move into the newly extracted vintagestory directory:

cd ./vintagestory

Step 2b) On Arch-based distributions, just install Vintage Story with the AUR. If you aren't using an AUR manager such as `yay` or `trizen`, here is the manual method. First you'll want to get the AUR package using git:

git clone https://aur.archlinux.org/vintagestory.git

then you can change directory into the newly downloaded vintagestory directory with the cd command. Finally, you can just install it with:

makepkg -si

If for any reason the AUR method doesn't work, you can just fall back to using the Debian-based instructions in step 2a and continue to steps 3; otherwise, go to step 5.


Step 3) Edit the Vintagestory.desktop file. You only need to edit 4 lines. First you may want to get rid of the ${Version} variables, but you don't have to do this. Then you'll want to edit the last two lines by updating the path to explicit values (where <usrname> needs to be replaced with your Linux user's username (i.e. in my case, I replace <usrname> with deblad):

# The commented out values are the old values that come with the game.

#Name=Vintage Story ${VERSION}
#Name[de]=Vintage Story ${VERSION}
Name=Vintage Story
Name[de]=Vintage Story

Notice that the only changes we made were super simple ones. All you do is replace the ${APPDATA}/${INST_DIR} with the path that we extracted the tarball to in step 2.


Step 4) Copy (or move) the newly edited Vintagestory.desktop file to your


directory. Notice that it is one directory above your current working directory so you can just use the command,

cp Vintagestory.desktop ../applications



Step 5) Enjoy the game. You can find the application in the applications menu of your desktop. If you got all paths correct, you'll see the icon and the game will just work - provided that you installed mono.


That's it. 5 Simple Steps. Honestly, they could be simpler if the game devs would adopt this method to install the game on Linux. I honestly hope they do :D

Updated on 4 November 2021.

Edited by LinuxDragon57
Fix formatting between steps 3,4, & 5
  • Like 1
  • Thanks 1
Link to comment
Share on other sites

  • Create New...

Important Information

We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue.