For Developers
Solution Information
Technical stack and development environment for contributing to Honse Farm.
Technology Stack
Honse Farm is built with modern .NET technologies and containerization for a robust, scalable federation platform.
Solution Design
The Honse Farm solution is organized into focused projects, each serving a specific role in the federation ecosystem.
| Project | Tech Stack | Purpose |
|---|---|---|
| HonseFarm.AppHost | .NET Aspire | Local development orchestration (dev-only) |
| HonseFarm.Client | Dalamud | The HonseFarm Client plugin |
| HonseFarm.Server | ASP.NET Core 10 | Main server handling user auth, pairing, and federation |
| HonseFarm.FileServer | ASP.NET Core 10 | Distributed file storage with configurable roles (Main/Distribution/Shard/AllInOne) |
| HonseFarm.AdminPanel | Blazor Server | Web-based server management interface |
| HonseFarm.Installer | .NET 10 Console | Automated deployment wizard and Docker configuration generator |
| HonseFarm.Api | .NET 10 | Shared API contracts and DTOs for all components |
| HonseFarm.Shared | .NET 10 | Shared business logic, database models, and utilities |
Production Deployment Stack
The installer generates a complete Docker Compose deployment with:
- Core Services: HonseFarm Server, FileServer(s), and AdminPanel containers
- Data Layer: PostgreSQL (database) and Redis (cache)
- Infrastructure: Traefik (reverse proxy with automatic SSL)
- Observability:
- VictoriaMetrics (metrics collection)
- VictoriaLogs (centralized logging)
- VictoriaTrace (distributed tracing)
- Grafana (dashboards and visualization)
Getting Started
To begin contributing to Honse Farm, check out the Prerequisites page for setting up your local development environment.