wwmoraes/pvpgn-server-docker

PvPGN-PRO server on Docker

PvPGN Server Docker

---

A simple docker and docker-compose for running a PvPGN-PRO server in no time

📝 Table of Contents

• About
• Getting Started
• Deployment
• Usage
• Built Using
• TODO
• Contributing
• Acknowledgments

🧐 About

Yet another pvpgn-docker project. Aims to be:

• ⌛ time-proof - builds binaries directly from source
• 🔐 secure - uses non-privileged user and group to run the server
• 🗜 small - based on Alpine linux
• ⚖ lightweight - final image doesn't contain source or build tools

Most users should be fine running the official image. Use this image if you prefer Alpine's smaller footprint or if you plan to develop on PvPGN, as the dependencies are installed only once here.

🏁 Getting Started

Pull the image from Docker Hub:

docker pull wwmoraes/pvpgn-server

Then/or just run:

docker run -it wwmoraes/pvpgn-server

PvPGN-PRO is built and installed on the root filesystem. A sample configuration can be found at /etc/pvpgn. Data (logs, storage, scripts, etc) can be found at /var/pvpgn. These are the default locations bnetd will use, unless you configure it to use distinct paths.

🚀 Deployment

The configuration and data paths should be bound to volumes for persistence, and the ports should be published so you can access the server outside of the container:

docker run -it -p 6112:6112 -p 4000:4000 \
  -v <your-config-volume-or-path>:/etc/pvpgn \
  -v <your-data-volume-or-path>:/var/pvpgn \
  wwmoraes/pvpgn-server

IMPORTANT: Make sure the volumes/bind mount sources are readable and writable by the server user and group. The image default is 1001.

🎈 Usage

The build is done with Lua script support enabled, and MySQL support for the account backend.

You can create persistent local volumes for the config and data without starting the server with:

docker run --rm --entrypoint=true \
  -v <your-config-volume-name>:/etc/pvpgn \
  -v <your-data-volume-name>:/var/pvpgn \
  wwmoraes/pvpgn-server

Both volumes must not exist prior to this call for Docker to create and populate them with the image contents.

You can also copy the files to your host system using a temporary bind mount, for instance:

mkdir {var,etc}

docker run --rm --entrypoint=cp --user "$(id -u):$(id -g)" \
  -v $PWD/var:/mnt/var \
  wwmoraes/pvpgn-server \
  -r /var/pvpgn /mnt/var

docker run --rm --entrypoint=cp --user "$(id -u):$(id -g)" \
  -v $PWD/etc:/mnt/etc \
  wwmoraes/pvpgn-server \
  -r /etc/pvpgn /mnt/etc

Please refer to the upstream documentation on how to configure your server.

• PvPGN Configuration
• D2GS Installation Guide

🎉 Acknowledgements

• PvPGN-PRO and its maintainers, which are keeping alive the legacy of PvPGN
• @ibepeer for feedback on #3, which ended on a BRANCH build arg (to clone from develop, for instance)

pvpgn-server-docker's Issues

Cannot connect to server

I pulled your image from docker hub and started it, every seems all good.
I can see the instance running with ps commmand

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
b08464f54a8b wwmoraes/pvpgn-server:latest "/usr/local/pvpgn/sb…" 55 minutes ago Up 55 minutes 4000/tcp, 6112/tcp magical_snyder

but I can't connect with my d2 client, I'm using d2 lod 1.13d without any mod, is it the right version I should use?

[Question]

Mounting volumes for persistence

Im trying to use this so that I can have a mounted volume for data and config persistence but i cant seem to get it to work. Any tips? Also the table of contents in the readme has something about deployment but that section doesnt exist.

docker run --name docker-pvpgn -d  -v /root/docker-pvpgn/etc:/usr/local/pvpgn/etc -v /root/docker-pvpgn/var:/usr/local/pvpgn/var -p 4000:4000 -p 6112:6112 wwmoraes/pvpgn-server

doesnt work..

stops after start with exit code 0

 docker run -p 4000:4000 -p 6112:6112 wwmoraes/pvpgn-server

incorrectly on the DSM6.23

This image runs incorrectly on the DSM6.23 system with no logs, but it runs very well on Centos，thx

There is PvPGN Docker implementation in the PvPGN develop branch

Could you check this out? https://github.com/pvpgn/pvpgn-server/blob/develop/README_DOCKER.md