Steam/Troubleshooting - ArchWiki

# Steam/Troubleshooting

From ArchWiki
< Steam

Related articles

- Steam/Game-specific troubleshooting

Tip: The Steam launcher redirects its stdout and stderr to `/tmp/dumps/USER_stdout.txt`. This means you do not have to run Steam from a terminal emulator to see that output.
Note: Bugs should be reported at Valve's GitHub issue tracker.

## Debugging Steam

It is possible to debug Steam to gain more information which could be useful to find out why something does not work.

You can set `DEBUGGER` environment variable with one of `gdb`, `cgdb`, `valgrind`, `callgrind`, `strace` and then start `steam`.

For example with gdb

    $ DEBUGGER=gdb steam

`gdb` will open, then type `run` which will start `steam` and once crash happens you can type `backtrace` to see call stack.

## Steam runtime issues

Steam installs its own older versions of some libraries collectively called the "Steam Runtime". These will often conflict with the libraries included in Arch Linux, and out-of-date libraries may be missing important features (Notably, the OpenAL version they ship lacks HRTF and surround71 support).

Some of the possible symptoms of this issue are the Steam client itself crashing or hanging, and/or various errors:

    libGL error: unable to load driver: some_driver_dri.so
    libGL error: driver pointer missing
    libGL error: failed to load driver: some_driver
    libGL error: unable to load driver: swrast_dri.so
    libGL error: failed to load driver: swrast

    Failed to load libGL: undefined symbol: xcb_send_fd

    OpenGL GLX context is not using direct rendering, which may cause performance problems.

    Could not find required OpenGL entry point 'glGetError'! Either your video card is unsupported or your OpenGL driver needs to be updated.

Note: A misconfigured firewall may cause Steam to fail as it can not connect to its servers. [1] Most games will crash if the Steam API fails to load.

See also upstream issue #4768, and these forum threads:

- https://bbs.archlinux.org/viewtopic.php?id=181171
- https://bbs.archlinux.org/viewtopic.php?id=183141

### Solutions

There are three ways to run Steam provided by the steam package:

    $ steam-runtime

This is the command which is run when you run Steam via `/usr/bin/steam` or the "Steam" desktop entry. Runtime libraries which are known to cause problems are overriden via the `LD_PRELOAD` environment variable (see ld.so(8)). If your system still has library conflicts with this command, you can make a copy of `/usr/bin/steam-runtime` and edit it to add additional workarounds.

    $ steam-native

This is the command run by the "Steam (Native)" desktop entry. This version forces Steam to ignore its runtime and only use system libraries. You will probably need to install steam-native-runtime in order for Steam to run at all, though some games may require additional packages. See #Finding missing runtime libraries and Steam/Game-specific troubleshooting.

    $ /usr/lib/steam/steam

This is the normal Steam launcher without any Arch-specific workarounds.

### Finding missing runtime libraries

If individual games or Steam itself is failing to launch when using `steam-native` you are probably missing libraries. To find the required libraries run:

    $ cd ~/.local/share/Steam/ubuntu12_32
    $ file * | grep ELF | cut -d: -f1 | LD_LIBRARY_PATH=. xargs ldd | grep 'not found' | sort | uniq

Alternatively, run Steam with its runtime (`/usr/bin/steam`) and use the following command to see which non-system libraries Steam is using (not all of these are part of the Steam runtime):

    $ for i in $(pgrep steam); do sed '/\.local/!d;s/.*  //g' /proc/$i/maps; done | sort | uniq

If the above commands have no output and you have an NVIDIA video card, then you may need to explitly install lib32-nvidia-utils.

## Other runtime issues

### Native runtime: steam.sh line 756 Segmentation fault

  Valve GitHub issue 3863

As per the bug report above, Steam crashes with `/home/<username>/.local/share/Steam/steam.sh: line 756: <variable numeric code> Segmentation fault (core dumped)` when running with STEAM_RUNTIME=0.

This happens because steamclient.so is linked to libudev.so.0 (lib32-libudev0AUR) which conflicts with libudev.so.1 (lib32-systemd)

The only proposed workaround is copying Steam's packaged 32-bit versions of libusb and libgudev to /usr/lib32:

    # cp $HOME/.local/share/Steam/ubuntu12_32/steam-runtime/i386/usr/lib/i386-linux-gnu/libgudev* /usr/lib32
    # cp $HOME/.local/share/Steam/ubuntu12_32/steam-runtime/i386/lib/i386-linux-gnu/libusb* /usr/lib32

Notice that the workaround is necessary because the bug affects systems with lib32-libgudev and lib32-libusb installed.

Alternatively it has been successful to prioritize the loading of the libudev.so.1 (see comment on the same issue):

    $ LD_PRELOAD=/usr/lib32/libudev.so.1 STEAM_RUNTIME=0 steam

### OpenGL not using direct rendering / Steam crashes Xorg

Sometimes presented with the error message "OpenGL GLX context is not using direct rendering, which may cause performance problems." [2]

If you still encounter this problem after addressing #Steam runtime issues, you have probably not installed your 32-bit graphics driver correctly. See Xorg#Driver installation for which packages to install.

You can check/test if it is installed correctly by installing lib32-mesa-demos and running the following command:

    $ glxinfo32 | grep OpenGL.

### 'GLBCXX_3.X.XX' not found when using Bumblebee

This error is likely caused because Steam packages its own out of date `libstdc++.so.6`. See #Steam runtime issues about working around the bad library. See also GitHub issue 3773.

### Games crash immediately

This is likely due to #Steam runtime issues. If those solutions do not work, try setting the following launch options:

    LD_PRELOAD='./libcxxrt.so:/usr/$LIB/libstdc++.so.6' %command%

If it does not help try disabling: Enable the Steam Overlay while in-game in the game properties.

And finally, if those don't work, you should check Steam's output for any error from the game. You may encounter the following:

- munmap_chunk(): invalid pointer
- free(): invalid pointer

In these cases, try replacing the libsteam_api.so file from the problematic game with one of a game that works. This error usually happens for games that were not updated recently when Steam runtime is disabled. This error has been encountered with AYIM, Bastion and Monaco.

### Version `CURL_OPENSSL_3` not found

This is because curl alone is not compatible with previous versions. You need to install the compatibility libraries:

One of the following messages may show up:

    # Nuclear Throne
    ./nuclearthrone: /usr/lib32/libcurl.so.4: version `CURL_OPENSSL_3' not found (required by ./nuclearthrone)

    # Devil Daggers
    ./devildaggers: /usr/lib/libcurl.so.4: version `CURL_OPENSSL_3' not found (required by ./devildaggers)

You need to install either libcurl-compat or lib32-libcurl-compat and link the compatibility library manually:

    # Nuclear Throne
    $ ln -s /usr/lib32/libcurl-compat.so.4.4.0 $HOME/.steam/steam/steamapps/common/Nuclear Throne/lib/libcurl.so.4

    # Devil Daggers
    $ ln -s /usr/lib/libcurl-compat.so.4.4.0 $HOME/.steam/steam/steamapps/common/devildaggers/lib64/libcurl.so.4

## Audio issues

Check Steam/Game-specific troubleshooting for issues with specific games. If the sections below do not address the issue, try running Steam with the native runtime (see #Solutions).

### Configure PulseAudio

Games that explicitly depend on ALSA can break PulseAudio. Follow the directions for PulseAudio#ALSA to make these games use PulseAudio instead.

### No audio or 756 Segmentation fault

First #Configure PulseAudio and see if that resolves the issue. If you do not have audio in the videos which play within the Steam client, it is possible that the ALSA libs packaged with Steam are not working.

Attempting to playback a video within the steam client results in an error similar to:

    ALSA lib pcm_dmix.c:1018:(snd_pcm_dmix_open) unable to open slave

A workaround is to rename or delete the `alsa-lib` folder and the `libasound.so.*` files. They can be found at:

    ~/.steam/steam/ubuntu12_32/steam-runtime/i386/usr/lib/i386-linux-gnu/

An alternative workaround is to add the `libasound.so.*` library to the LD_PRELOAD environment variable:

    LD_PRELOAD='/usr/$LIB/libasound.so.2 '${LD_PRELOAD} steam

If audio still won't work, adding the Pulseaudio-libs to the LD_PRELOAD variable may help:

    LD_PRELOAD='/usr/$LIB/libpulse.so.0 /usr/$LIB/libpulse-simple.so.0 '${LD_PRELOAD}

Be adviced that their names may change over time. If so, it is necessary to take a look in

    ~/.steam/ubuntu12_32/steam-runtime/i386/usr/lib/i386-linux-gnu

and find the new libs and their versions.

Bugs reports have been filed: #3376 and #3504

### FMOD sound engine

While troubleshooting a sound issue, it became evident that the following games (as examples) use the 'FMOD' audio middleware package:

- Hotline Miami
- Hotline Miami 2
- Transistor

This package is a bit buggy, and as a result while sound can appear to be working fine for the rest of your system, some games may still have problems.

It usually occurs when an unused sound device is used as default for ALSA. See Advanced Linux Sound Architecture#Set the default sound card.

### Audio streams can't be moved between devices

If you use pulseaudio and attempt to move an audio stream between different sinks, there's a possibility that you won't be able to move the stream.

This is because recent versions of OpenAL default to disallow pulse streams from being moved. To remedy this fact, create a ~/.alsoftrc with the contents

    [pulse]
    allow-moves=true

## In-home streaming issues

### In Home Streaming does not work from archlinux host to archlinux guest

Chances are you are missing lib32-libcanberra. Once you install that, it should work as expected.

With that, steam should no longer crash when trying to launch a game through in home streaming.

### Hardware decoding not available

In-home streaming hardware decoding uses `vaapi`, so it needs to be installed (or wrapped around `vdpau`). See hardware video acceleration. Remember to install the `lib32` versions as well.

### BPM minimizes itself after losing focus

This can occur when you play a game via in-home streaming or if you have a multi-monitor setup and move the mouse outside of BPM's window. To prevent this, set the following environment variable and restart Steam

    export SDL_VIDEO_MINIMIZE_ON_FOCUS_LOSS=0

See also the github issue.

## Wrong ELF class

If you see this message in Steam's console output

    ERROR: ld.so: object '~/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored.

you can safely ignore it. It is not really any error: Steam includes both 64- and 32-bit versions of some libraries and only one version will load successfully. This "error" is displayed even when Steam (and the in-game overlay) is working perfectly.

## Multiple monitors setup

This article or section needs expansion.

Reason: Is this nvidia-only? Can this be reproduced by anyone? Is there an upstream report? (Discuss in Talk:Steam/Troubleshooting#)

A setup with multiple monitors may prevent games from starting. Try to disable all additional displays, and then run a game. You can enable them after the game successfully started.

Also you can try running Steam with this environment variable set:

    export LD_LIBRARY_PATH=/usr/lib32/nvidia:/usr/lib/nvidia:$LD_LIBRARY_PATH

## Text is corrupt or missing

The Steam Support instructions for Windows seem to work on Linux also.

You can install them via the steam-fontsAUR package, or manually by downloading and installing SteamFonts.zip.

Note: When steam cannot find the Arial fonts, font-config likes to fall back onto the Helveticia bitmap font. Steam does not render this and possibly other bitmap fonts correctly, so either removing problem fonts or disabling bitmap fonts will most likely fix the issue without installing the Arial or ArialBold fonts. The font being used in place of Arial can be found with the command

    $ fc-match -v Arial

Specific games may have other font requirement. See Steam/Game-specific troubleshooting.

## SetLocale('en_US.UTF-8') fails at game startup

You need to generate the `en_US.UTF-8 UTF-8` locale. See Locale#Generating locales.

## Missing libc

This could be due to a corrupt Steam executable. Check the output of:

    $ ldd ~/.local/share/Steam/ubuntu12_32/steam

Should `ldd` claim that it is not a dynamic executable, then Steam likely corrupted the binary during an update. The following should fix the issue:

    $ cd ~/.local/share/Steam/
    $ ./steam.sh --reset

If it doesn't, try to delete the `~/.local/share/Steam/` directory and launch steam again, telling it to reinstall itself.

This error message can also occur due to a bug in steam which occurs when your `$HOME` directory ends in a slash (Valve GitHub issue 3730). This can be fixed by editing `/etc/passwd` and changing `/home/<username>/` to `home/<username>`, then logging out and in again. Afterwards, steam should repair itself automatically.

## Missing libGL

You may encounter this error when you launch Steam at first time.

    You are missing the following 32-bit libraries, and Steam may not run: libGL.so.1

Make sure you have installed the `lib32` version of all your video drivers as described in Xorg#Driver installation.

## Missing vgui2_s.so

Error on startup:

    Could not load module 'vgui2_s.so'.
    For more information visit https://support.steampowered.com/kb_article.php?ref=9205-OZVN-0660

Solution: install package `lib32-openal`

## Games do not launch on older Intel hardware

On older Intel hardware which doesn't support OpenGL 3, such as Intel GMA chips or Westmere CPUs, games may immediately crash when run. It appears as a gameoverlayrenderer.so error in /tmp/dumps/mobile_stdout.txt, but looking in /tmp/gameoverlayrenderer.log it shows a GLXBadFBConfig error.

This can be fixed, however, by forcing the game to use a later version of OpenGL than it wants. Right click on the game, select Properties. Then, click "Set Launch Options" in the "General" tab and paste the following:

    MESA_GL_VERSION_OVERRIDE=3.1 MESA_GLSL_VERSION_OVERRIDE=140 %command%

## Games do not launch on open source drivers, complaining about OpenGL version that the card actually supports

Some games are badly programmed, to use any OpenGL version above 3.0 with mesa, an application has to request a specific core profile.

If it doesn't make such a request, only OpenGL 3.0 and lower are available.

This can be fixed, by forcing the game to use a version of OpenGL it actually needs. Right click on the game, select Properties. Then, click "Set Launch Options" in the "General" tab and paste the following(edit as needed):

    MESA_GL_VERSION_OVERRIDE=4.1 MESA_GLSL_VERSION_OVERRIDE=410 %command%

## 2K games do not run on XFS partitions

This article or section needs expansion.

Reason: Seems to be a general issue, e.g. [3] (Discuss in Talk:Steam/Troubleshooting#)

If you are running 2K games such as Civilization 5 on XFS partitions, then the game may not start or run properly due to how the game loads files as it starts. [4]

## Unable to add library folder because of missing execute permissions

If you add another steam library folder on another drive, you might receive the error message "New Steam library folder must be on a filesystem mounted with execute permissions".

Make sure you are mounting the filesystem with the correct flags in your `/etc/fstab`, usually by adding `exec` to the list of mount parameter. The parameter must occur after any `user` or `users` parameter since these can imply `noexec`.

This error might also occur if you are readding a library folder and Steam is unable to find a contained `steamapps` folder. Previous versions used `SteamApps` instead, so ensure the name is fully lowercase.

This error can also occur because of steam runtime issues and may be fixed following the #Dynamic linker[broken link: invalid section] section.

## Steam controller not being detected correctly

See Gamepad#Steam Controller.

## Steam hangs on "Installing breakpad exception handler..."

BBS#177245

You have an NVIDIA GPU and Steam has the following output:

    Running Steam on arch rolling 64-bit
    STEAM_RUNTIME is enabled automatically
    Installing breakpad exception handler for appid(steam)/version(0_client)

Then nothing else happens. Ensure you have the correct drivers installed as well as their 32-bit versions: see NVIDIA#Installation.

## Prevent memory dumps from consuming RAM

Every time Steam crashes, it writes a memory dump to `/tmp/dumps/`. If Steam falls into a crash loop, the dump files can become quite large. When `/tmp` is mounted as tmpfs, memory and swap file can be consumed needlessly.

To prevent this, link `/tmp/dumps/` to `/dev/null`:

    # ln -s /dev/null /tmp/dumps

Or alternatively, create and modify permissions on `/tmp/dumps`. Then Steam will be unable to write dump files to the directory.

    # mkdir /tmp/dumps
    # chmod 600 /tmp/dumps

This also has the added benefit of Steam not uploading these dumps to Valve's servers.

## Killing standalone compositors when launching games

Further to this, utilising the `%command%` switch, you can kill standalone compositors (such as Xcompmgr or Compton) - which can cause lag and tearing in some games on some systems - and relaunch them after the game ends by adding the following to your game's launch options.

     killall compton && %command%; compton -b &

Replace `compton` in the above command with whatever your compositor is. You can also add -options to `%command%` or `compton`, of course.

Steam will latch on to any processes launched after `%command%` and your Steam status will show as in game. So in this example, we run the compositor through `nohup` so it is not attached to Steam (it will keep running if you close Steam) and follow it with an ampersand so that the line of commands ends, clearing your Steam status.

## Very slow app download speed

If your Steam apps (games, software…) download speed through the client is unusually slow, but browsing the Steam store and streaming videos is unaffected, installing a DNS cache program, such as dnsmasq can help [5].

## Symbol lookup error using dri3

Steam outputs this error and exits.

     symbol lookup error: /usr/lib/libxcb-dri3.so.0: undefined symbol: xcb_send_request_with_fds

For steam to work, disable dri3 in xorg config file or as a workaround run steam with `LIBGL_DRI3_DISABLE=1`

     LIBGL_DRI3_DISABLE=1 steam

## Launching games on nvidia optimus laptops

To be able to play games which require using nvidia GPU (for example, Hitman 2016) on optimus enabled laptop, you should start steam with primusrun prefix. Otherwise, game will not work. Keep in mind, that issuing some command such as `primusrun steam` while steam is already running will not restart it. You should explicitly exit and then start steam via `primusrun steam` command or start game immediately after start, for example with `primusrun steam steam://rungameid/236870`. After steam was launched with primusrun prefix, you do not need to prefix your game with primusrun or optirun, because it does not matter.

## "Needs to be online" error

If the Steam launcher refuses to start and you get an error saying: "Fatal Error: Steam needs to be online to update" while you **are** online, then there might be issues with name resolving.

Try to install nss-mdns.

## Steamlink cannot find host computer

Steam connects through UDP 27036, 27031 and TCP 27036, 27037. You need to add the rules in your iptables(or similar firewall frontend's). Like so:

     iptables -A -d UDP -p udp --dport 27036 --src Your-subnet-here -j ACCEPT -m comment --comment "SteamLink"
     iptables -A -d UDP -p udp --dport 27031 --src Your-subnet-here -j ACCEPT -m comment --comment "SteamLink"
     iptables -A -d TCP -p tcp --dport 27036 --src Your-subnet-here -j ACCEPT -m comment --comment "SteamLink"
     iptables -A -d TCP -p tcp --dport 27037 --src Your-subnet-here -j ACCEPT -m comment --comment "SteamLink"

## Steam won't remember password

  Related: steam-for-linux#5030

Steam for Linux has a bug which causes it to forget the password of some users.

As a workaround, after logging in to Steam, run

    $ chmod -w ~/.steam/registry.vdf

This will make the file read-only so Steam cannot edit it, and thus not log you out.

## Steam license problem with playing videos

Steam uses googles widevine DRM for some videos. When this is not installed an error message saying "This video requires a license to play which cannot be retrieved. This may be a temporary network condition. Please restart the video to try again." will appear

To solve this issue follow the steps explained here: https://support.steampowered.com/kb_article.php?ref=8699-OASD-1871#15

Category:

- Gaming

Hidden categories:

- Pages or sections flagged with Template:Expansion
- Pages with broken section links