f56528ddcd
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>
89 lines
2.7 KiB
Markdown
89 lines
2.7 KiB
Markdown
# 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"
|
|
```
|