Inanis_Vault/21-Server Reference/CLAUDE.md

Server Reference — Claude Instructions

This directory is living documentation for a two-server home infrastructure. Your job is to keep it accurate as things change.

The Servers

• Homelab — Primary server. SSH hostname: homelab. Dockhand API: ?env=1
• Raspberry Pi — Secondary server. SSH hostname: raspi. Dockhand API: ?env=2

How to Pull Data

Read AI-UPDATE-INSTRUCTIONS.md in this directory. It has every API endpoint, SSH command, and a step-by-step update checklist. Always start there.

Ground Rules

• Read before you write. Always read the relevant doc file before comparing it to live data. Never overwrite blindly.
• Credentials live in credentials.gpg — AES256 GPG symmetric. Do not write credentials in plaintext anywhere in this directory.
• Compose files contain redacted secrets — use <redacted> as a placeholder for any passwords, tokens, or keys in compose blocks.
• This is a personal vault — be direct, no fluff. Documentation should be useful to a new admin, not padded.

File Structure

21-Server Reference/
├── CLAUDE.md                   ← You are here
├── README.md                   ← Root index
├── AI-UPDATE-INSTRUCTIONS.md   ← How to pull data and update docs
├── credentials.gpg             ← Encrypted credentials
├── homelab/                    ← Primary server docs
│   ├── README.md
│   ├── hardware.md
│   ├── network.md
│   ├── environments.md
│   └── stacks/                 ← One file per Docker stack
└── pihole/                     ← Raspberry Pi docs
    ├── README.md
    └── stacks/

When Asked to Update

1. Read AI-UPDATE-INSTRUCTIONS.md
2. Read the existing doc files that are relevant
3. Pull live data from Dockhand API (or SSH if needed)
4. Update only what changed — don't rewrite sections that are still accurate