[![oclif](]( [![Discord](](
Last updated 3 months ago by egeeirl .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install gsd-cli 
SYNC missed versions from official npm registry.

gsd-cli v2 Build Status

oclif Discord

A CLI tool for deploying dedicated game servers as systemd units (daemons).

This repo is for gsd-cli version 2.x. This version of the cli is written in CoffeeScript and can be downloaded as a global module from npm.

gsd-cli installs dedicated server as user daemons managed by systemd, a Linux system & service manager.

You can interact with systemd services using the systemctl and journalctl commands. Since the cli installs dedicated servers as user daemons, always include the --user flag when interacting with systemd.

For example: systemctl --user restart minecraft.

You can read the log files for a given server using the journalctl command. For example, to follow a Minecraft server's log:

systemctl --user -fu minecraft

All game servers are created in /home/your_user/whatever-server. For example, a minecraft server would look like this:


The dedicated servers themselves are spawned from a shell script script located in the dedicated server's install path. This file is created by the cli from the config file passed to it during install time and is safe to edit after installing a server. For example, the launch script for a Rust server is located:


User-level systemd unit files are located in ~/.config/systemd/user. You can specify the amount of system resources available to the server by adding properties to the .service file if you desire.

Currently supported game servers:

  • minecraft
  • rust
  • 7 days to die[sdtd]
  • garry's mod[gmod]
  • team fortress 2[tf2]


$ npm install -g gsd-cli
$ gsd-cli COMMAND
running command...
$ gsd-cli (-v|--version|version)
gsd-cli/1.3.5 linux-x64 node-v12.13.0
$ gsd-cli --help [COMMAND]
  $ gsd-cli COMMAND


gsd-cli bootstrap

Creates a default gsd game configuration file and places it in the current directory.

  $ gsd-cli bootstrap

  -n, --name=name  name of the server to to pull configs for

See code: dist/commands/bootstrap.js

gsd-cli help [COMMAND]

display help for gsd-cli

  $ gsd-cli help [COMMAND]

  COMMAND  command to show help for

  --all  see all commands in CLI

See code: @oclif/plugin-help

gsd-cli install

Installs a dedicated game server using a config file or a name with default settings.

  $ gsd-cli install

  -d, --dryrun     test installing a server without actually installing it
  -f, --file=file  path to the config file
  -n, --name=name  name of the server to install

See code: dist/commands/install.js

gsd-cli update

Updates an installed dedicated game server

  $ gsd-cli update

  -n, --name=name  game server to update
  -p, --path=path  path the game server is installed at

See code: dist/commands/update.js

Current Tags

  • 1.3.5                                ...           latest (3 months ago)

18 Versions

  • 1.3.5                                ...           3 months ago
  • 1.3.4                                ...           3 months ago
  • 1.3.3                                ...           3 months ago
  • 1.3.2                                ...           3 months ago
  • 1.3.1                                ...           3 months ago
  • 1.3.0                                ...           3 months ago
  • 1.2.0                                ...           3 months ago
  • 1.1.5                                ...           5 months ago
  • 1.1.3                                ...           5 months ago
  • 1.1.2                                ...           5 months ago
  • 1.1.1                                ...           5 months ago
  • 1.1.0                                ...           5 months ago
  • 1.0.2                                ...           5 months ago
  • 1.0.1                                ...           5 months ago
  • 1.0.0                                ...           5 months ago
  • 0.4.0                                ...           5 months ago
  • 0.2.0                                ...           5 months ago
  • 0.1.0                                ...           5 months ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 18
Dependencies (4)
Dev Dependencies (8)
Dependents (0)

Copyright 2014 - 2017 © |