mirror of
https://github.com/tgstation/tgstation-server.git
synced 2026-08-29 16:11:05 +01:00
Buff readme
This commit is contained in:
@@ -38,10 +38,11 @@ Note that tgstation-server has only ever been tested on Linux via it's [docker e
|
||||
tgstation-server supports running in a docker container and is the recommended deployment method for Linux systems due being the only robustly tested environment. 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` in the repository root.
|
||||
|
||||
To create a container run
|
||||
```
|
||||
```sh
|
||||
docker create \
|
||||
--restart=always \ #if you want maximum uptime
|
||||
--network="host" \ #if your sql server is on the same machine
|
||||
--name="tgs" \ #or whatever else you wanna call it
|
||||
-p <tgs port>:80 \
|
||||
-p 0.0.0.0:<public game port>:<internal game port> \
|
||||
-v /path/to/store/instances:/tgs4_instances \
|
||||
@@ -53,6 +54,8 @@ with any additional options you desire (i.e. You'll have to expose more game por
|
||||
|
||||
Note although `/app/lib` is specified as a volume mount point in the `Dockerfile`, unless you REALLY know what you're doing. Do not mount any volumes over this for fear of breaking your container.
|
||||
|
||||
Before starting your container make sure the aforemention `appsettings.Production.json` is configured properly. See below
|
||||
|
||||
### Configuring
|
||||
|
||||
Create an `appsettings.Production.json` file next to `appsettings.json`. This will override the default settings in appsettings.json with your production settings. There are a few keys meant to be changed by hosts. Modifying any config files while the server is running will trigger a safe restart (Keeps DreamDaemon's running). Note these are all case-sensitive:
|
||||
@@ -87,6 +90,8 @@ For the Windows service version start the `tgstation-server-4` service. If it fa
|
||||
|
||||
For the console version run `dotnet Tgstation.Server.Host.Console.dll` in the installation directory. The `tgs.bat` and `tgs.sh` shell scripts are shortcuts for this. If on Windows and you wish to install byond versions >= 512.1427 you must do this as admin to give the server permission to install the required DirectX dependency
|
||||
|
||||
For the docker version run `docker start tgs`
|
||||
|
||||
### Stopping
|
||||
|
||||
Note that the live detach for DreamDaemon servers is only supported for updates or restarts via the API at this time. Stopping tgstation-server will TERMINATE ALL CHILD DREAMDAEMON SERVERS.
|
||||
@@ -95,6 +100,8 @@ For the Windows service version stop the `tgstation-server-4` service
|
||||
|
||||
For the console version press `Ctrl+C` or send a SIGQUIT to the ORIGINAL dotnet process
|
||||
|
||||
For the docker version run `docker stop tgs`
|
||||
|
||||
## Integrating
|
||||
|
||||
A breaking change from V3: tgstation-server 4 now REQUIRES the DMAPI to be integrated into any BYOND codebase which plans on being used by it. The integration process is a fairly simple set of code changes.
|
||||
|
||||
Reference in New Issue
Block a user