add warning about frankenphp

Author: ildyria

docs/faq_troubleshooting.md

@@ -4,6 +4,10 @@ If Lychee is not working properly, try to open `https://lychee.example.com/Diagn
 
 Another way to see this screen is to use the command: `php artisan lychee:diagnostics`
 
+### When I update my .env with Lychee v7, the changes are not taken into account, what can I do?
+
+Lychee v7 with FrankenPHP requires a container restart to take into account changes made to the `.env` file.
+
 ### When I do X, I get an error API not found, what can I do?
 
 Open the dev modules of your browser (usually by pressing `F12`) and open the Network tab.

docs/upgrade.md

@@ -13,6 +13,9 @@ Version 7 marks a fundamental shift in Lychee's Docker architecture:
 3. **Optional worker service**: Background job processing can now be scaled independently
 4. **New environment variables**: Worker mode configuration requires specific settings
 
+Do note that this change also has consequences in the way Lychee reads your `.env`
+file. Updating values in the `.env` file will now require a container restart to take effect.
+
 ### Volume Mount Changes
 
 #### Version 6 Volume Structure (OLD)

src/content/post/2025-12-31-version-7.mdx

@@ -23,14 +23,15 @@ Security remained a priority with multiple SSRF vulnerability fixes, ensuring yo
 
 ### Version 7: Our Most Ambitious Release Yet
 
-Version 7 marks a major architectural shift for Lychee. Our Docker release is now powered by FrankenPHP with Laravel Octane instead of the traditional nginx + PHP-FPM stack. This infrastructure keeps the framework in memory and reuses components across requests, eliminating the overhead of rebuilding the entire application on every page load. As a result, boot time drops from 40-60ms to just 4-6ms per request, with 3-4x better throughput and significantly reduced latency.
+Version 7 marks a major architectural shift for Lychee. Our Docker release is now powered by FrankenPHP with Laravel Octane instead of the traditional nginx + PHP-FPM stack. This infrastructure keeps the framework in memory and reuses components across requests, eliminating the overhead of rebuilding the entire application on every page load. As a result, boot time drops from 40-60ms to just 4-6ms per request, with 3-4x better throughput and significantly reduced latency. In May 2025, FrankenPHP gained official support from the PHP Foundation, cementing its position as the future of high-performance PHP applications.
 
-In May 2025, FrankenPHP gained official support from the PHP Foundation, cementing its position as the future of high-performance PHP applications.
-
-The new FrankenPHP-powered Docker image is available at `ghcr.io/lycheeorg/lychee:edge` and will become the default once version 7 is fully stable.
+The new FrankenPHP-powered Docker image is available at `ghcr.io/lycheeorg/lychee` and will become the default once version 7 is fully stable.
 
 This architectural change means you will need to update your Docker setup when upgrading from version 6 to version 7 with FrankenPHP. Please refer to our [upgrade documentation](https://lycheeorg.github.io/docs/upgrade.html) for detailed instructions.
 
+Do note that this change also has consequences in the way Lychee reads your `.env`
+file. Updating values in the `.env` file will now require a container restart to take effect.
+
 #### Performance Revolution
 
 In addition to changing the PHP engine, we've implemented several key performance optimizations: