No description
Find a file
2025-02-03 23:43:20 +10:30
docs Update services list 2025-02-03 00:40:20 +10:30
.gitignore Remove htpasswd file from VCS 2025-02-03 00:27:59 +10:30
Dockerfile Bind mount the html files so they can be updated without stopping the server 2025-02-03 23:26:39 +10:30
mkdocs.yml Use RTD theme 2025-02-01 03:20:00 +10:30
nginx.conf Add server 2025-02-03 00:26:07 +10:30
passwd.sh Update password instructions 2025-02-03 00:29:54 +10:30
README.md Update build instructions 2025-02-03 23:43:20 +10:30
redeploy.sh Bind mount the html files so they can be updated without stopping the server 2025-02-03 23:26:39 +10:30

Notes server

Set up mkdocs and build HTML

# Set up a Python virtualenv for mkdocs.
sudo apt install virtualenv
virtualenv .venv
. .venv/bin/activate

# Install mkdocs.
pip install mkdocs

# Build the HTML.
mkdocs build
```

## Build and run server

```bash
# Set access credentials.
./passwd.sh username password

# Build/rebuild the image.
docker build --no-cache -t notes-server .

# Run the image, listening on port 42069.
docker run --mount type=bind,src=./site,dst=/usr/share/nginx/html -p 42069:80 -t notes-server

Auth credentials setup

# Overwrite the htpasswd file with new user credentials.
# (Rebuild the image to copy the new credentials.)
./passwd.sh username password