# 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"
   ```