Homelab iOS – A high-performance, native dashboard for self-hosted infrastructure. Built with a focus on Zero Trust security and multi-process synchronization.
- Full Stack Monitoring: Real-time CPU/RAM/Docker stats via Glances & Coolify.
- Interactive Control: Start/Stop/Restart services with native Swipe Actions.
- TorBox Integration: Advanced storage management with interactive download controls.
- Smart Widgets: Multi-size interactive widgets for instant system health checks.
- Secure by Design: Native support for Cloudflare Zero Trust (Service Tokens).
- Unified Storage: A centralized StorageService managing App Group persistence, ensuring seamless data flow between the App and Widget extensions.
- Network Resilience: Custom URLRequest builders with automatic header injection for secured endpoints.
- UX-First Logic: Implementation of a DeletedTorrentsManager to handle asynchronous API deletions and prevent "ghost" data display.
→ Go to the Releases page, download the latest release version and go to step 2 OR download the app on Testflight.
→ Connect your iPhone via USB or select a Simulator.
→ Ensure your Team is selected in Signing & Capabilities.
→ Press Cmd + R to build and run.
→ Enter your Glances URL in the settings.
→ Paste your Coolify URL & API Token.
→ Paste your TorBox API Token.
→ Paste your Cloudflare Client ID & Secret if you're using Cloudflare Access to protect your Glances/Coolify services
→ The dashboard will automatically start polling data.
→ SwiftUI & Swift Concurrency: Leveraging async/await and Task for non-blocking network operations.
→ WidgetKit (iOS 17+): Interactive widgets using AppIntents for direct infrastructure control from the Home Screen.
→ Cloudflare Zero Trust: Programmatic bypass of SSO via Service Tokens.
→ Persistent Storage: Unified UserDefaults via App Groups for cross-target data sharing.
→ Zero Trust Architecture: Implementation of Cloudflare Access (mTLS/Service Tokens) to secure internal APIs without compromising the mobile experience.
→ Multi-Process State Sync: Use of App Groups and custom StorageService to maintain a single source of truth between the main App and interactive Home Screen Widgets.
→ Optimistic UI & Ghost Data Handling: Custom logic to manage API latency and "phantom" items, ensuring a "Zero Friction" user experience even with slow backend responses.
Copyright (c) 2026 Mathieu DUBART
This project is licensed under the CC BY-NC 4.0 license. You are free to share and adapt the code as long as you provide appropriate credit and do not use the material for commercial purposes.
Built with ❤️ for the self-hosting community.