From eaff1edaf25664f2c24b50ad0db04d60e805931f Mon Sep 17 00:00:00 2001 From: Asahi Lina Date: Oct 16 2024 14:49:11 +0000 Subject: x86-support.adoc: Add info on setting up external Steam libraries --- diff --git a/modules/ROOT/pages/x86-support.adoc b/modules/ROOT/pages/x86-support.adoc index 49e60ae..d5d3c1a 100644 --- a/modules/ROOT/pages/x86-support.adoc +++ b/modules/ROOT/pages/x86-support.adoc @@ -56,6 +56,8 @@ For Windows DX8-DX11 games under Proton in particular, you might want to try Win These are known issues caused by bugs/limitations in Sommelier. We recommend using our x86/x86_64 stack only to run fullscreen applications (games, Steam in Big Picture mode) at this time. We're working on a solution to this issue by replacing Sommelier with a more lightweight alternative. +If you need to access the regular Steam client, you can exit from Big Picture using Alt-F4. The menus may not work properly at this time. If you need to access Steam Settings, you can do so by clicking the Library tab, then clicking on the gear icon. + === The VM uses a lot of RAM To allow guest apps to use a large amount of RAM (as some modern games require), by default `muvm` allows the guest to use up to 80% of the system RAM. This also means that some of that will be taken up by guest page cache. Especially on lower RAM size machines (16GB or lower), we recommend not running any heavy host applications while the VM is in use. We don't recommend gaming on 8GB machines. @@ -142,3 +144,41 @@ It is also possible to share audio between host and guest apps by using the Puls === Why do I have fewer CPU cores inside the VM? By default, `muvm` passes through as many CPUs as there are performance cores on your host machine, and pins those vCPUs to the physical performance cores. Since the host CPU scheduler has no visibility into the guest CPU scheduler, this ensures that performance is consistent. You can modify this behavior with the `muvm --cpu-list=CPU_LIST` option. + +=== How do I use an external drive as a Steam library folder? + +Follow these steps to get an external drive set up for Steam: + +. Format your external drive using a Linux-native filesystem such as ext4. ++ +NOTE: FAT32, exFAT, and other filesystems without support for Linux permissions will not work. + +. Mount your drive manually under a directory accessible to muvm, such as `/mnt/steam`. ++ +NOTE: We recommend mounting the drive manually (e.g. `sudo mount /dev/sdX1 /mnt/steam`, where `sdX1` is your drive's device file). If you configure the drive to mount automatically using `/etc/fstab`, then your system will not boot if that drive is not connected. ++ +NOTE: The default mountpoint for drives mounted via the desktop environment (udisks) will not work at this time. + +. Ensure that the filesystem root is accessible to your regular user: ++ +`sudo chown ${USER}: /mnt/steam` + +. Create an empty folder named `steamapps` at the root of the mount: ++ +`mkdir /mnt/steam/steamapps` + +. Start up Steam normally ++ +NOTE: Steam will start up in Big Picture mode + +. Exit Big Picture mode by pressing Alt+F4 + +. Click on the Library tab, then click the gear (settings) icon ++ +TIP: The settings window may pop up with the wrong size. Click and drag the resize handle on the bottom right to snap to the proper size. + +. Select *Storage* on the left menu, click on the combo box at the top of the panel, and select *Add Drive*. + +. Browse to your drive mountmount (`/mnt/steam`), such that the only folder visible in the file picker list window is the empty `steamapps` folder within, then (without making any further selections) click on the *Select* button. + +You should now be able to select the new download location, make it the default, and download games to it.