Manage Your Game Server Easily With LinuxGSM

The command-line tool for quick, simple deployment and management of Linux Eco dedicated game servers.

Getting started

game-server: ~$ ./ecoserver install

Linux

Runs on your favorite Linux distros. Ubuntu, CentOS and more.

Easy to use

Designed to be simple to install and use.

Linux

Runs on your favorite Linux distros. Ubuntu, CentOS and more.

Easy to use

Designed to be simple to install and use.

game-server: ~$ ./ecoserver install

Many Games Supported

103 game servers are supported and counting.

Open Source

Written in BASH and using the MIT License.

Many Games Supported

206 game servers are supported and counting.

Open Source

Written in BASH and using the MIT License.

Hassle Free Dedicated Servers

Traditionally game servers are not easy to manage yourself. Admins often have to spend hours messing around trying to get their server working. LinuxGSM is a command-line tool designed to be as simple as possible, allowing admins to spend less time on management and more time gaming.

Benefits

Easy to install
Simple CLI
Well documented
Automated
Regularly updated
Open source
Compatible

Features

Installer
Updater
Monitor
Alerts
Server Details
Backups
Console

Getting Started with ecoserver

Below are the basic instructions you need to get your own Eco server up and running.

Installation Guide

Don't have a server? Install ecoserver on a cloud server.
Linode [recommended], Vultr, DigitalOcean, UpCloud.
Most offer free credit to get you started.

Compatibility

ecoserver will run on popular distros as long as the minimum requirements are met.

Minimum Recommended Distros

Ubuntu 16.04 LTS
Debian 8
Fedora latest release
CentOS 7

Other Distros

Although not tested, any distro with tmux => 1.6 should also be compatible with ecoserver servers.

Supported Architecture

64-Bit distros ARE supported.
32-Bit distros ARE supported.

Only 32-Bit binary is available.

Notes

Eco server requires Mono 5. However, does not work with Mono 6 (the latest version) Please ensure you are running mono 5 or eco will fail to run. LinuxGSM will complain that mono-complete is not installed, as it tries to install the official repo, please ignore this. The next release on eco 0.9.0 will no longer require mono. Because of this LinuxGSM will not actively resolve this bug

SteamCMD

SteamCMD by Valve is used to install and update this game server.

SteamDB

Steam uses Appid 739590. Find out more at SteamDB.

Dependencies

Before installing, you must ensure you have all the dependencies required to run ecoserver.

Ubuntu 64-bit

sudo dpkg --add-architecture i386; sudo apt update; sudo apt install mailutils postfix curl wget file tar bzip2 gzip unzip bsdmainutils python util-linux ca-certificates binutils bc jq tmux lib32gcc1 libstdc++6 libstdc++6:i386 mono-complete

Ubuntu 32-bit

 sudo apt install mailutils postfix curl wget file tar bzip2 gzip unzip bsdmainutils python util-linux ca-certificates binutils bc jq tmux libstdc++6 mono-complete

Debian 64-bit

sudo dpkg --add-architecture i386; sudo apt update; sudo apt install mailutils postfix curl wget file tar bzip2 gzip unzip bsdmainutils python util-linux ca-certificates binutils bc jq tmux lib32gcc1 libstdc++6 libstdc++6:i386 mono-complete

Debian 32-bit

 sudo apt install mailutils postfix curl wget file tar bzip2 gzip unzip bsdmainutils python util-linux ca-certificates binutils bc jq tmux libstdc++6 mono-complete

Fedora 64-bit

dnf install mailx postfix curl wget file tar bzip2 gzip unzip python binutils bc jq tmux glibc.i686 libstdc++ libstdc++.i686 mono-complete

Fedora 32-bit

dnf install mailx postfix curl wget file tar bzip2 gzip unzip python binutils bc jq tmux libstdc++ mono-complete

EPEL is required to install some dependencies needed for using LinuxGSM on CentOS.

yum install epel-release

CentOS 64-bit

yum install mailx postfix curl wget tar bzip2 gzip unzip python binutils bc jq tmux glibc.i686 libstdc++ libstdc++.i686 mono-complete

CentOS 32-bit

yum install mailx postfix curl wget tar bzip2 gzip unzip python binutils bc jq tmux libstdc++ mono-complete

Install

From the command-line do the following. Ensuring you have also installed the dependencies above.

1. Create a user and login.

adduser ecoserver

note: do NOT set the password as ecoserver. Use a strong password.

random password:

passwd ecoserver

su - ecoserver

2. Download linuxgsm.sh.

wget -O linuxgsm.sh https://linuxgsm.sh && chmod +x linuxgsm.sh && bash linuxgsm.sh ecoserver

3. Run the installer and follow the instructions.

./ecoserver install

Support this project on Patreon, Paypal and Ko-Fi.

Further documentation and support is available.

Basic Usage

All Commands

A complete list of commands can be found by typing

./ecoserver

Below are the most common commands available.

Running

start

./ecoserver start

stop

./ecoserver stop

restart

./ecoserver restart

console

Console allows you to view the live console of a server as it is running and allow you to enter commands; if supported.

./ecoserver console

To exit the console press CTRL+b d. Pressing CTRL+c will terminate the server.

Updating

update

Update checks for any server updates and applies them. The server will update and restart only if required.

./ecoserver update

Bypass the check and go straight to SteamCMD update.

./ecoserver force-update

validate

You can use the SteamCMD validate option when updating the server.

./ecoserver validate

Debugging

Details

You can get all important and useful details about the server such as passwords, ports, config files etc.

./ecoserver details

Debug

Use debug mode to help you if you are having issues with the server. Debug allows you to see the output of the server directly to your terminal allowing you to diagnose any problems the server might be having.

./ecoserver debug

Logs

Server logs are available to monitor and diagnose your server. Script, console and game server (if available) logs are created for the server.

/home/ecoserver/logs

Backup

Backup will allow you to create a complete tar bzip2 archive of the whole server.

./ecoserver backup

Monitor

LinuxGSM can monitor the game server by checking that the proccess is running and querying it. Should the server go offline LinuxGSM can restart the server and send you an alert. You can use cronjobs to setup monitoring.

./ecoserver monitor

Configure LinuxGSM

For details on how to alter LinuxGSM settings visit LinuxGSM Config Files page.

Documentation

For detailed documentation visit the LinuxGSM docs.

Support

Google

Its always a good idea to use Google before posting your questions. Many questions people ask have been asked before. So to save time always use google before posting a question. google.com

Documentation

LinuxGSM Docs

The LinuxGSM docs are a useful resource for all LinuxGSM related topics.

General Support

LinuxGSM Support

For general LinuxGSM support visit the LinuxGSM-Support issues page.

Bugs/Features

GitHub Issues

LinuxGSM has a GitHub issues page where you can submit any bugs and feature suggestions.

Community

Discord

Join the LinuxGSM Discord community server. Discuss your LinuxGSM setup, get help and advice.