Dev Container – Local testing before deploy
This devcontainer runs PHP 7.4 + Nginx (Debian-based image so Cursor’s tooling has bash). Your src/ folder is mounted over the web root so edits are reflected immediately.
If “Reopen in Container” keeps failing (e.g. bash not found)
Cursor may be reusing an old container. Remove it and reopen:
- Reopen the folder locally (not in the container).
- In a terminal:
docker rm -f 2476c6abaac7 2>/dev/null; docker ps -a | grep -i umlaut
and remove any listed dev container for this project. - Reopen in Container again so a new container is created from the current image.
How to use
-
Open in Dev Container
Command Palette → “Dev Containers: Reopen in Container” (or use the prompt when opening the folder). -
Wait for the container to build and start
First time it builds the image; later opens are fast. -
Open the site in your browser
When the container is running, open http://localhost (port 80 is forwarded).- Main site:
http://localhost/ - Archive (e.g. 2004):
http://localhost/site_archive/2004/
- Main site:
-
Edit and test
Changes undersrc/are served immediately; refresh the browser to see them.
What’s supported
- HTML/CSS/JS – Served by Nginx with the existing cache rules.
- PHP – Handled by PHP 7.4-FPM (same as production), including legacy archive pages under
site_archive/.
The environment matches the production image; if it works here, it should behave the same when deployed.