folk.zone Wiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== Deployment Notes ======

This service is deployed on nitro (192.168.1.67) as part of the homelab Docker Compose stack.

**Container changes require full rebuild, not restart**

When making changes to webmention views, CSS, or configuration, you must rebuild the container entirely. A simple restart will not pick up the changes because the files are baked into the Docker image during the build process.

**Correct deployment sequence**

1. Sync local changes to server:
   ```bash
   rsync -avz -e "ssh -i ~/.ssh/id_ed25519_brennanbrown_ca" \
     server/webmention/ \
     brennan@192.168.1.67:/home/brennan/homelab/server/webmention/
   ```

2. Rebuild the container on server:
   ```bash
   ssh -i ~/.ssh/id_ed25519_brennanbrown_ca brennan@192.168.1.67 \
     "cd /home/brennan/homelab/server && docker compose up -d --build folkzone-webmention"
   ```

3. Test from external network (mobile hotspot/VPN) due to hairpin NAT limitations

**Important: hairpin NAT constraint**

You cannot test folk.zone URLs from your home network. The router does not support hairpin NAT. Always switch to mobile data or VPN when testing production URLs.

**Services**

- folkzone-webmention: Sinatra app (port 9019)
- folkzone-webmention-db: MariaDB 11
- folkzone-webmention-redis: Redis 7

**DNS**

webmention.folk.zone → 104.205.127.217 (managed at Porkbun)

**Caddy**

Caddy terminates TLS and reverse-proxies to the webmention container. The Caddyfile block is in server/caddy/Caddyfile.

===== See Also =====

* [[indieweb:start|Return to indieweb]]

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International