Just updating the port inside the .env file is not enough

Author: ammar-madni

UPGRADE.md

@@ -330,22 +330,20 @@ node storage/ssr/ssr.js
 
 ### Optional: Update default HMR port when using Laravel Sail
 
-If you are using Laravel Sail, you must update the `HMR_PORT` in your `.env` file.
+If you are using Laravel Sail, you need to update the default `HMR_PORT` value and the port it maps to in your `docker-compose.yml` file.
 
 ```diff
-- HMR_PORT=8080
-+ HMR_PORT=5173
+- -'${HMR_PORT:-8080}:8080'
++ -'${HMR_PORT:-5173}:5173'
 ```
 
-Alternatively, you can set the default value in your `docker-compose.yml` file.
-
+If you are setting the HMR_PORT in your `.env` file you will also need to update it to match.
 
 ```diff
-- -'${HMR_PORT:-8080}:8080'
-+ -'${HMR_PORT:-5173}:5173'
+- HMR_PORT=8080
++ HMR_PORT=5173
 ```
 
-
 ### Wrapping up
 
 You should now be able to build your assets using `dev` command. This will also invoke the Vite server and Vite will watch for file changes: