chore(deploy): adjust local user permissions and Caddy routing blocks

compose.local.yml

@@ -6,3 +6,11 @@ services:
     ports: !override
       - "8080:80"
     environment: !reset {}
+
+  # Local PEM files are commonly mode 0600 and owned by the host user.
+  # Production keeps the backend non-root and uses keys owned by UID 10001.
+  backend:
+    user: "0:0"
+
+  migrate:
+    user: "0:0"

compose.production.yml

@@ -42,6 +42,7 @@ services:
       start_period: 20s
     networks:
       - private
+      - egress
 
   migrate:
     build:
@@ -85,3 +86,4 @@ networks:
   public:
   private:
     internal: true
+  egress:

deploy/README.md

@@ -1,8 +1,9 @@
 # Production deployment
 
 This stack exposes only Caddy on ports 80 and 443. PostgreSQL and the FastAPI backend
-are isolated in the private Docker network. Caddy serves the Vite SPA and proxies public
+share an internal Docker network. The backend additionally uses a non-published egress
-`/api/*` requests to the backend after removing the `/api` prefix.
+network for DNS and outbound requests to Pally and Remnawave. Caddy serves the Vite SPA and
+proxies public `/api/*` requests to the backend after removing the `/api` prefix.
 
 ## First deployment
 
@@ -55,7 +56,9 @@ serves HTTP on `http://localhost:8080`. It does not need a domain, TLS certifica
 1. Create a local `.env` from `.env.example` and fill the required backend integration
    settings. `POSTGRES_HOST=postgres`, `PRIVATE_KEY_FP=/run/secrets/keys/private.pem`, and
    `PUBLIC_KEY_FP=/run/secrets/keys/public.pem` must remain unchanged. The local `keys/`
-   directory must contain both PEM files.
+   directory must contain both PEM files. The local Compose override runs backend commands as
+   root only to read host-owned PEM files with mode `0600`; this override must not be used in
+   production.
 2. Start PostgreSQL and apply migrations:
 
    ```bash

deploy/caddy/Caddyfile

@@ -20,7 +20,8 @@ malenia.space {
 	}
 
 	@api path /api/*
-	route @api {
+	handle @api {
+		route {
 			rate_limit {
 			zone auth {
 				match {
@@ -63,8 +64,11 @@ malenia.space {
 			uri strip_prefix /api
 			reverse_proxy backend:8000
 		}
+	}
 
+	handle {
 		root * /srv
 		try_files {path} /index.html
 		file_server
+	}
 }

deploy/caddy/Caddyfile.local

@@ -11,7 +11,8 @@
 	}
 
 	@api path /api/*
-	route @api {
+	handle @api {
+		route {
 			rate_limit {
 				zone auth {
 					match {
@@ -50,8 +51,11 @@
 			uri strip_prefix /api
 			reverse_proxy backend:8000
 		}
+	}
 
+	handle {
 		root * /srv
 		try_files {path} /index.html
 		file_server
+	}
 }