docker.md
1 # Docker image 2 3 ## Available images 4 Please see available images on [Gitlab](https://gitlab.com/MrTREX/lineage2ts/container_registry/): 5 - `latest` tag is built on any recent improvements and may contain unstable functionality 6 - `release` tag is available for last release 7 8 Supported CPU architectures: 9 - amd64 10 - arm64 11 12 ## Running image 13 Please use following examples to run `latest` image: 14 - pull image via command `docker pull registry.gitlab.com/mrtrex/lineage2ts/server:latest` 15 - run image via command `docker run -p 7777:7777 -p 2106:2106 -e GS.server.ExternalServerIP=127.0.0.1 lineage2ts/server:latest` 16 17 Please note to specify correct external IP address of server in order for game client to connect successfully. In above example, 18 server IP address is `127.0.0.1` or `localhost`. If you plan to deploy image to remote server, you would need to specify server IP ( example `10.0.0.1` ). 19 20 ## Environment variable and configuration 21 Configuration files exist for both login and game servers. With environment variables providing easy to use overrides in container environments: 22 - game server individual config files are edited in mapped volume for internal container path `/opt/lineage2ts/game-server/configuration` 23 - login server individual config files are edited in mapped volume for internal container path `/opt/lineage2ts/login-server/configuration` 24 - game server environment variables override config files and are specified as `GS.<config>.<property>`, example being `GS.logger.LogLevel=info` 25 - login server environment variables override config files and are specified as `LS.<config>.<property>`, example being `LS.logger.LogLevel=info` 26 27 ## Extracting files from an image 28 There is a need sometimes to test or perhaps avoid dealing with datapack or geopack generation, and to get particular files 29 from docker image. In such case there exists a way to copy files. 30 31 Here are few examples to get datapack and geopack archive files. You will need to use 7z extraction utility to get decompressed files: 32 - `docker run --entrypoint /bin/cat registry.gitlab.com/mrtrex/lineage2ts/server:latest /opt/lineage2ts/game-server/datapack.7z > premade.datapack.7z` 33 - `docker run --entrypoint /bin/cat registry.gitlab.com/mrtrex/lineage2ts/server:latest /opt/lineage2ts/game-server/geopack.7z > premade.geopack.7z`