cyberpresidentvanellope/tgstation-server
1
0
Fork 0
mirror of https://github.com/tgstation/tgstation-server.git synced 2026-08-24 21:46:52 +01:00
Code Issues Packages Projects Releases Wiki Activity

Add Systemd unit

Browse Source 
Closes #1420
This commit is contained in:
Jordan
2023-06-19 05:16:45 -04:00
parent b0c002ddb0
commit 1af149f81c
3 changed files with 21 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+6 -5
View File
@@ -37,22 +37,23 @@ If using the console version, run ./tgs.bat in the root of the installation dire
#### Linux (Native)
We recommend using Docker for Linux installations, see below. The content of this parent section may be skipped if you choose to do so.
Installing natively is the recommended way to run tgstation-server on Linux.
The following dependencies are required to run tgstation-server on Linux alongside the .NET Core runtime
The following dependencies are required.
- aspnetcore-runtime-6.0 (Note, not all supported distros have this package, see the links above for official Microsoft installation instructions)
- libc6-i386
- libstdc++6:i386
- gdb (for using gcore to create core dumps)
- gcc-multilib (Only on 64-bit systems)
To launch the server, run ./tgs.sh in the root of the installation directory. The process will run in a blocking fashion. SIGQUIT will close the server, terminating all live game instances.
If you have SystemD, we recommend installing the service unit [here](./build/tgstation-server.service). It assumes TGS is installed into `/opt/tgstation-server` but feel free to adjust it to your needs. Note that the server will need to have it's configuration file setup before running with SystemD.
Note that tgstation-server has only ever been tested on Linux via it's [docker environment](build/Dockerfile#L22). If you are having trouble with something in a native installation, or figure out a required workaround, please contact project maintainers so this documentation may be better updated.
Alternatively, to launch the server in the current shell, run `./tgs.sh` in the root of the installation directory. The process will run in a blocking fashion. SIGQUIT will close the server, terminating all live game instances.
#### Docker (Linux)
tgstation-server supports running in a docker container and is the recommended deployment method for Linux systems. The official image repository is located at https://hub.docker.com/r/tgstation/server. It can also be built locally by running `docker build . -f build/Dockerfile -t <your tag name>` in the repository root.
tgstation-server supports running in a docker container. The official image repository is located at https://hub.docker.com/r/tgstation/server. It can also be built locally by running `docker build . -f build/Dockerfile -t <your tag name>` in the repository root.
To create a container run
```sh
build/tgstation-server.service
+14
View File
@@ -0,0 +1,14 @@
[Unit]
Description=tgstation-server
After=network.target
[Service]
ExecStart=/bin/bash /opt/tgstation-server/tgs.sh General:SetupWizardMode=Never
Restart=Always
RestartKillSignal=SIGUSR1
AmbientCapabilities=CAP_SYS_NICE
StandardOutput=null
StandardError=null
[Install]
WantedBy=multi-user.target
tgstation-server.sln
+1
View File
@@ -36,6 +36,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "build", "build", "{6FF654E6
build\tgs.docker.sh = build\tgs.docker.sh
build\tgs.ico = build\tgs.ico
build\tgs.png = build\tgs.png
build\tgstation-server.service = build\tgstation-server.service
build\Version.props = build\Version.props
EndProjectSection
EndProject