Differences

This shows you the differences between two versions of the page.

--- guides:add_new_service [2026/10/07 05:48] – created - external edit 127.0.0.1
+++ guides:add_new_service [2026/10/23 15:48] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Adding a New Service to the Homelab ======
-A repeatable checklist for deploying a new self-hosted service on nitro.
+A repeatable checklist for deploying a new self-hosted service on the folk.zone server (casa).
 ===== Prerequisites =====
@@ Line 14: / Line 14: @@
 The single stack lives at ''server/docker-compose.yml'' (deployed at
-''/home/brennan/homelab/server/'' on nitro):
+''~/homelab/server/'' on the server host):
 <code yaml>
@@ Line 45: / Line 45: @@
 </code>
-==== 3. Add DNS record ====
+==== 3. DNS ====
-folk.zone DNS is managed at **Porkbun** — add an A record for the subdomain
+No per-service DNS step is needed: ''*.folk.zone'' is a wildcard A record at
-pointing to the public IP (''104.205.127.217''). No Cloudflare Tunnel step;
+**Porkbun** pointing at the public IP. Caddy issues a Let's Encrypt
-Caddy handles TLS via Let's Encrypt automatically once DNS resolves.
+certificate automatically on first request.
 ==== 4. Deploy ====
 <code bash>
-cd /home/brennan/homelab/server
+cd ~/homelab/server
 docker compose up -d service-name
 docker exec folkzone-caddy caddy reload --config /etc/caddy/Caddyfile
 </code>
+Note: if the Caddyfile was replaced by rsync, the inode changed and ''caddy reload''
+sees no diff. Use ''docker compose restart caddy'' instead. See
+[[folkzone:troubleshooting:caddy_autosave_not_loading_config|Caddy Autosave Not Loading Config]].
 ==== 5. Add to status page ====
-''status.folk.zone'' is a custom dashboard — add the service to its config in
+''status.folk.zone'' is a custom dashboard: add the service to its config in
 ''server/status/''.
@@ Line 71: / Line 75: @@
 ==== 7. Add a wiki page ====
-Create '':folkzone:services:service-name'' following the [[meta:start|service page template]].
+Create '':folkzone:services:service-name'' following an existing page such as
+[[folkzone:services:ethercalc|EtherCalc]].
 ===== See Also =====
   * [[guides:start|Guides Index]]
   * [[folkzone:services:caddy|Caddy]]
+  * [[start|Return to wiki home]]
-Last updated: 2026-10-07
+Last updated: 2026-10-23