This is a Docker container for ps3netsrv (or ps3netsvr).
ps3netsrv for WebMAN-MOD by aldostools. Binaries built from the latest sources.
20240709-edge,485bf43-edge,485bf43291752656552c1d895b3263953f64cbcc-edge,edge20240707-edge,1d8c0c9-edge,1d8c0c94f0d52f86edf4b9e1674d658a11f90350-edge20240210a-edge,4ddfef9-edge,4ddfef91d9f4e8000dc76d48ae325533e2426a81-edge20240210-edge,e22b4a0-edge,e22b4a0edbd889d38b70f8f230886cd086a331ad-edge20231215-edge,28b5bdb-edge,28b5bdbbd35ac6e94c262ba2b03f925646e10a25-edge
latest,v1,v1.9,v1.9.0,20231215
This image comes in two different variants.
This image represents a stable or considered "working" build of ps3netsrv and should be preferred.
It is built from the latest released version, found in the webMAN-MOD releases.
If you want a specific ps3netsrv version, you can use the tag of the version e.g. 20220813.
This image represents a development state of this repo. It contains the latest features but is not considered stable, it can contain bugs and breaking changes.
If you are not sure what to choose, use the latest image or a version like v1 or 20220813.
This image will be built from the latest release found in the webMAN-MOD releases as well, but it will be bleeding edge, meaning it will be updated as soon as a new release is found.
The architectures supported by this image are:
| Architecture | Status |
|---|---|
| x86-64 | working |
| x86 | untested |
| arm64 | working |
| armv7 | untested |
| armhf | working |
| dropped |
I'm declaring the arm images as untested because I only own an older first generation RaspberryPi Model B+ I can't properly test the image on other devices, technically it should work on all RaspberryPi models and similar SoCs. While emulating the architecture with qemu works and can be used for testing, I can't guarantee that there will be no issues, just try it.
I would be glad if you could create a small report (choose ARM Compatibility Report) to tell me which device you've tested and if it's working or not.
NOTE: The Docker command provided in this quick start is given as an example and parameters should be adjusted to your need.
Launch the ps3netsrv docker container with the following command:
docker run -d \
--name=ps3netsrv \
-p 38008:38008 \
-v $HOME/ps3games:/games:rw \
shawly/ps3netsrv
Where:
$HOME/ps3games: This location contains files from your host that need to be accessible by the application.
docker run [-d] \
--name=ps3netsrv \
[-e <VARIABLE_NAME>=<VALUE>]... \
[-v <HOST_DIR>:<CONTAINER_DIR>[:PERMISSIONS]]... \
[-p <HOST_PORT>:<CONTAINER_PORT>]... \
shawly/ps3netsrv
| Parameter | Description |
|---|---|
| -d | Run the container in background. If not set, the container runs in foreground. |
| -e | Pass an environment variable to the container. See the Environment Variables section for more details. |
| -v | Set a volume mapping (allows to share a folder/file between the host and the container). See the Data Volumes section for more details. |
| -p | Set a network port mapping (exposes an internal container port to the host). See the Ports section for more details. |
To customize some properties of the container, the following environment
variables can be passed via the -e parameter (one for each variable). Value
of this parameter has the format <VARIABLE_NAME>=<VALUE>.
| Variable | Description | Default |
|---|---|---|
USER_ID |
ID of the user the application runs as. See User/Group IDs to better understand when this should be set. | 1000 |
GROUP_ID |
ID of the group the application runs as. See User/Group IDs to better understand when this should be set. | 1000 |
PS3NETSRV_PORT |
Port used by ps3netsrv. You only need to change this when using network_mode host, otherwise you can just remap ports using Docker! | 38008 |
PS3NETSRV_WHITELIST |
Whitelist IPs e.g. 192.168.1.* or 192.168.1.10-192.168.1.200, this probably only works with network_mode host! |
`` |
TZ |
[TimeZone] of the container. Timezone can also be set by mapping /etc/localtime between the host and the container. |
Etc/UTC |
The following table describes data volumes used by the container. The mappings
are set via the -v parameter. Each mapping is specified with the following
format: <HOST_DIR>:<CONTAINER_DIR>[:PERMISSIONS].
| Container path | Permissions | Description |
|---|---|---|
/games |
rw | This is the path ps3netsrv will serve to clients. |
Here is the list of ports used by the container. They can be mapped to the host
via the -p parameter (one per port mapping). Each mapping is defined in the
following format: <HOST_PORT>:<CONTAINER_PORT>. The port number inside the
container cannot be changed, but you are free to use any port on the host side.
| Port | Mapping to host | Description |
|---|---|---|
38008 |
Mandatory | Port used for ps3netsrv. |
As seen, environment variables, volume mappings and port mappings are specified while creating the container.
The following steps describe the method used to add, remove or update parameter(s) of an existing container. The generic idea is to destroy and re-create the container:
- Stop the container (if it is running):
docker stop ps3netsrv
- Remove the container:
docker rm ps3netsrv
- Create/start the container using the
docker runcommand, by adjusting parameters as needed.
Here is an example of a docker-compose.yml file that can be used with
Docker Compose.
Make sure to adjust according to your needs. Note that only mandatory network ports are part of the example.
version: "3"
services:
ps3netsrv:
image: shawly/ps3netsrv:latest
environment:
TZ: Europe/Berlin
USER_ID: 38008 # change this to the uid of the user that owns your games folder
GROUP_ID: 38008 # change this to the gid of the user that owns your games folder
ports:
- "38008:38008"
volumes:
- "$HOME/ps3games:/games:rw"If the system on which the container runs doesn't provide a way to easily update the Docker image, the following steps can be followed:
- Fetch the latest image:
docker pull shawly/ps3netsrv
- Stop the container:
docker stop ps3netsrv
- Remove the container:
docker rm ps3netsrv
- Start the container using the
docker runcommand.
When using data volumes (-v flags), permissions issues can occur between the
host and the container. For example, the user within the container may not
exists on the host. This could prevent the host from properly accessing files
and folders on the shared volume.
To avoid any problem, you can specify the user the application should run as.
This is done by passing the user ID and group ID to the container via the
USER_ID and GROUP_ID environment variables.
To find the right IDs to use, issue the following command on the host, with the user owning the data volume on the host:
id <username>
Which gives an output like this one:
uid=1000(myuser) gid=1000(myuser) groups=1000(myuser),4(adm),24(cdrom),27(sudo),46(plugdev),113(lpadmin)
The value of uid (user ID) and gid (group ID) are the ones that you should
be given the container.
First things first, if you have any kind of issue please try to use the standalone version of ps3netsrv and try to reproduce the issue. If you have the same issue with the standalone version, it's better to create an issue on the webMAN-MOD repo.
There are several possible causes for this issue. I will use the user bob who has his backups saved in his home folder under /home/bob/ps3games as an example.
ps3netsrv or rather webMAN-MOD wants to read their games from a certain folder structure, so your volume needs at least the folder PS3ISO and GAMES.
Therefore it is necessary for bob to create the folders /home/bob/ps3games/PS3ISO and /home/bob/ps3games/GAMES as well. ISO files go into the PS3ISO folder and extracted games in folder format go into the GAMES folder. So now bob has to mount /home/bob/ps3games to the /games volume within the container. Like this:
docker run -d \
--name=ps3netsrv \
-p 38008:38008 \
-v $HOME/ps3games:/games:rw \
shawly/ps3netsrv
ps3netsrv does not have root permissions within the container, it runs as user ps3netsrv which by default has the UID 1000 and the GID 1000.
There are two solutions for this issue, bob could change the ownership of his ps3games folder to 1000:1000, which is a bad idea because he will lose access if he does not have the UID 1000.
The better solution is to override the ps3netsrv user's UID and GID, this can be done with the environment variables USER_ID and GROUP_ID.
bob has the UID 10002 and his bob group has the GID 10003 so we need to change the environment variables, like this:
docker run -d \
--name=ps3netsrv \
-p 38008:38008 \
-v $HOME/ps3games:/games:rw \
-e USER_ID=10002 \
-e GROUP_ID=10003 \
shawly/ps3netsrv
Make sure to start the ps3netsrv standalone as normal user, not as root user or with sudo. If it works for your root user but not for a non-root user, then go back to troubleshooting step B. If the standalone works with both normal users and root but the container doesn't, check the ownership, see the next point D.
Alright then, please execute ls -l path/to/your/ps3games/folder and docker exec CONTAINERNAME ls -l /games (replace CONTAINERNAME with the actual name of your container). It should look like this:
bob@nas:~$ ls -l /home/bob/ps3games
drwxrwx--- 119 bob bob 119 Mar 4 2019 GAMES
drwxrwx--- 7 bob bob 7 Jun 21 2019 PS3ISO
bob@nas:~$ docker exec ps3netsrv ls -l /games
drwxrwx--- 119 ps3netsrv ps3netsrv 119 Mar 4 2019 GAMES
drwxrwx--- 7 ps3netsrv ps3netsrv 7 Jun 21 2019 PS3ISO
If the folders aren't owned by ps3netsrv or you are not seeing the GAMES and PS3ISO folders, repeat the troubleshooting steps A and B above. If it still doesn't work, you can create a help request with the secret code "SSBoYXZlIHJlYWQsIGZvbGxvd2VkIGFuZCB0cmllZCBldmVyeSB0cm91Ymxlc2hvb3Rpbmcgc3RlcCwgYnV0IGl0IHN0aWxsIGRvZXNuJ3Qgd29yaywgcGxlYXNlIGhlbHAgbWUu".
On some systems like Synology NAS systems the default port of ps3netsrv 38008 is in use already, so you simply need to change the host port to something else on the container and change the port within webMAN-MOD's webinterface to the same port.
If the port is not the issue, it might be the latest build of ps3netsrv, try out some older tags of my Docker image as well as the standalone version of ps3netsrv.
This is an issue related to the latest UnRAID version, the splitting mechanism of shfs seems to be incompatible with ps3netsrv, take a look at this issue, at the bottom you can find some workarounds. If you do not have UnRAID but some other filesystem please test the standalone version of ps3netsrv before creating an issue here. If the issue also happens with the ps3netsrv standalone on a standard ext4 filesystem, your games are likely to be corrupted or you don't own the files within your games folders, check permissions and/or make new backups.
Still have trouble with the container or have questions? Please create a new issue. The secret code for help issues is hidden in the troubleshooting steps, read them carefully. If you do not add the help code to your issue, I will have to close it sorry.