Release 4.0: Add FrankenPHP & more Laravel optmizations

docs/content/docs/2.getting-started/2.installation.md

@@ -13,6 +13,42 @@ layout: docs
 All images are hosted on [DockerHub](https://hub.docker.com/r/serversideup/php) and [GitHub Packages](https://github.com/serversideup/docker-php/pkgs/container/php)  for free. Containers default to running Debian, but Alpine images are also available.
 ::
 
+## What's Docker?
+[Docker](https://www.docker.com/) is an open source utility for building, shipping, and running applications in containers. Containers are isolated environments that can run on any host. 
+
+![Docker Layers with Laravel Application](/images/docs/docker-layers.png)
+
+### Why containerize with Docker?
+Going through the efforts of containerizing your application gives you one extremely powerful capability:
+
+👉 **You can run your application anywhere**
+
+Once you're at this level, you unlock a ton of new possibilities:
+
+- **Your application runs the same, everywhere** - no more "it works on my machine". Run 100% of your application on any operating system. All they need is Docker installed.
+- **Ship with more confidence** - all infrastructure configurations are *centrally managed* in Git, so you can change, test and rollback with ease
+- **No more vendor lock-in** - if a host raises their prices on you, you can migrate with very little effort
+- **Scaling is a breeze** - once you get your application in one container, it's so easy to scale up to any number of containers
+- **Improved security** - containerized apps are more secure than traditional apps because they are isolated from the host
+- **Better uptime** - if something fails during deployment, you can roll back your application to a previous version with ease
+
+The even crazier part is you don't need a Platform as a Service (PaaS) to get all these benefits. Everything can be done with 100% free and open source tools.
+
+## How to get started with Docker
+At first, Docker may seem a little intimidating, but don't let that stop you. Docker is one of the most powerful skill-sets that we've learned in our career.
+
+Although teaching you how to use Docker is beyond the scope of serversideup/php, we've actually created another open source project called [Spin](https://serversideup.net/open-source/spin/) that dramatically reduces the learning curve for getting started with Docker.
+
+Here's a quick demo of Spin of what an app looks like when we use Docker from development to production:
+
+::video-embed
+---
+src: https://www.youtube.com/watch?v=5z2JoEt5XIk
+---
+::
+
+[Learn more about Spin →](https://serversideup.net/open-source/spin/)
+
 ## Our most popular images
 All images are intelligently tagged with the PHP version and variation. This allows you to easily select the right image for your use case. 
 
@@ -42,15 +78,26 @@ The `fpm-apache` variation is meant for users who want to run something like Wor
 [Learn more about using Docker with WordPress →](/docs/guide/using-wordpress-with-docker)
 
 ### FPM-NGINX
-The `fpm-nginx` variation is great for people who want to run Laravel applications or similar. This allows you to serve static content quickly with NGINX but also pass PHP requests to PHP-FPM. Similar to PHP-Apache, there are two processes required to run this variation. We use S6 Overlay to ensure the container health is accurate.
+Over the last 15+ years `fpm-nginx` has been "the way" to run PHP web applications, including Laravel. Since around 2010, it's been adopted and trusted by some of the best PHP system administrators out there. As of 2025, we're starting to see other options like FrankenPHP push the industry forward, but `fpm-nginx` is very stable and still widely used today.
+
+The only caveat with running FPM + NGINX together with Docker is it requires two processes (which can lead to strange container behaviors). Thankfully, we took this all in mind with our design by using 's been trusted and deployed millions of times and there's a large adoption This allows you to serve static content quickly with NGINX but also pass PHP requests to PHP-FPM. Similar to PHP-Apache, there are two processes required to run this variation. We use S6 Overlay to ensure the container health is accurate.
 
 [Learn more about S6 Overlay →](/docs/guide/using-s6-overlay)
 
-### Unit
-The `unit` variation is for NGINX Unit, which is a modern approach to delivering containerized web applications. Instead of relying on the complexities of two processes running NGINX + PHP-FPM, Unit replaces both the NGINX Web Server and PHP-FPM to run everything under one process. Unit is open source and maintained by the NGINX Unit team. 
+### Unit (deprecated)
+::note
+In October 2025, NGINX stopped supporting NGINX Unit and archived the project. NGINX Unit will eventually be removed from our project. [See the official announcement →](https://github.com/nginx/unit?tab=readme-ov-file#nginx-unit)
+::
 
+The `unit` variation is for NGINX Unit, which is a NGINX's modern approach to delivering containerized web applications.
 [Learn more about Unit →](https://unit.nginx.org/)
 
+### FrankenPHP
+
+The `frankenphp` variation is a modern application server for PHP built on top of the Caddy web server. Instead of relying on the complexities of two processes running NGINX + PHP-FPM, FrankenPHP replaces both to run everything under one process. FrankenPHP supports worker mode for Laravel and Symfony applications, automatic HTTPS, and modern protocols like HTTP/2 and HTTP/3.
+
+[Learn more about FrankenPHP →](https://frankenphp.dev/)
+
 ## Selecting the version of PHP
 Selecting the best version of PHP is highly dependent on your use case. In a perfect world, running the latest version of PHP will give you the latest and greatest, but it all depends on the libraries that your application uses.