summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorJoe Carstairs <me@joeac.net>2026-01-09 10:01:42 +0000
committerJoe Carstairs <me@joeac.net>2026-01-09 10:01:42 +0000
commitbeb9a2651267fc9feb25b62d9366963077135328 (patch)
treef988946bfceb632304fb0d6c0844348f80d59478 /README.md
parent00f793c53b1bcb0d88e8c97f2f64abc9809dfdfc (diff)
updates README with new Podman instructions
Diffstat (limited to 'README.md')
-rw-r--r--README.md28
1 files changed, 23 insertions, 5 deletions
diff --git a/README.md b/README.md
index ad5f064..650f9da 100644
--- a/README.md
+++ b/README.md
@@ -10,17 +10,35 @@ Structure:
└── infrastructure: The infrastructure of my website as code
```
-## Running
+## Running with Podman
-To run with Docker or Podman:
+These instructions will probably work with Docker, too: just substitute `podman`
+for `docker` in all the commands.
+
+To run with Podman, first set up your environment variables. Copy `example.env`
+to `.env` and edit the values accordingly.
+
+Then, create the `remote_smtp_password` secret, storing the password for the
+remote SMTP server which will send the contact emails on behalf of the website.
+
+```bash
+sudo podman secret create remote_smtp_password /path/to/remote/smtp/password
+```
+
+Now build and start the containers:
```bash
-docker build -t joeac-net .
-docker run joeac-net [port]:4321
+sudo podman-compose build && sudo podman-compose up -d
```
-To run with Node:
+## Running on the host machine
+
+To run on the host machine, first, as before, set up your environment variables
+by copying `example.env` to `.env` and editing the values as appropriate.
```bash
npm run start
```
+
+Note that emails may not work locally without further setup. These instructions
+are of course woefully incomplete.