60 lines
2.7 KiB
Markdown
60 lines
2.7 KiB
Markdown
|
# NixOS Infrastructure with AI Assistant
|
||
|
|
|
||
|
|
## What This Is
|
||
|
|
|
||
|
|
This project manages a NixOS-based infrastructure with Docker services, integrated with OpenCode AI assistant for automated management. The system supports:
|
||
|
|
|
||
|
|
- Reproducible NixOS infrastructure configuration
|
||
|
|
- Docker service management via Docker Compose
|
||
|
|
- AI-assisted infrastructure operations
|
||
|
|
- Automatic service deployment and lifecycle management
|
||
|
|
- Integration with existing Docker stacks (ai, cloudstorage, homeautomation, network, passwordmanager, versioncontrol)
|
||
|
|
|
||
|
|
## Core Value
|
||
|
|
|
||
|
|
The core value is a **reproducible and evolvable NixOS infrastructure** that can be managed through natural language interactions with the OpenCode AI assistant. The system should automatically detect and integrate new Docker services while maintaining consistency across all deployments.
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
### Validated
|
||
|
|
|
||
|
|
- NixOS configuration management with flakes
|
||
|
|
- Docker service integration via docker_manager.nix
|
||
|
|
- Traefik reverse proxy with automatic TLS certificates
|
||
|
|
- Environment variable management via agenix secrets
|
||
|
|
- Standardized service patterns across all Docker stacks
|
||
|
|
|
||
|
|
### Active
|
||
|
|
|
||
|
|
- [ ] Automatic detection and integration of new Docker Compose files in `assets/compose/`
|
||
|
|
- [ ] AI assistant integration for service lifecycle management
|
||
|
|
- [ ] Service health monitoring and logging verification
|
||
|
|
- [ ] Documentation of integration patterns in SKILL.md
|
||
|
|
- [ ] Automated system update workflow (`nh os switch`)
|
||
|
|
|
||
|
|
### Out of Scope
|
||
|
|
|
||
|
|
- Full n8n integration for automated workflows - deferring to future milestone
|
||
|
|
- Self-healing infrastructure with automatic problem detection - future enhancement
|
||
|
|
- Multi-host orchestration - single-host focus for v1
|
||
|
|
|
||
|
|
## Key Decisions
|
||
|
|
|
||
|
|
| Decision | Rationale | Outcome |
|
||
|
|
|----------|-----------|---------|
|
||
|
|
| NixOS with Flakes | Reproducible infrastructure, better dependency management | Good |
|
||
|
|
| Docker Compose integration | Preserves existing service configurations, flexibility | Good |
|
||
|
|
| agenix for secrets | Secure secrets management, Nix native integration | Good |
|
||
|
|
| Traefik reverse proxy | Unified HTTPS entrypoint, automatic certificate management | Good |
|
||
|
|
| Standardized service patterns | Consistency across services, easier maintenance | Pending |
|
||
|
|
|
||
|
|
## Context
|
||
|
|
|
||
|
|
- **Existing Services**: ai (Llama.cpp, Open WebUI, n8n), cloudstorage (Nextcloud), homeautomation (Home Assistant), network (Traefik, DDNS), passwordmanager (Vaultwarden), versioncontrol (Gitea)
|
||
|
|
- **Tech Stack**: NixOS unstable, Docker, Docker Compose, Traefik, agenix, OpenCode AI
|
||
|
|
- **Hardware**: AMD MI50 GPUs for AI workloads
|
||
|
|
- **Network**: Traefik-net bridge network for all services
|
||
|
|
- **Storage**: `/mnt/HoardingCow_docker_data/<service>` for persistent data
|
||
|
|
|
||
|
|
**Last updated: 2026-01-01 after init**
|