Difference between revisions of "Steam"

From Funtoo
Jump to navigation Jump to search
(36 intermediate revisions by 2 users not shown)
Line 3: Line 3:
=== History on Funtoo ===
=== History on Funtoo ===


Through Funtoo Linux 1.2, it was possible to play Steam directly under Funtoo. However, with the move to Funtoo Linux 1.3, 32-bit support was dropped from Funtoo, and Steam is currently dependent on a host of 32-bit libraries. Thus, Steam no longer worked under Funtoo directly. Howevever, it is still possible to run Steam under Funtoo via use of containerization technology.
Through Funtoo Linux 1.2, it was possible to play Steam directly under Funtoo. However, with the move to Funtoo Linux 1.3, 32-bit support was dropped from Funtoo, and Steam is currently dependent on a host of 32-bit libraries. Thus, Steam no longer worked under Funtoo directly. Howevever, it is still possible to run Steam under Funtoo via use of containerization technology, but much of the setup was left to users to figure out.  


=== Steam in Docker ===
Now, not only is Steam supported, but we now have officially-tested Docker images to allow you to do this easily. Currently we have just an NVIDIA docker image, but this is actually the more challenging one to build and one for Open Source graphics will be appearing shortly.


This page will currently document the setup of Steam running on NVIDIA hardware, with documentation for non-NVIDIA hardware to follow shortly.
Funtoo's official Steam container for use with NVIDIA graphics is based on Ubuntu 18, since Steam and Ubuntu have an unholy alliance and this is the officially-supported platform for Steam. That's fine -- we can still run Steam on Ubuntu -- on Funtoo!


To run Steam on NVIDIA graphics, with full PulseAudio sound, docker with NVIDIA support will be used. I have built up an official Steam container for use with NVIDIA graphics. It is based on Ubuntu 18, since Steam and Ubuntu have an unholy alliance and this is the official platform for Steam. That's fine -- we can still run Steam on Ubuntu -- in Funtoo!
The base Ubuntu container image upon which our container is an official Ubuntu container from NVIDIA Corporation and has been configured to work perfectly with container GPU acceleration and libglvnd.


The base Ubuntu container image upon which our container is built comes directly from NVIDIA and has been configured to work perfectly with container GPU acceleration.
=== Steam in Docker: Requirements ===
 
{{Note|This page will currently document the setup of Steam running on NVIDIA hardware, with documentation for non-NVIDIA hardware to follow shortly.}}
 
To run Steam on NVIDIA GPUs, you must meet the following prerequisites:
 
* You must be using Funtoo Linux 1.4 or later, x86-64bit.
* You must have an NVIDIA graphics card.
* Already have NVIDIA drivers ({{c|x11-drivers/nvidia-drivers}}) installed and a desktop environment running that uses them.
* A regular, non-root user created from which you will be launching Steam.
* PulseAudio working.
 
If you are using the [https://forums.funtoo.org/topic/3125-gnome-stages-and-lxd-images-now-available/ Funtoo Linux GNOME stage3] as a starting point, you should be in good shape regarding all these requirements.


=== Host Setup ===
=== Host Setup ===


To get your host ready to run Steam, emerge the following packages:
To get your host ready to run Steam, emerge the following package:


{{console|body=
{{console|body=
# ##i##emerge -av --jobs docker nvidia-container-runtime nvidia-docker
# ##i##emerge -av --jobs=3 steam-nvidia-launcher
}}
}}


You will also want to ensure that you have NVIDIA proprietary graphics running in a graphical environment on your host. Please ensure that you have {{c|x11-drivers/nvidia-kernel-modules-435.21-r1}} or later installed on your host, and that you don't have any special permissions settings in {{f|/etc/modprobe.d}}.
You will also want to ensure that you have NVIDIA proprietary graphics running in a graphical environment on your host. Please ensure that you have {{c|x11-drivers/nvidia-kernel-modules-435.21-r1}} or later installed on your host, and that you don't have any special permissions settings in {{f|/etc/modprobe.d}} (See the [[#Device Node Permissions|Device Node Permissions]] section below for details.)


Next, you will want to add {{c|docker}} and {{c|nvidia-container}} to your default runlevel:
Next, you will want to add {{c|docker}} and {{c|nvidia-container}} to your default runlevel, and start them:


{{console|body=
{{console|body=
Line 30: Line 42:
# ##i##rc-update add nvidia-container default
# ##i##rc-update add nvidia-container default
  ##g##*##!g## nvidia-container added to runlevel default.
  ##g##*##!g## nvidia-container added to runlevel default.
# rc
# ##i##rc
}}
 
=== Check Device Node Permissions ===
 
If you are using {{c|x11-drivers/nvidia-kernel-modules-435.21-r1}} or later, and have run {{c|etc-update}}, then your device nodes should have correct permissions for GPU acceleration to work:
 
{{console|body=
$ ##i##ls /dev/nvidia* -l
crw-rw-rw- 1 root root 195, 254 Oct 23 10:09 ##y##/dev/nvidia-modeset
crw-rw-rw- 1 root root 239,  0 Oct 23 10:09 ##y##/dev/nvidia-uvm
crw-rw-rw- 1 root root 239,  1 Oct 23 10:09 ##y##/dev/nvidia-uvm-tools
crw-rw-rw- 1 root root 195,  0 Oct 23 10:08 ##y##/dev/nvidia0
crw-rw-rw- 1 root root 195, 255 Oct 23 10:08 ##y##/dev/nvidiactl
}}
 
Otherwise, you will need to follow these steps. To allow all local users to access your GPU, not just the {{c|video}} user, by setting {{c|1=NVreg_DeviceFileMode=0666}} in {{f|/etc/modprobe.d/nvidia.conf}} and rebooting.
 
=== Host Validation ===
 
With the host and device node permissions set up properly, you should be able to run {{c|nvidia-container-cli info}} as your regular user and see details about your GPU and not receive any error messages:
 
{{console|body=
$ ##i##nvidia-container-cli info
NVRM version:  435.21
CUDA version:  10.1
 
Device Index:  0
Device Minor:  0
Model:          Quadro P400
Brand:          Quadro
GPU UUID:      GPU-9bb98f5f-7d9d-ee0a-64a1-154c46934f45
Bus Location:  00000000:01:00.0
Architecture:  6.1
}}
}}
If you receive an error message, this indicates that your {{c|/dev/nvidia*}} device node permissions are too restrictive or that {{c|/etc/init.d/nvidia-container}} has not been started properly. Try rebooting or restarting Docker to resolve the issue.


=== User Setup ===
=== User Setup ===
Line 47: Line 94:
=== PulseAudio Setup ===
=== PulseAudio Setup ===


In order to allow the container to connect to PulseAudio, you will of course need to be using PulseAudio, and then you will also need to enable support for UNIX socket connectivity in PulseAudio. This can be done by adding the following to {{f|/etc/pulse/default.pa}}:
In order to allow the container to connect to PulseAudio, you will of course need to be using PulseAudio, and then you will also need to enable support for UNIX socket connectivity in PulseAudio. This can be done by modifying the {{c|module-native-protocol-unix}} line in {{f|/etc/pulse/default.pa}} to have the {{c|1=auth-anonymous=1}} suffix:


{{file|name=/etc/pulse/default.pa|body=
{{file|name=/etc/pulse/default.pa|body=
Line 53: Line 100:
}}
}}


Once this is done, you should restart your user's pulseaudio daemon for this to take immediate effect:
You should restart your user's pulseaudio daemon for this to take immediate effect:


{{console|body=
{{console|body=
$ killall pulseaudio
$ ##i##killall pulseaudio
}}
}}


Line 62: Line 109:


{{console|body=
{{console|body=
$ ##i##ls /run/user/$UID/pulse/
$ ##i##ls $XDG_RUNTIME_DIR/pulse/
native  pid
native  pid
}}
}}
Line 68: Line 115:
=== Docker Container Setup ===
=== Docker Container Setup ===


As your regular user, create the following script:
To start the Steam container, run {{c|steam-nvidia-launcher}} as a regular user:
 
{{console|body=
$ ##i##steam-nvidia-launcher
}}
 
The {{c|steam-nvidia-launcher}} takes care of the full Steam container lifecycle. You simply run it as your local user, and it will download the official Funtoo Steam docker image and launch it. The launcher will stay running until you hit Control-C, at which point it will stop Steam and also stop the container.
 
The next time you want to start Steam, you'll run the launcher, and it will find the existing container, start it, and start Steam. Just like before, when you want to stop Steam and the container, hit Control-C and Steam and the container will be stopped.
 
Since it is the initial run of the launcher, it will download the Docker image first, which is about 1.5GB in size, and then it will launch a new container image. You should see Steam start to update itself, and then when this is done it will prompt you to log in to Steam. Congratulations! Steam is now running!


{{file|name=create-steam.sh|lang=bash|body=
=== Container Validation ===
#!/bin/bash
xhost +local:
exec nvidia-docker run \
-ti \
--name steam-nvidia-${USER} \
-e DISPLAY=$DISPLAY \
-v /tmp/.X11-unix:/tmp/.X11-unix \
-v /dev/shm:/dev/shm \
--privileged \
-v /run/user/${UID}/pulse:/run/user/1000/pulse \
-e PULSE_SERVER=unix:/run/user/1000/pulse/native \
funtoolinux/steam-nvidia-ubuntu18:1.0 \
/bin/bash
}}


Now, make the script executable and run it:
It is possible to open a bash shell within an already launched container by running the following command in another X terminal:


{{console|body=
{{console|body=
$ ##i##chmod +x create-steam.sh
$ ##i##steam-nvidia-launcher attach
$ ##i##./create-steam.sh
%steam-container%
}}
}}


The container should begin to initialize and you should then be placed inside the container, at which point you can perform some quick
From this point, you can inspect the state of the running container interactively and test out various parts of its operation.
tests to ensure that the container is functioning properly.
When you are done, you can exit the container by pressing Control-D or typing {{c|exit}}.  


=== Container Validation ===
==== Test PulseAudio ====


To ensure that PulseAudio is functioning properly from within the container, the following command can be run to play back white noise via PulseAudio:
To ensure that PulseAudio is functioning properly from within the container, the following command can be run to play back white noise via PulseAudio:
Line 103: Line 146:
%steam-container% ##i##pacat -vvvv /dev/urandom
%steam-container% ##i##pacat -vvvv /dev/urandom
}}
}}
==== Test OpenGL ====


To ensure that OpenGL is working properly from within the container, and that the container is properly connecting to your X server, you can run {{c|glxgears}}:
To ensure that OpenGL is working properly from within the container, and that the container is properly connecting to your X server, you can run {{c|glxgears}}:
Line 112: Line 157:
You should see glxgears running in a window on your desktop.
You should see glxgears running in a window on your desktop.


At this point, you can exit the container by pressing Control-D or typing {{c|exit}}. Make a mental note that the container name is {{c|steam-nvidia-yourusername}}.
=== Future Work ===
 
=== Container Operations ===
 
Your container is now running and ready to start Steam. But if you restart your computer in the future (and I know you will), the container will not be running. To start the container, we will create the following script:
 
{{file|name=start-steam.sh|lang=bash|body=
#!/bin/bash
xhost +local:
running="$(docker inspect -f '{{.State.Running}}' steam-nvidia-$USER)"
if [ "$running" == "false" ]; then
    nvidia-docker start steam-nvidia-$USER
    sleep 8
fi
nvidia-docker exec -it steam-nvidia-$USER su steam /usr/games/steam
}}


This script will check to see if the container is running. If not, it will start the container, and then attach the current shell to the container and run {{c|/usr/games/steam}} as the {{c|steam}} user in the container. Use it the typical way:
The work on Steam on Funtoo is ongoing with the following efforts planned:


{{console|body=
* Support for Steam on Open Source drivers, not just NVIDIA.
$ ##i##chmod +x start-steam.sh
* Storage of Steam Library and configuration outside of the container, so that wiping the container image will not wipe your downloaded games. (DONE: Supported in version 1.4)
$ ##i##./start-steam.sh
* Support for integration of Desktop shortcuts with your native DE.
}}


You should see a Steam window open almost immediately and start downloading updates, after which point Steam will restart and prompt you to log in.
[[Category:Official Documentation]]
[[Category:Containers]]
[[Category:Docker]]
[[Category:Games]]

Revision as of 04:58, December 11, 2019

Steam is a content delivery system and ecosystem for gaming, developed by Valve Software. It offers hundreds of games, from popular ones such as DOTA 2 to many other less popular and even obscure community games. Steam runs on Microsoft Windows, MacOS, and also Linux.

History on Funtoo

Through Funtoo Linux 1.2, it was possible to play Steam directly under Funtoo. However, with the move to Funtoo Linux 1.3, 32-bit support was dropped from Funtoo, and Steam is currently dependent on a host of 32-bit libraries. Thus, Steam no longer worked under Funtoo directly. Howevever, it is still possible to run Steam under Funtoo via use of containerization technology, but much of the setup was left to users to figure out.

Now, not only is Steam supported, but we now have officially-tested Docker images to allow you to do this easily. Currently we have just an NVIDIA docker image, but this is actually the more challenging one to build and one for Open Source graphics will be appearing shortly.

Funtoo's official Steam container for use with NVIDIA graphics is based on Ubuntu 18, since Steam and Ubuntu have an unholy alliance and this is the officially-supported platform for Steam. That's fine -- we can still run Steam on Ubuntu -- on Funtoo!

The base Ubuntu container image upon which our container is an official Ubuntu container from NVIDIA Corporation and has been configured to work perfectly with container GPU acceleration and libglvnd.

Steam in Docker: Requirements

   Note

This page will currently document the setup of Steam running on NVIDIA hardware, with documentation for non-NVIDIA hardware to follow shortly.

To run Steam on NVIDIA GPUs, you must meet the following prerequisites:

  • You must be using Funtoo Linux 1.4 or later, x86-64bit.
  • You must have an NVIDIA graphics card.
  • Already have NVIDIA drivers (x11-drivers/nvidia-drivers) installed and a desktop environment running that uses them.
  • A regular, non-root user created from which you will be launching Steam.
  • PulseAudio working.

If you are using the Funtoo Linux GNOME stage3 as a starting point, you should be in good shape regarding all these requirements.

Host Setup

To get your host ready to run Steam, emerge the following package:

root # emerge -av --jobs=3 steam-nvidia-launcher

You will also want to ensure that you have NVIDIA proprietary graphics running in a graphical environment on your host. Please ensure that you have x11-drivers/nvidia-kernel-modules-435.21-r1 or later installed on your host, and that you don't have any special permissions settings in /etc/modprobe.d (See the Device Node Permissions section below for details.)

Next, you will want to add docker and nvidia-container to your default runlevel, and start them:

root # rc-update add docker default
 * service docker added to runlevel default
root # rc-update add nvidia-container default
 * nvidia-container added to runlevel default.
root # rc

Check Device Node Permissions

If you are using x11-drivers/nvidia-kernel-modules-435.21-r1 or later, and have run etc-update, then your device nodes should have correct permissions for GPU acceleration to work:

user $ ls /dev/nvidia* -l
crw-rw-rw- 1 root root 195, 254 Oct 23 10:09 /dev/nvidia-modeset
crw-rw-rw- 1 root root 239,   0 Oct 23 10:09 /dev/nvidia-uvm
crw-rw-rw- 1 root root 239,   1 Oct 23 10:09 /dev/nvidia-uvm-tools
crw-rw-rw- 1 root root 195,   0 Oct 23 10:08 /dev/nvidia0
crw-rw-rw- 1 root root 195, 255 Oct 23 10:08 /dev/nvidiactl

Otherwise, you will need to follow these steps. To allow all local users to access your GPU, not just the video user, by setting NVreg_DeviceFileMode=0666 in /etc/modprobe.d/nvidia.conf and rebooting.

Host Validation

With the host and device node permissions set up properly, you should be able to run nvidia-container-cli info as your regular user and see details about your GPU and not receive any error messages:

user $ nvidia-container-cli info
NVRM version:   435.21
CUDA version:   10.1

Device Index:   0
Device Minor:   0
Model:          Quadro P400
Brand:          Quadro
GPU UUID:       GPU-9bb98f5f-7d9d-ee0a-64a1-154c46934f45
Bus Location:   00000000:01:00.0
Architecture:   6.1

If you receive an error message, this indicates that your /dev/nvidia* device node permissions are too restrictive or that /etc/init.d/nvidia-container has not been started properly. Try rebooting or restarting Docker to resolve the issue.

User Setup

When using docker, you will be starting the Steam container as a regular user account so the container can inherit the connection to your X server. You will want to make sure your user account is in the docker group:

root # gpasswd -a drobbins docker
Adding user drobbins to group docker

You will need to log out and log back in for this group change to take effect.

PulseAudio Setup

In order to allow the container to connect to PulseAudio, you will of course need to be using PulseAudio, and then you will also need to enable support for UNIX socket connectivity in PulseAudio. This can be done by modifying the module-native-protocol-unix line in /etc/pulse/default.pa to have the auth-anonymous=1 suffix:

   /etc/pulse/default.pa
load-module module-native-protocol-unix auth-anonymous=1

You should restart your user's pulseaudio daemon for this to take immediate effect:

user $ killall pulseaudio

Once this has been done, you should be able to see a native UNIX socket in the PulseAudio run directory. This socket will get mapped into the container:

user $ ls $XDG_RUNTIME_DIR/pulse/
native  pid

Docker Container Setup

To start the Steam container, run steam-nvidia-launcher as a regular user:

user $ steam-nvidia-launcher

The steam-nvidia-launcher takes care of the full Steam container lifecycle. You simply run it as your local user, and it will download the official Funtoo Steam docker image and launch it. The launcher will stay running until you hit Control-C, at which point it will stop Steam and also stop the container.

The next time you want to start Steam, you'll run the launcher, and it will find the existing container, start it, and start Steam. Just like before, when you want to stop Steam and the container, hit Control-C and Steam and the container will be stopped.

Since it is the initial run of the launcher, it will download the Docker image first, which is about 1.5GB in size, and then it will launch a new container image. You should see Steam start to update itself, and then when this is done it will prompt you to log in to Steam. Congratulations! Steam is now running!

Container Validation

It is possible to open a bash shell within an already launched container by running the following command in another X terminal:

user $ steam-nvidia-launcher attach
steam-container #

From this point, you can inspect the state of the running container interactively and test out various parts of its operation. When you are done, you can exit the container by pressing Control-D or typing exit.

Test PulseAudio

To ensure that PulseAudio is functioning properly from within the container, the following command can be run to play back white noise via PulseAudio:

steam-container # pacat -vvvv /dev/urandom

Test OpenGL

To ensure that OpenGL is working properly from within the container, and that the container is properly connecting to your X server, you can run glxgears:

steam-container # glxgears

You should see glxgears running in a window on your desktop.

Future Work

The work on Steam on Funtoo is ongoing with the following efforts planned:

  • Support for Steam on Open Source drivers, not just NVIDIA.
  • Storage of Steam Library and configuration outside of the container, so that wiping the container image will not wipe your downloaded games. (DONE: Supported in version 1.4)
  • Support for integration of Desktop shortcuts with your native DE.