netstack

Site Template

Copy this folder into a new site repo (e.g. xx.2cld.net) and fill in the blanks. Replace xx with your site code, SITENAME with the location name, and update all placeholder values.

Site repo structure

docs/
  README.md          # site overview (copy from template-site-readme.md)
  devices.md         # device inventory (copy from template-devices.md)
  services.md        # running services (copy from template-services.md)
  tunnels.md         # cloudflare tunnels (copy from template-tunnels.md)
  storage.md         # NAS and plex mappings (copy from template-storage.md)
  ops/
    backup.md        # site-specific backup (copy from template-ops-backup.md)
    notes.md         # maintenance log (copy from template-ops-notes.md)

After creating the site repo

  1. Copy template files into docs/ in the new repo
  2. Fill in site-specific values (IPs, MACs, services)
  3. Enable GitHub Pages on the repo
  4. Add CNAME file with xx.2cld.net
  5. Add DNS record pointing to GitHub Pages
  6. Add the site to netstack deployments

Linking back to netstack

Each site repo should reference netstack for architecture and install guides rather than duplicating them. Use links like: