Slim CLAUDE.md from 65K to 21K by splitting app-specific docs

Move OpenClaw, Palmr, MinIO, JSX publishing, MCP configs, and migration candidates into dedicated docs/ files. Keep only DevOps-essential content inline (deployment rules, DNS, router, credentials, troubleshooting). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-21 02:56:08 +00:00
parent 6325e6f7e7
commit f56528ddcd
7 changed files with 939 additions and 1397 deletions
--- a/docs/minio.md
+++ b/docs/minio.md
@@ -0,0 +1,88 @@
+# MinIO Object Storage (Mac <-> NUC File Transfer)
+
+## Architecture
+
+MinIO runs on the NUC as S3-compatible object storage. Used for Mac backups, file transfers, and app storage.
+
+```
+Mac (mc CLI) → Tailscale → 100.113.153.45:9000 → port-fwd (socat) → minio-xwowg8kswwsocssgocs8ss40:9000
+```
+
+## Access
+
+| Property | Value |
+|----------|-------|
+| **API URL** | `http://100.113.153.45:9000` |
+| **Console URL** | `http://100.113.153.45:9001` |
+| **Access Key** | `minioadmin` |
+| **Secret Key** | `minioadmin` |
+| **Port Forwarder** | `minio-port-fwd` (socat, maps host :9000/:9001 → container) |
+| **Main Container** | `minio-xwowg8kswwsocssgocs8ss40` |
+
+## Buckets
+
+| Bucket | Purpose |
+|--------|---------|
+| `mac-backups` | Database dumps, tar archives, important backups |
+| `mac-downloads` | Files moved from ~/Downloads for archival |
+| `mac-projects` | Archived project files |
+| `nuc-portal-previews` | NUC Portal screenshot previews |
+| `whyrating` | WhyRating app assets |
+
+## Mac CLI (mc)
+
+Installed at `/opt/homebrew/bin/mc`, alias `nuc` pre-configured.
+
+```bash
+mc ls nuc/                              # List buckets
+mc cp file.tar nuc/mac-backups/         # Upload file
+mc cp nuc/mac-backups/file.tar ./       # Download file
+mc mirror ~/path/to/dir nuc/mac-projects/dirname/  # Sync directory
+mc du nuc/mac-backups                   # Check bucket size
+```
+
+## nuc-sync CLI Tool
+
+Wrapper script at `~/.local/bin/nuc-sync` for daily operations:
+
+```bash
+nuc-sync status                    # Check NUC + MinIO connectivity
+nuc-sync upload file.tar           # Upload to mac-backups bucket
+nuc-sync upload file.sql mac-downloads  # Upload to specific bucket
+nuc-sync push ~/Desktop/project    # rsync to NUC (excludes node_modules, .next, .git)
+nuc-sync pull /opt/backups/mac/x . # rsync from NUC
+nuc-sync list                      # List all buckets
+nuc-sync list mac-backups          # List bucket contents
+```
+
+## MinIO MCP Server
+
+MCP server for Claude Code integration: `minio-nuc`
+- **Source:** `~/mcp-servers/minio-mcp-server/`
+- **GitHub:** `https://github.com/Rafitis/minio-mcp-server`
+- **Scope:** user (available in all projects)
+- **Tools:** list buckets, upload/download objects, create/delete buckets
+
+## rsync Backup Directory
+
+```bash
+# NUC backup path (owned by alezmad)
+/opt/backups/mac/
+```
+
+## Troubleshooting
+
+1. **MinIO unreachable (connection refused)**: The port forwarder may be down:
+   ```bash
+   ssh nuc "docker start minio-port-fwd"
+   ```
+
+2. **mc alias not working**: Reconfigure:
+   ```bash
+   /opt/homebrew/bin/mc alias set nuc http://100.113.153.45:9000 minioadmin minioadmin
+   ```
+
+3. **Console not loading**: Port 9001 needs the port-fwd container running. Check with:
+   ```bash
+   ssh nuc "docker ps | grep minio-port-fwd"
+   ```