ok... ok... I'll add it to git...

2025-11-14 15:31:25 +01:00
commit 664fe55ff4
106 changed files with 24602 additions and 0 deletions
@@ -0,0 +1,102 @@
+# Changelog
+
+All notable changes to the tower-of-joy project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Planned
+- NVIDIA Container Toolkit installation
+- Portainer deployment
+- Nginx Proxy Manager deployment
+- Ollama ML infrastructure
+- Headscale secure networking
+- Monitoring stack (Uptime Kuma, Netdata, Heimdall)
+
+## [0.1.0-planning] - 2025-11-11
+
+### Added
+- Initial project structure and documentation
+- Comprehensive research document (containers/research.md)
+  - Evaluated 8 different home server solutions
+  - Identified Portainer + Docker Compose as optimal choice
+  - Researched SDN solutions (Headscale vs Tailscale)
+- Detailed implementation plan (containers/implementation-plan.md)
+  - 4-phase deployment strategy
+  - Phase 1: Foundation (Portainer, NPM, Ollama, storage)
+  - Phase 2: Networking (Headscale)
+  - Phase 3: Monitoring (Uptime Kuma, Netdata, Heimdall)
+  - Phase 4: Optimization (Watchtower, backups, security)
+  - Application backlog (Jellyfin, Nextcloud, Samba)
+- System documentation (SYSTEM.md)
+  - Hardware specifications
+  - Dual-disk storage configuration
+  - Software inventory
+- Agent guidelines (AGENTS.md)
+  - Project-specific conventions
+  - Docker Compose standards
+  - GPU service requirements
+  - Testing procedures
+  - Commit message format
+- Project status tracking (STATUS.md)
+- Version-controlled infrastructure (stacks/ directory)
+- Maintenance automation (scripts/ directory, Makefile)
+
+### Documented
+- Storage architecture: SSD (489GB) for configs, HDD (3.7TB) for content
+- Port allocation strategy
+- AMP game server integration approach
+- GPU passthrough requirements for Jellyfin and Ollama
+- Security considerations (Headscale, UFW, credentials management)
+
+### Decisions
+- **Architecture:** Portainer + Docker Compose (chosen over TrueNAS Scale, Unraid, Proxmox)
+  - Reason: No OS reinstall required, leverages existing Docker, minimal storage footprint
+- **Reverse Proxy:** Nginx Proxy Manager on port 8000 (unified web interface)
+- **SDN:** Headscale (self-hosted Tailscale control server)
+- **ML Infrastructure:** Ollama with GPU support (RTX 2080 Ti)
+- **Monitoring:** Uptime Kuma + Netdata + Heimdall
+- **Storage Strategy:** Dual-disk approach (SSD for performance, HDD for capacity)
+
+---
+
+## Changelog Guidelines
+
+### Categories
+Use these categories for changes:
+- **Added** - New features, services, or capabilities
+- **Changed** - Changes to existing functionality
+- **Deprecated** - Soon-to-be-removed features
+- **Removed** - Removed features
+- **Fixed** - Bug fixes
+- **Security** - Security improvements
+
+### Version Numbering
+- **Major (X.0.0)**: Breaking changes, major architecture changes
+- **Minor (0.X.0)**: New features, service additions, phase completions
+- **Patch (0.0.X)**: Bug fixes, configuration tweaks, documentation updates
+- **Suffix**: `-planning`, `-alpha`, `-beta` for pre-release stages
+
+### Example Entry Template
+```markdown
+## [X.Y.Z] - YYYY-MM-DD
+
+### Added
+- feat(stack): deployed nginx proxy manager for unified web interface
+- feat(ollama): configured GPU passthrough for ML model inference
+
+### Changed
+- config(amp): moved from port 8080 to 8081 to avoid conflicts
+
+### Fixed
+- fix(storage): corrected permissions on media drive mount
+
+### Security
+- chore(firewall): configured UFW rules for service isolation
+```
+
+---
+
+*This changelog will be updated as phases are completed*