ginnoir
20165f48a0
Every service now has an explicit container_name, eliminating the htpc-download-box_ prefix/suffix that compose derived from the directory. Disambiguated duplicates follow type_context naming: postgres_resume / postgres_famapp / postgres_authentik minio_resume / minio_famapp redis_authentik Also updates CLAUDE.md and the homelab-ssh skill to reflect: - compose v2 (docker compose, space) replacing the old v1.27.4 standalone - dc alias updated to docker compose - htpc-download-box directory is now clean (legacy cruft removed) Server-side migration steps (docker-compose-plugin apt install, alias update, Docker Engine upgrade, old binary removal) are documented in the session but not yet applied — run apply-compose.ps1 -Compose after completing them.
52 lines
2.4 KiB
Markdown
52 lines
2.4 KiB
Markdown
---
|
|
name: homelab-ssh
|
|
description: Connect to and run commands on the valhalla homelab server (ginnoir@valhalla) over SSH, including docker-compose operations through the `dc` alias. Use when inspecting the live stack, tailing logs, restarting a service, reloading Caddy, or checking container/file state on the server.
|
|
---
|
|
|
|
# homelab-ssh
|
|
|
|
The production homelab runs on a headless Ubuntu host reachable at `ssh ginnoir@valhalla` (key-based auth; resolves and works from this Windows host directly).
|
|
|
|
## Connect (non-interactive / safe for automation)
|
|
|
|
Always pass `-o BatchMode=yes` so a missing key or password prompt fails fast instead of hanging:
|
|
|
|
```powershell
|
|
ssh -o BatchMode=yes -o ConnectTimeout=8 ginnoir@valhalla "<command>"
|
|
```
|
|
|
|
The first `Bash` command of a session is gated by a GateGuard hook — state the user request + what the command does, then retry.
|
|
|
|
## docker-compose via the `dc` alias
|
|
|
|
The stack uses Docker Compose v2 (`docker compose` plugin, installed via apt). On the server, `dc` is aliased in `~/.bashrc` to:
|
|
|
|
```
|
|
docker compose -f ~/htpc-download-box/docker-compose.yml --env-file ~/htpc-download-box/.env
|
|
```
|
|
|
|
It's a shell alias, so it only exists in an interactive shell. Invoke it with `bash -ic`:
|
|
|
|
```powershell
|
|
ssh ginnoir@valhalla "bash -ic 'dc ps'"
|
|
ssh ginnoir@valhalla "bash -ic 'dc logs -f --tail=200 <service>'"
|
|
ssh ginnoir@valhalla "bash -ic 'dc restart <service>'"
|
|
ssh ginnoir@valhalla "bash -ic 'dc up -d'"
|
|
ssh ginnoir@valhalla "bash -ic 'dc exec caddy caddy reload --config /etc/caddy/Caddyfile'"
|
|
```
|
|
|
|
Use the compose **service name** (`sonarr`, `caddy`, `app`, …). Without `bash -ic`, `dc` is "command not found".
|
|
|
|
## Key paths on the server
|
|
|
|
- `~/htpc-download-box/docker-compose.yml`, `~/htpc-download-box/.env` — stack definition
|
|
- `/config/caddy/Caddyfile` — Caddy config (mounted into the `caddy` container at `/etc/caddy/Caddyfile`)
|
|
- `/config/<service>/` — per-service persisted config; `/storage1/` — media & data; plus named Docker volumes
|
|
- `~/htpc-download-box/` contains only `docker-compose.yml` and `.env` — the legacy cruft has been cleaned out
|
|
|
|
## Notes
|
|
|
|
- Read-only exploration of `/config`, `/storage1`, and container state is fine for answering questions.
|
|
- Avoid destructive commands against the live stack without explicit confirmation.
|
|
- To push config changes and apply them, use the `homelab-apply` skill; to pull prod config into the repo, use `homelab-sync`.
|