--- title: "Deploy HunyuanVideo 1.5 Self-Hosted (Docker)" description: "Step-by-step guide to self-hosting HunyuanVideo 1.5 with Docker Compose. " --- # Deploy HunyuanVideo 1.5 Tencent's state-of-the-art open-source video generation model with 13B parameters.
⭐ 8.0k stars 📜 Apache License 2.0 🔴 Advanced ⏱ ~20 minutes
🚀 Deploy on DigitalOcean ($200 Free Credit)
## What You'll Get A fully working HunyuanVideo 1.5 instance running on your server. Your data stays on your hardware — no third-party access, no usage limits, no surprise invoices. ## Prerequisites - A server with Docker and Docker Compose installed ([setup guide](/quick-start/choosing-a-server)) - A domain name pointed to your server (optional but recommended) - Basic terminal access (SSH) ## The Config Create a directory for HunyuanVideo 1.5 and add this `docker-compose.yml`: ```yaml # ------------------------------------------------------------------------- # 🚀 Created and distributed by The AltStack # 🌍 https://thealtstack.com # ------------------------------------------------------------------------- version: '3.8' services: hunyuan: image: tencent/hunyuan:latest container_name: hunyuan restart: unless-stopped ports: - "8000:8000" ``` ## Let's Ship It ```bash # Create a directory mkdir -p /opt/hunyuan-video && cd /opt/hunyuan-video # Create the docker-compose.yml (paste the config above) nano docker-compose.yml # Pull images and start docker compose up -d # Watch the logs docker compose logs -f ``` ## Post-Deployment Checklist - [ ] Service is accessible on the configured port - [ ] Admin account created (if applicable) - [ ] Reverse proxy configured ([Caddy guide](/concepts/reverse-proxies)) - [ ] SSL/HTTPS working - [ ] Backup script set up ([backup guide](/concepts/backups)) - [ ] Uptime monitor added ([Uptime Kuma](/deploy/uptime-kuma)) ## The "I Broke It" Section **Container won't start?** ```bash docker compose logs hunyuan-video | tail -50 ``` **Port already in use?** ```bash # Find what's using the port lsof -i :PORT_NUMBER ``` **Need to start fresh?** ```bash docker compose down -v # ⚠️ This deletes volumes/data! docker compose up -d ``` ## Going Further - [HunyuanVideo 1.5 on AltStack Directory](https://thealtstack.com/alternative-to/hunyuan-video) - [HunyuanVideo 1.5 Self-Hosted Guide](https://thealtstack.com/self-hosted/hunyuan-video) - [Official Documentation](https://github.com/Tencent/HunyuanVideo) - [GitHub Repository](https://github.com/Tencent/HunyuanVideo)