Overview
A unified home server platform consolidating file storage, document collaboration, and authentication services. Designed for reliability and security with all services exposed via Cloudflare Tunnel.
Architecture Highlights
- Containerized services for easy scaling and maintenance
- Centralized authentication gateway for multi-app support
- Secure external access via Cloudflare Tunnel
- Collaborative document workflows with Nextcloud + Collabora
Core Components
The platform is built on three core components, each serving a distinct purpose in the ecosystem:
Portainer
Container orchestration and management UI for Docker. Centralized dashboard for managing all containerized services.
Nextcloud + Collabora
Self-hosted file storage, sync, and sharing with real-time document collaboration. Nextcloud provides file management while Collabora (LibreOffice-based) enables concurrent editing.
Auth Service
One secure login service for the entire home server stack, powered by Fastify and Supabase PostgreSQL. It centralizes authentication and authorization across apps with a reliable, automated release workflow.
CI/CD Flow
- 1Push changes to the stage branch.
- 2GitHub Actions runs the test suite and quality checks.
- 3Merge approved changes into the master branch.
- 4On master updates, GitHub Actions pulls the latest code on the local server and rebuilds the Docker container image.
Key Implementation Details
The platform uses Docker containers for isolation and Portainer for centralized management. Authentication is decoupled via our custom Fastify-based service backed by Supabase, allowing other applications (like Los Guayacos) to authenticate against the home server. Cloudflare Tunnel provides a secure, performant entry point without exposing the underlying infrastructure.