Necesse: Dedicated Server in Docker

A very generic necesse dedicated server, which updates itself on startup with or without Mods in Docker

Dockerfile

######## Auto Updating Necesse Server ########
FROM openjdk:latest
ENV USER necesse
ENV HOME /home/necesse
WORKDIR $HOME
COPY --from=steamcmd/steamcmd:latest /usr/lib/games/steam /usr/lib/games/steam
COPY --from=steamcmd/steamcmd:latest /usr/bin/steamcmd /usr/bin/steamcmd
COPY --from=steamcmd/steamcmd:latest /etc/ssl/certs /etc/ssl/certs
COPY --from=steamcmd/steamcmd:latest /lib /lib
RUN mkdir necesse
RUN printf '#!/bin/bash \n\
steamcmd +login anonymous +force_install_dir ${HOME}/necesse +app_update 1169370 validate +quit \n\
i=1 \n\
variable="MOD_$i" \n\
value=${!variable} \n\
if test ! -z "$value"; then \n\
    mkdir -p .config/Necesse/mods \n\
    rm .config/Necesse/mods/* \n\
fi \n\
while test ! -z "$value"; do \n\
    steamcmd +login "$STEAM_USER" "$STEAM_PASSWORD" +force_install_dir $HOME +workshop_download_item 1169040 $value +quit \n\
    i=$((i+1)) \n\
    variable="MOD_$i" \n\
    value=${!variable} \n\
    mv steamapps/workshop/content/**/**/*.jar .config/Necesse/mods \n\
done \n\
java -jar ${HOME}/necesse/Server.jar -nogui $@ \n\
' >> entrypoint
RUN chmod +x entrypoint
# If you wish a cold start container, comment the next Line in
RUN steamcmd +login anonymous +force_install_dir ${HOME}/necesse +app_update 1169370 validate +quit
ENTRYPOINT ["./entrypoint"]
EXPOSE 14159

Building

docker build . -t necesse-server

Testing

Just test it with interactive mode:

docker run -it necesse-server

But it makes more sense to run it as demon, you also can use all the default start parameters:

docker run -d necesse-server -world mynewworld

Run a Server with No/Self Managed Mods

docker run -d --mount type=bind,source=</a/directory/on/your/harddrive>,target=/home/necesse/.config/Necesse/ -p 14159:14159 necesse-server -world <worldname>

in a docker-compose.yml it would look something like this:

version: '3.7'
services:
  necesse-server:
    restart: unless-stopped 
    build: .
    ports:
      - "14159:14159"
    volumes:
      - type: bind
        source: /srv/docker/necesse-config/
        target: /home/necesse/.config/Necesse/
    command: ["-world", "myworldname"]

Run a Server with Mods

You can only download Mods from the Steam workshop, if you own the Game, so you need to provide steam credintials for an account which owns the game and is not steam guard protected for running an automated necesse server with mods.
You should provide the password with a docker secret, but for this example it’s plaintext

docker run -d --env STEAM_USER=<ASteamAccountWhichOwnsNecesse> --env STEAM_PASSWORD=<SteamPassword> --env MOD_1=<modId> --env MOD_2=<modId> --mount type=bind,source=</a/directory/on/your/harddrive>,target=/home/necesse/.config/Necesse/ necesse-server -world <worldname>

in a docker-compose.yml:

version: '3.7'
services:
  necesse-server:
    restart: unless-stopped 
    build: .
    ports:
      - "14159:14159"
    volumes:
      - type: bind
        source: /srv/docker/necesse-config/
        target: /home/necesse/.config/Necesse/
    command: ["-world", "myworldname"]
    environment:
      STEAM_USER: ASteamAccountWhichOwnsNecesse
      STEAM_PASSWORD: SteamPassword
      MOD_1: 2833909781 # Better Enchantment Mod

Thanks to Mike Rohsoft for his excellent guide, all credits belong to his effort. if this guide helps you, please support and rate it via Steam Community. enjoy the game.