Skip to content

Migrating from V4 to V5

Version 5 introduces a few breaking changes. Not every change will require action from you.

First, identify your install method. Then, use the table below to determine if you need to take any special action. A ✔️ means there is something for you to do. Follow the hyperlink to see what steps to take.

Breaking Change Build From Source Docker Headless Docker WebUI GitHubAction Windows Exe
.NET 9 ✔️ ❌ ❌ ❌ ❌
DeviceInfoPath replaced by DeviceInfoSettings ✔️ ✔️ ❌ ✔️ ❌
Fixed Non-Root Docker ❌ ✔️ ✔️ ✔️ ❌

Breaking Changes

.NET 9

  1. Install the latest dotnet 9.0 SDK

DeviceInfoPath replaced by DeviceInfoSettings

If you have not configured or made use of the DeviceInfoPath setting then you do not need to make any changes.

If you are running P2G v4.2.0 or later then it is possible you have already made the needed changes as the new settings format was introduced with that version.

If you are running P2G in a way that allows it to persist its settings across restarts, then you should not need to do anything specific, P2G will automatically migrate the old DeviceInfoPath setting into the new DeviceInfoSettings format. For example if you are using the WebUI or the Windows Exe, then you likely do not need to do anything.

If you use GitHub Actions or if you are not persisting P2G settings across restarts then you will need to manually update your settings. If you have made use of the DeviceInfoPath setting then you will need to update it to follow the new format of DeviceInfoSettings.

The new settings structure is explained here.

Fixed Non-Root Docker

Previously running P2G as a rootless container did not quite work. Depending on how you worked around this in your personal setup you may encounter permission issues on the latest version of P2G.

If you encounter issues, start by trying the below steps:

  1. Ensure you have created a Group p2g with GroupId of 1015, see Docker User
  2. Ensure existing config and setting files are editable by the p2g Group
  3. Update your containers to run with user: :p2g. See docker-compose.yaml

GitHub Action Users

If you use GitHub Actions for running P2G then the fix for this has already been applied to the latest version of the workflow file. You can follow the normal Updating steps to get the latest version.