nerodon/icarus-dedicated repository overview

For assistance, message @Nerodon on the official Icarus Discord or open an issue on Gitlab

⁠icarus-dedicated-server

This dedicated server will automatically download/update to the latest available server version when started. The dedicated server runs in Ubuntu 24.04 and wine

⁠Environment Vars

Refer to https://github.com/RocketWerkz/IcarusDedicatedServer/wiki/Server-Config-&-Launch-Parameters⁠ for more detail on server configs

⁠Ports

The server requires 2 UDP Ports, the game port (Default 17777) and the query port (Default 27015) They can be changed by specifying the PORT and QUERYPORT env vars respectively.

⁠Volumes

• The server binaries are stored at /game/icarus
• The server saves are stored at /home/steam/.wine/drive_c/icarus

Note: by default, the volumes are owned by user 1000:1000 please set the permissions to the volumes accordingly. To change the user and group ID, simply define the STEAM_USERID and STEAM_GROUPID environment variables.

⁠Example Docker Run

docker run -p 17777:17777/udp -p 27015:27015/udp -v data:/home/steam/.wine/drive_c/icarus -v game:/game/icarus -e SERVERNAME=AmazingServer -e JOIN_PASSWORD=mypassword -e ADMIN_PASSWORD=mysupersecretpassword  nerodon/icarus-dedicated:latest

⁠Example Docker Compose

version: "3.8"

services:
 
  icarus:
    container_name: icarus-dedicated
    image: nerodon/icarus-dedicated:latest
    hostname: icarus-dedicated
    init: true
    restart: "unless-stopped"
    ports:
      - 17777:17777/udp
      - 27015:27015/udp
    volumes:
      - data:/home/steam/.wine/drive_c/icarus
      - game:/game/icarus
    environment:
      - SERVERNAME=myAmazingServer
      - BRANCH=public
      - PORT=17777
      - QUERYPORT=27015
      - JOIN_PASSWORD=mypassword
      - ADMIN_PASSWORD=mysupersecretpassword
      - STEAM_USERID=1000
      - STEAM_GROUPID=1000
      - STEAM_ASYNC_TIMEOUT=60
      - GAMESAVEFREQUENCY=5
      - FIBERFOLIAGERESPAWN=false
      - LARGESTONERESPAWN=false

volumes:
  data: {}
  game: {}
 

⁠License

MIT License

⁠Known Issues

• Out of memory error: Freeing x bytes from backup pool to handle out of memory and Fatal error: [File: Unknown] [Line: 197] \nRan out of memory allocating 0 bytes with alignment 0\n but system has enough memory.
  • Solution: Increase maximum number of memory map areas (vm.max_map_count) tested with 262144
    temporary:

      sysctl -w vm.max_map_count=262144
    

    Copy
    permanent:

      echo "vm.max_map_count=262144" >> /etc/sysctl.conf && sysctl -p
    

    Copy
  Credit: Thanks to Icarus discord user Fabiryn for the solution.