Granting Port Access

The PlayStation 4 integration requires the use of privileged ports to work correctly, specifically UDP port 987 and TCP port 997. Depending on your OS of your Home Assistant instance you may need to allow usage of privileged ports manually.

Do not run your Home Assistant instance itself as root or with root/sudo privileges to accomplish this. This would create a security risk for your host system.

There are varying methods to perform this, dependent on your OS that is running Home Assistant. Specifically, your Python Interpreter which runs your Home Assistant instance needs access to the mentioned ports.

If your Home Assistant device is running Hass.io on HassOS, it does not require additional configuration.

Debian-based

Home Assistant installed on a Debian-type OS may require configuration. This section is applicable but not limited to the following operating systems:

Debian

Hassbian

Rassbian

Armbian

Ubuntu

In terminal run the following command:

sudo setcap 'cap_net_bind_service=+ep' <python>

Replace <python> with your system path to Python that is running Home Assistant and/or your virtual environment if used. The path should not be a symlink or be inside of a virtual environment.

Example:

sudo setcap 'cap_net_bind_service=+ep' /usr/bin/python3.5

To find your system Python path:

Add the System Health integration to your configuration.yaml. In a web browser access your frontend and navigate to the about/logs page “http:///developer-tools/info). In the System Health box locate the item python_version and note the value that is displayed. Then in terminal run:

whereis python<version>

Replace <version> with the value for python_version that is shown in the System Health box.

Example:

whereis python3.5.3

The output which has the directory /bin/ is likely your system python path which should look like this /usr/bin/python3.5

If Home Assistant is installed in a virtual environment, use terminal to cd to the root/top directory of your environment and run:

readlink -f bin/python3

or

readlink -f bin/python

The output will be your system Python path.

Docker

When running Home Assistant using Docker, make sure that the Home Assistant container is discoverable by the PS4. This can be achieved by ensuring that the Home Assistant container uses the host network driver (by passing --net=host to the container when creating, or adding network_mode: "host" to your compose file when using docker-compose).

Configuration

The PlayStation 4 integration does not use entries from configuration.yaml. You must configure this integration by using Integrations

Regions

Some titles will have different SKUs in the PlayStation Store database depending on your region. You must select your specific region in the setup in order to retrieve the cover art for such titles correctly. The integration will attempt to search other databases for the correct title if it cannot be found, although it will take longer to do so and may fetch an incorrect cover.