Install HomeTube
Get up and running in under a minute with Docker. Works on any platform that supports containers.
Requirements
Docker & Docker Compose
1GB+ disk space for app
Internet connection
Storage for downloads
Quick Start
Docker Compose (Recommended)
Full setup with environment configuration
1. Clone the repository:
git clone https://github.com/EgalitarianMonkey/hometube.git
&& cd hometube 2. Configure environment:
cp .env.sample .env 3. Start HomeTube:
docker-compose up -d 🎉 Open http://localhost:8501 in your browser
Docker Run (Quick Test)
Single command for quick testing
docker run -d \
--name hometube \
-p 8501:8501 \
-v ./downloads:/data/videos \
-v ./cookies:/config \
ghcr.io/egalitarianmonkey/hometube:latest Works on Your Favorite Platform
Synology
QNAP
Unraid
TrueNAS
Portainer
Proxmox
Need More Details?
Check out the complete installation documentation on GitHub for advanced configuration, environment variables, and troubleshooting.
Common Questions
How do I update HomeTube?
Run docker-compose pull && docker-compose up -d to get the latest version.
How do I access age-restricted videos?
Export your browser cookies and mount them to /config. See docs for details.
Can I change the download folder?
Yes! Modify the volume mount in docker-compose.yml or the -v flag in docker run.
Issues or feature requests?
Open an issue on GitHub and we'll help you out.