mirror of
https://github.com/p-stream/docs.git
synced 2026-01-11 20:10:34 +00:00
24 lines
2 KiB
Text
24 lines
2 KiB
Text
---
|
|
title: 'PWA vs no-PWA'
|
|
---
|
|
|
|
# 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](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/What_is_a_progressive_web_app).
|
|
|
|
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](../client/upgrade.mdx) for more information.
|
|
|
|
<Warning>
|
|
Enabling PWAs means that you cannot disable it again - Please only proceed if
|
|
you know what you are doing!
|
|
</Warning>
|
|
|
|
## 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`](../client/configuration.mdx#vite-pwa-enabled) environment variable.
|
|
|
|
Setting [`VITE_PWA_ENABLED`](../client/configuration.mdx#vite-pwa-enabled) to `true` will generate a [service worker file](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable#service_worker) and a [web app manifest](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable#the_web_app_manifest) which enable the website to be installed from a [web browser both on Desktop and on Mobile](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable#installation_from_the_web).
|
|
|
|
## 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`](https://github.com/p-stream/p-stream/releases/latest/download/P-Stream.pwa.zip) file instead of the `P-Stream.zip` file!
|