Self-Hosting
About Self-hosting PWA#
So that clients can have a more native app-like experience on mobile, P-Stream has a function to support Progressive Web Apps (PWA). You can learn more about what a PWA is here.
In P-Stream version 3, PWAs were enabled by default. Unfortunately, PWAs tend to come with caching complications that can be tricky to resolve. That's why we have disabled PWAs by default in P-Stream version 4. If you are upgrading from version 3, please read our upgrade guide for more information.
Enabling PWAs means that you cannot disable it again - Please only proceed if you know what you are doing!
If you are running P-Stream on a hosting platform such as Vercel#
If your hosting is building P-Stream from the source, you can enable PWAs using the VITE_PWA_ENABLED environment variable.
Setting VITE_PWA_ENABLED to true will generate a service worker file and a web app manifest which enable the website to be installed from a web browser both on Desktop and on Mobile.
If you are running P-Stream using the .zip files#
If you are downloading the P-Stream zip files from our GitHub and installing them on a static website host, then all you need to do is to make sure to download the P-Stream.pwa.zip file instead of the P-Stream.zip file!