Sign inSign up

bresam/the-front-game-server

By bresam

•Updated over 1 year ago

"The Front" Game Server, containerized and with auto updates

Image
1

643

bresam/the-front-game-server repository overview

⁠The Front - Game Server

This docker image runs a "The Front" game server.

GitHub repository⁠

Docker hub⁠

⁠Features

  • Preinstalled The Front Server on image
  • Auto update of the server on each container start (can be disabled by configuration)
  • Configs by environment variables, see: Configuration / Environment variables⁠

⁠Disclaimer

Some configs are configurable by environment variables, but by no means all of them yet.

If you need more or different configuration possibilities please create a pull request or just open an issue on GitHub with your request here⁠.

IMPORTANT: If you don't know, the server of "The Front" has beefy resource requirements.
An estimation for an absolute minimum is probably 8GB RAM and 2 CPU's
12 GB RAM and 4 CPU's is probably better...

IMPORTANT The GPL⁠ clearly explains that there is no warranty for this free software.

⁠Simple server start

# Quick test run without persistence
# IMPORTANT: PublicIpAddress must be reachable from clients and is also the address which is communicated to steam (server list)
docker run \
  -e FRONT_CONFIG_SERVER_NAME="YourServerName" \
  -e FRONT_OUT_IP_ADDRESS="PublicIpAddress" \
  -p "5500:5500/tcp" \
  -p "5500:5500/udp" \
  -p "5501:5501/tcp" \
  -p "5501:5501/udp" \
  -p "5502:5502/tcp" \
  -p "27015:27015/tcp" \
  bresam/the-front-game-server:latest
# Run with persistence of game save files
# IMPORTANT: PublicIpAddress must be reachable from clients and is also the address which is communicated to steam (server list)
docker run \
  -e FRONT_CONFIG_SERVER_NAME="YourServerName" \
  -e FRONT_OUT_IP_ADDRESS="PublicIpAddress" \
  -p "5500:5500/tcp" \
  -p "5500:5500/udp" \
  -p "5501:5501/tcp" \
  -p "5501:5501/udp" \
  -p "5502:5502/tcp" \
  -p "27015:27015/tcp" \
  -v "/your/host/path/to/front_storage_folder:/home/gameserver/the_front/game_storage"
  bresam/the-front-game-server:latest

⁠Configuration / Environment variables

Environment variableDescription
FRONT_SERVER_NAMEServer name shown in server list
FRONT_SERVER_TITLEAdditional title in description on connection to server
FRONT_CONFIG_SERVER_NAMEUnique name used as part of the game save storage folder, if changed on start another game save state will be loaded/initialized
FRONT_MAX_PLAYERSMaximum allowed players (default: 10)
FRONT_OUT_IP_ADDRESSPublic IP address of the server, must be accessible for all clients, is published and used for connecting from server list
FRONT_PORT_GAMEGame port TCP & UDP (default: 5500)
FRONT_PORT_BEACONBeacon port TCP & UDP (default: 5501)
FRONT_PORT_SHUTDOWN_SERVICEShutdown service port TCP (default: 5502)
FRONT_PORT_QUERYSteam query port (default: 27015)
FRONT_SERVER_PASSWORDOptional server password
FRONT_SERVER_AUTO_UPDATE_ON_STARTUpdate server version on container start (default: true)
FRONT_SERVER_ADMIN_ACCOUNTSSteam IDs of administrators, separated by ";" eg.: "xxxx..." or "xxxx...;yyyy..."
FRONT_GAME_PHYSICS_VEHICLEGame config (default: false)
FRONT_GAME_MAX_FRAME_RATEGame config (default: 35)

⁠Docker compose example

services:
  the-front-server:
    image: bresam/the-front-game-server:latest
    environment:
      FRONT_CONFIG_SERVER_NAME: local_test_1
      FRONT_OUT_IP_ADDRESS: 127.0.0.1
      # FRONT_SERVER_AUTO_UPDATE_ON_START: false
      # FRONT_SERVER_PASSWORD: 1234
      # FRONT_SERVER_ADMIN_ACCOUNTS: "xxxxxxxxxxxxxxxxx;yyyyyyyyyyyyyyyyy"
    ports:
      - "5500:5500/tcp"
      - "5500:5500/udp"
      - "5501:5501/tcp"
      - "5501:5501/udp"
      - "5502:5502/tcp"
      - "27015:27015/tcp"
    volumes:
      - "./game_storage:/home/gameserver/the_front/game_storage"

⁠Network / Firewall

Here you see an example configuration of a well tested The Front server running on aws EC2 instance with docker. On some ports I am not sure if both, tcp and udp, is really necessary, but it works.

Port startPort endProtocolDescription
55005502tcp, udpGame ports
2701527015tcpSteam Query port
-1-1icmpICMP used for server ping, otherwise server list shows 500ms ping

Tag summary

Content type

Image

Digest

sha256:ef5ddc7b7…

Size

2.8 GB

Last updated

over 1 year ago

docker pull bresam/the-front-game-server