LogoLogo
  • Home
  • Getting Started
  • Configuration
    • LinuxGSM Config
    • Game Server Config
    • Start Parameters
    • cronjobs
    • Running on Boot
    • Running Multiple Game Servers
    • IP Address Configuration
    • LinuxGSM Stats
  • Commands
    • install
    • start-stop-restart
    • monitor
    • test-alert
    • console
    • debug
    • update
    • check-update
    • force-update
    • validate
    • update-lgsm
    • backup
    • map-compressor
    • details
    • mods
    • skeleton
    • fastdl
    • change-password
  • Game Servers
    • 7 Days to Die
    • Arma 3
    • ARK: Survival Evolved
    • Call of Duty 4
    • Dont Starve Together
    • Counter-Strike 2
    • Counter-Strike: Global Offensive
    • Factorio
    • Garry's Mod
    • Insurgency: SandStorm
    • Killing Floor 2
    • Minecraft: Java Edition
    • Multi Theft Auto
    • Rust
    • Sven Co-op
    • Trackmania Nations Forever / Trackmania United Forever
    • TeamSpeak 3
    • Unreal Tournament 99
    • Unreal Tournament 2004
    • Unreal Tournament 3
    • Valheim
    • Xonotic
    • The Front [WIP]
  • Networking
    • IP Address
    • Ports
    • Source Engine
  • Alerts
    • Discord
    • Email
    • IFTTT
    • Pushbullet
    • Pushover
    • Rocket.Chat
    • Slack
    • Telegram
  • Dependencies
    • Java
    • tmux
    • jq
    • gamedig
    • glibc
  • Features
    • ANSI Colors
    • Stop Mode
    • Log Management
    • Message Display Time
  • SteamCMD
    • Steam Master Server
    • Game Server Login Token
    • Branch
    • LAN Discovery
    • Workshop
    • Error Codes
  • Linux
    • distro
    • ftp-scp
    • file-ownership
    • firewalls
    • network-interfaces
    • permissions
    • Symlinking and ln command
  • Troubleshooting
  • FAQ
  • Guides
    • Security
    • Make Webserver Case Insensitive
    • Sourcemod and Metamod:Source
  • Other
    • server-migration
    • basic-usage
    • brand
Powered by GitBook
On this page
  • Installation issues
  • User and permissions
  • Dependencies
  • Game server downloads
  • Start issues
  • First start issues
  • Modded servers start issues
  • Server start issues after updates
  • Connectivity issues
  • Unable to connect or not showing up in server list
  • If none of these work
Edit on GitHub
Export as PDF

Troubleshooting

PreviousSymlinking and ln commandNextFAQ

Last updated 6 years ago

This guide should cover a wide range of issues, but some might be more complicated than that. If you need further assistance, please make sure you read the Support to know the right place to reach us and what information to provide in order for us to be able to help you.

Installation issues

Your game server might not install for many reasons, mainly user based ones, and some distro based. Make sure you answer "yes" to any of these questions.

User and permissions

  • Did you create a dedicated user for your server?

  • Are you running the script as the right user? Check command: whoami

  • Does the user running the script owns its current directory? Check command: ls -al ., see

  • Does the user have the right permissions on its directories? See

Dependencies

  • Did you install required packages (dependencies) as game page on requests?

  • If sudo isn't installed, did you remove "sudo" from packages install commands?

  • If lib32gcc1 libstdc++6 libstdc++6:i386 packages won't install, did you run apt update after dpkg --add-architecture i386?

  • If some dependencies are not available, did you check your /etc/apt/sources.list? (Debian based and apt only)

Game server downloads

  • Do you have enough disk space on the desired partition? Check command: df -h

  • If the server requests a Steam login, did you enter it properly by editing your (example) "gameserver" script? It's a good idea to have a dedicated Steam account for that purpose.

Start issues

LinuxGSM servers are designed to work out of the box. However, if your server is unable to start, this can have multiple reasons. Some are user based, some are distro based. Here are some ways of diagnosing it.

First start issues

  • Is the server properly installed? See the "Game server downloads" part

  • Are all packages installed properly? See "Dependencies" part

  • Is your Linux installation compatible? 32/64bit, distribution... Check command: uname -a

  • Do you have enough RAM? If not, do you have enough swap? Check command: free -mh

  • Did you set an ip in your (example) gameserver script or config file?

Modded servers start issues

  • Did you try temporarily removing mods, and adding them one by one?

Server start issues after updates

  • Is a mod no longer compatible? Try temporarily removing mods, and adding them one by one.

  • Is it an editor's error, breaking the server? Does it now require newer package versions? Check forums, alert us if needed by opening a Github issue (and check for existing ones).

Connectivity issues

Unable to connect or not showing up in server list

This is a three part diagnosis: 1) First off, you need to make sure that the server is started properly, take attention to any error messages in console or log output. 2) Check that the server is listening, to the right IP. 3) Check for firewalls or ports redirections that could prevent useful network packets from passing through.

Is the server actually started?

Is the server actually listening?

./gameserver details will provide you with the corresponding command to check if the server process is properly listening. Example sample output:

Useful port diagnostic command:
netstat -atunp | grep srcds_linux

Compare the output from this to expected ports displayed in the details command.

If the output differs or your think something is wrong, here are the things to check on:

  • Did you set an ip in your gameserver script or config file or are you listening to 0.0.0.0?

Isn't there a firewall or a missing NAT rule?

Other keys to solving this:

  • Did you wait long enough? Sometimes it's just a matter of time until the server is fully started and listed into the master server list.

If none of these work

GitHub is only for bug reports regarding LinuxGSM, not resolving specific user issues.

These kind of install, start or accessibility issues are generally specific to your server or install or comprehension of Linux, so please, note that posting these on GitHub will only result in your issue being closed without an answer and developers' waste of time. Instead, you should use the support methods offered to the community: Discord or Steam Forum as explained in the Support page. There are lot of nice and helpful users and devs follow them as well whenever they have free time.

If you ever confirm a global bug after this, LinuxGSM's developers will be happy to resolve it if you raise an issue on GitHub with as much elements as possible to help understanding, reproducing and resolving the bug quickly.

To learn where and how to get support, see: Support

If the Steam download didn't work as intended, did you retry it, or try the command? Maybe your connection to Steam servers is faulty.

Did you make sure that a firewall doesn't prevent the download from working? Check command: iptables -L ; See

Note: (example) ./gameserver details will provide you with relevant information and save you some time. See

Are ports already used by another service? See and

Is this a known tmux issue? See

Did you try to start with the debug command? See

What does the logs say? See [

What does the logs say? See [

Did you try to start with the debug command? See

Did you wrongly append start parameters? See

Does the user have the right permissions on its directories? If this is the case, a corresponding error should be displayed. See

What does the logs say? See [

Did you try to start with the debug command? See

Did you try to validate your game files? (SteamCMD servers only) See

Start it with (example ./gameserver start , then check server logs (see [) to see if everything seems OK. You can also try the command and command to see if it's online and if it's able to answer simple queries. If not, then follow the "Start issues" section.

Are the ports you're using free? See

Are you listening to an actual interface IP? See Also, double check for typo mistakes.

Are you behind ? See

If it's a local server, are ports redirection done properly? See and

As usual, first thing you have to ask yourself: What do the logs say? See [

File Ownership
Permissions
https://linuxgsm.com
validate
Firewalls
details
Ports
Multiple-Game-Servers
Tmux
debug
Logging
Logging
debug
Start-Parameters
Permissions
Logging
debug
validate
Logging
details
monitor
Ports
Ports
Firewalls
Firewalls
Ports
details
Logging