/Labby

Your one stop app for anything homelab.

Primary LanguageSwiftGNU General Public License v3.0GPL-3.0

Labby

A unified iOS dashboard for managing and monitoring your self-hosted services

Instead of juggling multiple web interfaces or mobile apps, Labby provides a single, native iOS experience for controlling your homelab infrastructure.

โœจ Features

๐Ÿ  Multi-Home Support
  • Organize services into different homes (e.g., "Home Lab", "Work", "Remote Sites")
  • Switch between homes with a simple dropdown interface
  • Customizable layouts for each home environment
๐Ÿ“Š Real-Time Monitoring
  • Live statistics and metrics for all connected services
  • Customizable widget sizes and layouts on a 2-column grid
  • Auto-refresh capabilities with configurable intervals (5-120 seconds)
  • Smart widget sizing based on service content requirements
๐Ÿ” Secure Authentication
  • Multiple authentication methods per service type
  • Credentials stored securely in iOS Keychain
  • Support for API tokens, username/password, and custom authentication
  • Optional SSL certificate verification bypass for self-signed certificates
๐ŸŽจ Native iOS Experience
  • SwiftUI-based modern interface with light/dark mode support
  • Drag-and-drop widget editing and rearrangement
  • Native iOS design patterns and accessibility support
  • Six different widget sizes for optimal data presentation
๐Ÿ›ฃ๏ธ Planned Features

Near Term

  • Home Assistant integration
  • Plex media server support
  • Enhanced Pi-hole controls
  • Widget export/import functionality

Future Plans

  • iPad-optimized layouts
  • watchOS companion app
  • Notification support for service alerts
  • Custom service plugin system

๐Ÿ“– View all features

๐Ÿ› ๏ธ Supported Services

Service Features Authentication
Proxmox VE VM/CT monitoring, resource usage, cluster status API Tokens
Jellyfin Library stats, user management, server info Username/Password
qBittorrent Torrent management, download/upload speeds Username/Password
Pi-hole DNS statistics, blocking status, query metrics Username/Password

๐Ÿš€ Quick Start

  1. Install Labby - Installation Guide
  2. Add Your Services - Quick Start Guide
  3. Customize Your Dashboard - Drag, resize, and configure widgets
  4. Enjoy Your Unified Dashboard ๐ŸŽ‰

Service Setup Guides

๐Ÿ“š Documentation

๐Ÿค Contributing

We welcome contributions! Whether it's:

  • ๐Ÿ› Bug reports and fixes
  • ๐Ÿ’ก Feature requests and implementations
  • ๐Ÿ“– Documentation improvements
  • ๐Ÿงช Testing and feedback

See our Contributing Guide to get started.

๐Ÿ†˜ Support

๐Ÿ”’ Privacy & Security

  • ๐Ÿ  Local First: All configuration stored locally on your device
  • ๐Ÿ” Secure Storage: Credentials encrypted in iOS Keychain
  • ๐Ÿšซ No Telemetry: No usage data collection or external analytics
  • ๐Ÿ“– Open Source: Full transparency with public source code

๐Ÿ’ Support the Project

If Labby helps manage your homelab, consider supporting its development:

Cryptocurrency

  • Bitcoin (BTC): bc1q2seahuhpr2psu0cj6gacvjelyt8da22saf82d9
  • Ethereum (ETH): 0x13FEb6D4608ab9cbe00A7D6b9a4684F752C1AD74
  • Litecoin (LTC): Li7jBnBTKtSQd4BajPLhgnGG2hSEQb54SW

Digital Payments

Every contribution helps cover development costs and enables new features! ๐Ÿ™

๐Ÿ“„ License

Licensed under GNU General Public License v3.0 - free to use, modify, and distribute. Derivatives must also be open source.


Made with โค๏ธ for the self-hosting community

Star โญ this repo if Labby helps manage your homelab!