Eco - LinuxGSM

Compatibility Dependencies Install Basic Usage

Compatibility

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

Install 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

Minimum Recommended Distros

Other Distros

Although not tested, any distro with tmux => 1.6 should also be compatible with ecoserver servers. For distros not listed above LinuxGSM does not check dependencies and should be manually checked.

Game Server Binary

Only 32-Bit game server binary is available.

Notes

SteamCMD

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

SteamDB

Steam uses appid 739590.
Update history is available from 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 netcat lib32gcc1 lib32stdc++6 steamcmd 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 netcat lib32gcc1 lib32stdc++6 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 python3 binutils bc jq tmux glibc.i686 libstdc++ libstdc++.i686 mono-complete

Gamedig

GameDig is a recommended additional module that allows LinuxGSM to gather more info from the game server such as current map and connected players to be displayed in details and in logs. It also replaces the default LinuxGSM query module in monitor. To install GameDig follow the steps in the LinuxGSM documentation.

Install Dependencies Using LinuxGSM

It is possible for LinuxGSM to install dependencies either by having the ecoserver user account with sudo access or running the installer as root.

user with sudo access

During the installation if the game server user has sudo permissions LinuxGSM will attempt to install any missing dependencies itself.

root user

if ecoserver is already installed run ./ecoserver install as root and LinuxGSM will automatically install missing dependencies.

Install

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

1. Create a user and login.

adduser ecoserver

For security best practice, ensure you set a strong password. Random password:

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 following the on-screen instructions.

./ecoserver install

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.

Deploy Eco Game Servers