Set Up Your First NAS (/first-run)
v1.0
·
Updated 4 days ago
Set Up Your First NAS: /first-run
When your workspace is still empty, start with /first-run. The command runs entirely in the main context (no sub-agent) and guides you step by step through setting up your first NAS — in about two minutes.
What it asks
| Field | Description |
|---|---|
| LAN host | hostname or IP address on the local network |
| WAN host | optional external domain (leave blank to skip) |
| SSH port | 1–65535 (default 22) |
| SSH user | the login user on the NAS |
Each input is validated (host ^[a-zA-Z0-9.-]+$, port 1–65535, user ^[a-zA-Z0-9_.-]+$) and re-asked on error.
What happens automatically afterwards
- The dedicated SSH key is generated and the deployment is walked through (see "SSH Key & Diagnostics").
- Hardware and software are discovered over SSH: DSM version (
/etc/VERSION), model, architecture, CPU, RAM, disk usage (df -h), RAID status (/proc/mdstat), shares on/volume1, Docker availability and passwordless sudo. - You set the authorized operation categories (multi-select, see "Scopes & Confirmations").
- The NAS profile is written to
context/nas/<slug>/profile.md(theslugis derived from the hostname), set as the active NAS, and theCLAUDE.mdQuick Reference is updated.
Profile writes are atomic (write to a temp file, then mv) — an abort mid-write never leaves a half-populated profile. Any existing single-NAS legacy layout is migrated once and losslessly to the multi-NAS layout on the first run.
You can add more NAS any time later with /nas-add.