Initial Hello World site
This commit is contained in:
72
README.md
Normal file
72
README.md
Normal file
@@ -0,0 +1,72 @@
|
||||
# www.kenjim.com
|
||||
|
||||
Static website served via nginx Docker container on zet.home.arpa, proxied through nginx SSL termination at `https://www.kenjim.com`.
|
||||
|
||||
## Development Workflow
|
||||
|
||||
Edit on Mac → push to Gitea → pull on zet → site updates live.
|
||||
|
||||
```
|
||||
Mac Gitea (git.kenjim.com) zet.home.arpa
|
||||
│ git push │ │
|
||||
├─────────────────────────────────►│ │
|
||||
│ │ git pull │
|
||||
│ ├───────────────────────────►│
|
||||
│ │ │ docker compose up -d
|
||||
```
|
||||
|
||||
## Structure
|
||||
|
||||
```
|
||||
www.kenjim.com/
|
||||
├── docker-compose.yml # runs nginx:alpine on host port 8080
|
||||
└── html/ # web root — edit files here
|
||||
└── index.html
|
||||
```
|
||||
|
||||
All files under `html/` are served directly. No build step required for static content.
|
||||
|
||||
## Running on zet
|
||||
|
||||
```bash
|
||||
cd ~/workspace/src/personal/www.kenjim.com
|
||||
|
||||
docker compose up -d # start
|
||||
docker compose down # stop
|
||||
docker compose logs -f # watch logs
|
||||
```
|
||||
|
||||
## Deploying Changes
|
||||
|
||||
On zet after pushing from Mac:
|
||||
|
||||
```bash
|
||||
cd ~/workspace/src/personal/www.kenjim.com
|
||||
git pull
|
||||
# nginx:alpine picks up file changes immediately via volume mount — no restart needed
|
||||
```
|
||||
|
||||
If `docker-compose.yml` itself changes, recreate the container:
|
||||
|
||||
```bash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
## How It Connects to nginx
|
||||
|
||||
The container listens on host port `8080`. The nginx reverse proxy on zet routes `https://www.kenjim.com` → `http://127.0.0.1:8080`.
|
||||
|
||||
See `~/workspace/src/personal/appa-net/zet.home.arpa/nginx/kenjim.conf` for the nginx config.
|
||||
|
||||
## Mac Setup (first time)
|
||||
|
||||
```bash
|
||||
# Clone the repo on your Mac
|
||||
git clone http://kenjim@git.kenjim.com/kenjim/www.kenjim.com.git
|
||||
cd www.kenjim.com
|
||||
|
||||
# Edit html/ files, then:
|
||||
git add .
|
||||
git commit -m "your message"
|
||||
git push
|
||||
```
|
||||
Reference in New Issue
Block a user