Initial commit - NUC server configuration and docs

- CLAUDE.md: Server instructions and service reference
- docs/: Persistent documentation (architecture, guides)
- .artifacts/: Session-generated notes
- playwriter-browser/: Remote browser container config

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Alejandro Gutiérrez
2026-02-01 20:49:20 +00:00
commit 390eda1595
25 changed files with 3664 additions and 0 deletions

72
NEXT_STEPS.md Normal file
View File

@@ -0,0 +1,72 @@
# Next Steps
## Immediate Tasks
### 1. Documentation Migration
- [ ] Create documentation structure in Outline (http://192.168.1.3:3080)
- [ ] Migrate guidelines from Homepage to Outline
- [ ] Remove guidelines from Homepage after migration
### 2. Cleanup
- [ ] Revoke duplicate "Claude MCP Server" API token in Coolify (Settings → Keys & Tokens → API Tokens)
## Configuration Tasks
### 3. Test Coolify MCP
- [ ] Start a Claude Code session from `~/Desktop/nuc`
- [ ] Verify Coolify MCP connects with the API token
- [ ] Test listing services, deployments, and servers
### 4. SSH Setup (if not done)
```bash
cd ~/Desktop/nuc
./setup-ssh.sh
```
## Future Improvements
### Infrastructure
- [ ] Configure Authentik as central identity provider
- [ ] Set up automated backups verification in Kopia
- [ ] Add more services to Uptime Kuma monitoring
- [ ] Configure ntfy notifications for critical alerts
### Security
- [ ] Enable HTTPS with Let's Encrypt certificates
- [ ] Set up Vaultwarden backup strategy
- [ ] Review and restrict Coolify API token IP allowlist
- [ ] Audit exposed ports and services
### Automation
- [ ] Create n8n workflows for common tasks
- [ ] Set up automated health checks
- [ ] Configure Coolify webhooks for deployment notifications
### Documentation
- [ ] Document backup/restore procedures in Outline
- [ ] Create runbooks for common incidents
- [ ] Document service dependencies and startup order
- [ ] Add network diagram to documentation
## Service-Specific Tasks
### Outline
- [ ] Configure S3 storage with MinIO for attachments
- [ ] Set up collections and permissions structure
- [ ] Import existing documentation
### Gitea
- [ ] Configure repository mirroring (if needed)
- [ ] Set up CI/CD with Gitea Actions
- [ ] Configure webhook integrations
### n8n
- [ ] Create workflow templates
- [ ] Set up credentials for external services
- [ ] Configure error notifications
## Notes
- Coolify API Token: Configured in `.claude/settings.json`
- All services accessible at `192.168.1.3` on their respective ports
- SSH access: `ssh nuc` (after running setup-ssh.sh)