andrewmackrodt/pcsx2-x11 repository overview

⁠andrewmackrodt/docker-pcsx2-x11⁠

PCSX2⁠ is a free and open-source PlayStation 2 (PS2) emulator. Its purpose is to emulate the PS2's hardware, using a combination of MIPS CPU Interpreters, Recompilers and a Virtual Machine which manages hardware states and PS2 system memory. This allows you to play PS2 games on your PC, with many additional features and benefits.

⁠Features

• OpenGL acceleration (Mesa DRI/GLX and nvidia †)
• Audio via PulseAudio
• Controller support (tested with wireless DS4 over Bluetooth)

† nvidia driver note

libnvidia-gl-525 is provided in the image, being the current supported version in the latest Ubuntu LTS release. The host driver version will be checked every time the container is started and if there is a version mismatch, an attempt to install the correct driver in the container will be made unless:

1. Any of the following directories are present: /usr/local/nvidia/lib, /usr/local/nvidia/lib64 or /nvidia. It is assumed that the correct libraries are mounted from the host. Directories will be added to /etc/ld.so.conf.d/nvidia.conf.
2. The environment variable NVIDIA_SKIP_DOWNLOAD=1 has been set.
3. The installed driver matches the host /proc/driver/nvidia/version.

The first option is the preferred way to add nvidia drivers to the container. See here⁠ for an example on generating the required files on the host. It may also be possible to achieve this using nvidia-docker⁠.

⁠Requirements

PCSX2 requires an original Playstation 2 BIOS, this cannot be included in the image for copyright reasons. If you have a homebrew enabled Playstation 2, you can dump the BIOS using the tools⁠ from the PCSX2 website.

Alternatively, if you have previously created a BIOS backup, you may set the environment variable BIOS_ZIP to the backup url and it will be downloaded automatically during container start. This must be a zip file which contains the BIOS .bin file(s) in the root of the archive. Additionally, a SHA-256 hash may be specified via BIOS_CHECKSUM to ensure the correct file is being processed.

BIOS files should be placed in /bios, e.g. docker run -v ~/.pcsx2/bios:/bios ... andrewmackrodt/pcsx2-x11.

⁠Usage

⁠docker

# detect gpu devices to pass through
GPU_DEVICES=$( \
    echo "$( \
        find /dev -maxdepth 1 -regextype posix-extended -iregex '.+/nvidia([0-9]|ctl|-modeset)' \
            | grep --color=never '.' \
          || echo '/dev/dri'\
      )" \
      | sed -E "s/^/--device /" \
  )

# create the container
docker create \
  --name pcsx2 \
  --cap-add NET_ADMIN \
  --net host \
  --device /dev/input \
  --device /dev/snd \
  $GPU_DEVICES \
  -v $HOME/Games/PS2:/games:ro \
  -v $HOME/.pcsx2/data:/data \
  -v $HOME/.pcsx2/bios:/bios \
  -v $HOME/.pcsx2/plugins:/plugins \
  -e BIOS_ZIP=${BIOS_ZIP:-} \
  -e BIOS_CHECKSUM=${BIOS_CHECKSUM:-} \
  -e PUID=$(id -u) \
  -e PGID=$(id -g) \
  -e DISPLAY=unix$DISPLAY \
  -e LANG=${LANG:-en_US.UTF-8} \
  -v /tmp/.X11-unix:/tmp/.X11-unix:ro \
  -v /etc/machine-id:/etc/machine-id:ro \
  -v $HOME/.config/pulse:/home/ubuntu/.config/pulse:ro \
  -v /run/user/$(id -u)/pulse:/run/user/$(id -u)/pulse:ro \
  -v /run/udev/data:/run/udev/data:ro \
  -v /etc/localtime:/etc/localtime:ro \
  andrewmackrodt/pcsx2-x11

⁠Parameters