Getting Started
Welcome to HD Homey! This guide will help you set up and start streaming from your HDHomeRun devices.
Quick Overview
HD Homey is a Next.js-based proxy application that enables secure remote access to live TV streams from your HDHomeRun network tuners. Whether you're at home or on the go, you can watch live TV through a modern web interface or external media players.
What You'll Need
Before getting started, make sure you have:
- HDHomeRun Device: A network-connected HDHomeRun tuner on your local network
- Docker (recommended): For the easiest deployment method
- Or Node.js 20+: If you prefer running from source
- Network Access: Ability to expose port 3000 or configure reverse proxy
Installation Paths
Choose the installation method that works best for you:
🚀 Quick Start (5 minutes)
Perfect for trying HD Homey or quick deployment with Docker Compose.
📦 Full Installation Guide
Detailed instructions for Docker, Docker Run, and source installation.
🎬 First Stream Tutorial
Complete walkthrough from adding your first tuner to watching your first channel.
What's Next?
After installation, you'll want to:
- Add Your Tuners: Configure your HDHomeRun devices in the Tuners page
- Scan Channels: Discover available channels from your tuners
- Create Users: Set up viewer accounts for family or friends
- Configure Streaming: Set transcoding preferences and stream security options
Getting Help
- Troubleshooting: Check the Troubleshooting section for common issues
- Configuration: Learn about Environment Variables
- Features: Explore all Features available in HD Homey
Ready to start? Pick your installation path above and let's get streaming! 📺