37 lines
1.5 KiB
Markdown
37 lines
1.5 KiB
Markdown
# 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:
|
||
|
||
1. **Reopen the folder locally** (not in the container).
|
||
2. 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.
|
||
3. **Reopen in Container** again so a new container is created from the current image.
|
||
|
||
## How to use
|
||
|
||
1. **Open in Dev Container**
|
||
Command Palette → **“Dev Containers: Reopen in Container”** (or use the prompt when opening the folder).
|
||
|
||
2. **Wait for the container to build and start**
|
||
First time it builds the image; later opens are fast.
|
||
|
||
3. **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/`
|
||
|
||
4. **Edit and test**
|
||
Changes under `src/` 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.
|