Files

Alejandro Gutiérrez f56528ddcd 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

2.7 KiB

Raw Permalink Blame History

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.

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:

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

# NUC backup path (owned by alezmad)
/opt/backups/mac/

Troubleshooting

MinIO unreachable (connection refused): The port forwarder may be down:
```
ssh nuc "docker start minio-port-fwd"
```

mc alias not working: Reconfigure:

/opt/homebrew/bin/mc alias set nuc http://100.113.153.45:9000 minioadmin minioadmin

Console not loading: Port 9001 needs the port-fwd container running. Check with:
```
ssh nuc "docker ps | grep minio-port-fwd"
```

2.7 KiB Raw Permalink Blame History