Alejandro Gutiérrez 617f200310 Update CLAUDE.md with comprehensive NUC infrastructure docs
Expand from initial setup notes to full operational manual covering
OpenClaw gateway, Palmr file sharing, MinIO storage, Deepgram MCP,
Gitea auto-deploy workflows, Tailscale Funnel architecture, JSX
artifact publishing, and OpenWrt router management.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 15:16:55 +01:00
2026-02-01 21:06:42 +00:00

NUC Home Server

Personal home server running on Intel NUC at 192.168.1.3

Quick Access

Service URL Description
Homepage http://192.168.1.3:3000 Dashboard with all services
Coolify http://192.168.1.3:8000 Service deployment & management
Gitea http://192.168.1.3:3030 Git repository hosting
Outline http://192.168.1.3:3080 Documentation wiki (login via Gitea)
n8n http://192.168.1.3:5678 Workflow automation
Vaultwarden http://192.168.1.3:8222 Password manager (Bitwarden compatible)
Ntfy http://192.168.1.3:8333 Push notifications
Uptime Kuma http://192.168.1.3:3001 Service monitoring

SSH Access

# Connect to the server
ssh nuc

# Or explicitly
ssh alezmad@192.168.1.3

Make sure your SSH config includes:

Host nuc
    HostName 192.168.1.3
    User alezmad
    IdentityFile ~/.ssh/id_ed25519_nuc

Architecture

┌─────────────────────────────────────────────────────────────┐
│                        NUC Server                           │
│                      192.168.1.3                            │
├─────────────────────────────────────────────────────────────┤
│  Coolify (PaaS)                                             │
│  ├── Traefik (Reverse Proxy) :80/:443                       │
│  ├── Services:                                              │
│  │   ├── Homepage (Dashboard)                               │
│  │   ├── Gitea (Git + OAuth2 Provider)                      │
│  │   ├── Outline (Wiki/Docs)                                │
│  │   ├── n8n (Automation)                                   │
│  │   ├── Vaultwarden (Passwords)                            │
│  │   ├── Ntfy (Notifications)                               │
│  │   ├── MinIO (S3 Storage)                                 │
│  │   ├── FileBrowser                                        │
│  │   └── Authentik (Identity - partially configured)        │
│  └── Databases (PostgreSQL, Redis per service)              │
├─────────────────────────────────────────────────────────────┤
│  Standalone Containers:                                     │
│  ├── Uptime Kuma (Monitoring)                               │
│  ├── Dozzle (Log Viewer)                                    │
│  ├── Adminer (DB Admin)                                     │
│  └── Kopia (Backups)                                        │
└─────────────────────────────────────────────────────────────┘

Service Details

Coolify

  • URL: http://192.168.1.3:8000
  • Purpose: Self-hosted PaaS for deploying and managing all services
  • Login: Admin account configured during setup

Gitea

  • URL: http://192.168.1.3:3030
  • SSH: Port 22222
  • Purpose: Git repository hosting, also serves as OAuth2 provider for Outline
  • Admin: alezmad

Outline

  • URL: http://192.168.1.3:3080
  • Purpose: Team documentation and wiki
  • Auth: Login via Gitea (OIDC)
  • Note: Uses nginx proxy to strip HSTS headers

n8n

  • URL: http://192.168.1.3:5678
  • Purpose: Workflow automation (like Zapier)
  • Runners: Has dedicated task runners container

Vaultwarden

  • URL: http://192.168.1.3:8222
  • Purpose: Self-hosted Bitwarden-compatible password manager
  • Clients: Use any Bitwarden client, point to this URL

Ntfy

  • URL: http://192.168.1.3:8333
  • Purpose: Push notifications to mobile/desktop
  • Mobile App: Available on F-Droid and Play Store

MinIO

Monitoring & Tools

Common Tasks

View Service Logs

ssh nuc "docker logs <container_name> -f --tail 100"

Restart a Service

ssh nuc "docker restart <container_name>"

Check All Services

ssh nuc "docker ps --format 'table {{.Names}}\t{{.Status}}'"

Backup Consideration

Troubleshooting

Service Not Accessible

  1. Check if container is running: ssh nuc "docker ps | grep <service>"
  2. Check logs: ssh nuc "docker logs <container> --tail 50"
  3. Check port forwarding container if applicable

After Coolify Redeploy

Containers may be in "Created" state. Start manually:

ssh nuc "docker start <container_name>"

HTTPS/SSL Issues

Some browsers cache HSTS. Clear at chrome://net-internals/#hsts

Files in This Directory

  • CLAUDE.md - Instructions for Claude Code AI assistant
  • README.md - This file (human documentation)
  • .claude/settings.json - MCP server configuration for Claude Code
Description
NUC server configuration, documentation, and scripts
Readme 490 KiB
Languages
TypeScript 87.2%
Python 10%
CSS 1.2%
Shell 0.9%
Dockerfile 0.5%
Other 0.2%