Version: v0.1.0 • Core Platform Established
An Enterprise-Grade Self-Hosted Engineering Platform
"Build it like production. Document it like open source. Improve it continuously."
Project Grundy is a production-inspired engineering platform built to design, deploy, operate, and document modern infrastructure using industry best practices.
The platform serves as a centralized environment for software development, infrastructure engineering, DevOps, automation, observability, AI experimentation, and self-hosted services. Every component is deployed with reliability, security, repeatability, and maintainability as core design principles.
Unlike a traditional homelab, Project Grundy is treated as a continuously evolving engineering platform where every service is documented, monitored, version-controlled, and managed as though it were running in production.
To build an enterprise-grade engineering platform that enables continuous learning, experimentation, and operational excellence while demonstrating modern infrastructure engineering practices.
Project Grundy is intended to become a complete self-hosted platform capable of supporting software engineering, infrastructure automation, private cloud services, AI workloads, media services, knowledge management, and disaster recovery.
- System architecture
- Home and project overview
- Network architecture
- Storage architecture
- Proxmox
- Ubuntu
- TrueNAS
- Docker
- Networking
- Drive qualification
- UPS graceful shutdown runbook
- Architecture decisions
- Lessons learned
- Project timeline
Confirmedmeans verified in the build history or by captured output.Plannedmeans an intended future state, not a deployed feature.To verifyidentifies facts that must be checked on the running system.- Secrets, passwords, Tailscale auth keys, and private keys must never be committed.
- Prefer stable identifiers such as VM IDs, disk serials, and
/dev/disk/by-idover transient device names.
| Area | State | Notes |
|---|---|---|
| Proxmox VE | Operational | Version 9.2 recorded in project history |
| Ubuntu Server VM | Operational | Docker application host |
| TrueNAS SCALE VM | Operational | Storage platform; pool state must be verified before changes |
| Docker platform | Operational | Homepage, Portainer, Wiki.js, PostgreSQL |
| Remote access | Operational | Tailscale; no public management ports intended |
| Enterprise HDD qualification | Complete | Seven drives passed extended SMART tests |
| UPS graceful shutdown | Ready to implement | Follow the runbook; exact Forza model/driver remains to be discovered |
Every design decision within Project Grundy follows these guiding principles.
Infrastructure should continue operating predictably and recover gracefully from failures.
Solutions should be easy to understand, maintain, and troubleshoot.
Manual processes should be automated wherever practical.
Every deployment, architectural decision, and operational procedure should be documented.
Every critical service should expose metrics, logs, and health information.
Security is considered during design rather than added later.
The complete platform should be rebuildable from version-controlled configuration with minimal manual intervention.
Project Grundy is designed as a long-term engineering platform that evolves through continual refinement and adoption of new technologies.
Project Grundy provides an environment for:
- Infrastructure Engineering
- Software Development
- DevOps
- Platform Engineering
- Systems Administration
- Infrastructure Automation
- AI Research
- Knowledge Management
- Monitoring & Observability
- Disaster Recovery
- Self-Hosted Services
- Continuous Learning
Project Grundy has successfully completed its foundational engineering platform phase and is ready for expansion into networking, observability, automation, and self-hosted services.
- ✅ Proxmox VE deployed and configured
- ✅ Ubuntu Server deployed
- ✅ TrueNAS deployed
- ✅ ZFS storage configured
- ✅ SMB shares configured
- ✅ Docker Engine installed
- ✅ Docker Compose standardized
- ✅ Shared Docker network established
- ✅ Shared environment configuration implemented
- ✅ Homepage deployed
- ✅ Portainer deployed
- ✅ Shared PostgreSQL server deployed
- ✅ Wiki.js deployed and verified
- 🔄 Engineering documentation
- 🔄 Architecture documentation
- 🔄 Operational procedures
- 🔄 Infrastructure standards
Project-Grundy/
│
├── README.md
├── CHANGELOG.md
├── ROADMAP.md
├── TODO.md
│
├── docs/
│ ├── Architecture
│ ├── Diagrams
│ ├── Engineering
│ ├── Infrastructure
│ └── Operations
│
└── PROJECT-TIMELINE.md
| Service | Status | Purpose |
|---|---|---|
| Homepage | ✅ Operational | Engineering Platform Dashboard |
| Portainer | ✅ Operational | Container Management |
| PostgreSQL | ✅ Operational | Shared Database Platform |
| Wiki.js | ✅ Operational | Knowledge Management Platform |
- Traefik
- Internal DNS
- Automatic HTTPS
- Service Discovery
- Prometheus
- Grafana
- Loki
- Alertmanager
- Node Exporter
- cAdvisor
- Gitea
- Forgejo Runner
- Vaultwarden
- Secret Management
- Central Authentication
- Paperless-ngx
- Nextcloud
- Immich
- Jellyfin
- n8n
- Ansible
- Terraform
- Ollama
- Open WebUI
- Local LLMs
- ✅ Deploy Proxmox
- ✅ Deploy Ubuntu Server
- ✅ Deploy TrueNAS
- ✅ Configure Docker
- ✅ Deploy Homepage
- ✅ Deploy Portainer
- ✅ Deploy PostgreSQL
- ✅ Deploy Wiki.js
- ✅ Standardize Docker networking
- ✅ Implement shared environment configuration
- Create Git repository
- Complete engineering documentation
- Build architecture diagrams
- Document operational procedures
- Standardize Docker deployment templates
- Reverse Proxy
- Internal DNS
- HTTPS
- Service discovery
- Metrics
- Dashboards
- Centralized logging
- Alerting
- Source control
- Password management
- Document management
- Private cloud
- Media services
- Infrastructure as Code
- Automated deployments
- Automated backups
- Disaster recovery
- Local AI infrastructure
- AI-assisted engineering
- Self-hosted LLMs
| Area | Status |
|---|---|
| Hardware | ✅ |
| Virtualization | ✅ |
| Storage | ✅ |
| Container Platform | ✅ |
| Core Services | ✅ |
| Documentation | 🚧 |
| Networking | ⏳ |
| Observability | ⏳ |
| Automation | ⏳ |
| AI Platform | ⏳ |
| Disaster Recovery | ⏳ |
| Symbol | Meaning |
|---|---|
| ✅ | Complete / Operational |
| 🚧 | In Progress |
| ⏳ | Planned |
| ❌ | Not Started |
| Requires Attention | |
| 🔄 | Under Review / Being Verified |
Project Grundy follows several engineering standards:
- Infrastructure as Code
- Git-first workflows
- Documentation-driven engineering
- Least privilege security
- Automated backups
- Continuous monitoring
- Reproducible deployments
- Change tracking
- Incremental improvement
Project Grundy is intended to become a fully self-hosted engineering platform capable of supporting modern software engineering, infrastructure operations, automation, artificial intelligence, and personal cloud services.
Every deployment is viewed as an opportunity to improve operational excellence, strengthen engineering discipline, and expand practical knowledge through hands-on implementation.
The platform will continue evolving as new technologies emerge while remaining focused on reliability, simplicity, security, and maintainability.
This project is maintained for educational, research, and engineering purposes.
| Version | Status | Highlights |
|---|---|---|
| v0.1.0 | Core Platform Established | Proxmox, TrueNAS, Docker, Homepage, Portainer, PostgreSQL, Wiki.js |