Guía de instalación
Configura en minutos, no en días
Instala directamente en Android TV, o ejecuta el backend de administración en una Raspberry Pi, servidor Ubuntu o contenedor Docker.
Instalación en Android TV
- 01
Descarga la aplicación
Busca HospitalityTV en Google Play Store, o descarga el APK directamente desde nuestra página de lanzamientos.
- 02
Habilita fuentes desconocidas (solo APK)
Ve a Configuración → Seguridad y habilita "Instalar desde fuentes desconocidas" para tu gestor de archivos.
- 03
Instala y lanza
Abre Play Store (o el APK descargado) e instala. Lanza HospitalityTV desde el cajón de aplicaciones.
- 04
Conéctate al servidor de administración
Ingresa la URL del backend de administración (IP local o dominio público) para sincronizar el contenido y la configuración de tu propiedad.
- 05
Ingresa tu clave de licencia (Cloud)
Si tienes una suscripción a HospitalityTV Cloud, ingresa tu clave de licencia durante la configuración o en Configuración para desbloquear todas las funciones y la marca personalizada. Las instalaciones autoalojadas pueden omitir este paso.
Configuración del Backend en Raspberry Pi
Ejecuta el backend de administración de HospitalityTV localmente en una Raspberry Pi. Ideal para configuraciones de una sola propiedad sin un servidor en la nube.
- 01
Instala Raspberry Pi OS
Descarga Raspberry Pi OS Lite (64-bit) y grábalo en una tarjeta SD. Habilita SSH y configura tus credenciales WiFi.
- 02
Instala Docker y Docker Compose
Conéctate por SSH a tu Pi y ejecuta:
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
- 03
Clona el repositorio
git clone https://github.com/your-org/hospitality-tv-admin.git
cd hospitality-tv-admin
- 04
Configura el entorno
Copia .env.example a .env y completa tus configuraciones: APP_URL, credenciales de base de datos y licencia.
- 05
Inicia el stack
docker compose up -d
El panel de administración estará disponible en http://<ip-pi>:3001
- 06
Vincula tu Android TV
En la app del TV, ingresa http://<ip-pi>:4000 como URL del backend. Las pantallas aparecerán automáticamente.
Instalación en Servidor Ubuntu
Despliega el backend de administración en un VPS o servidor Ubuntu dedicado. Compatible con acceso remoto por internet vía HTTPS.
- 01
Instala Ubuntu 22.04 LTS
Aprovisiona un VPS (mínimo 2 vCPU, 2 GB RAM).
sudo apt update && sudo apt upgrade -y
- 02
Instala Node.js y Docker
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt install -y nodejs docker.io docker-compose
sudo systemctl enable --now docker
- 03
Clona y configura
git clone https://github.com/your-org/hospitality-tv-admin.git
cd hospitality-tv-admin
cp .env.example .env
- 04
Ejecuta las migraciones
npm run db:migrate
npm run db:seed
- 05
Inicia el backend
docker compose up -d
- 06
Configura SSL y dominio
Apunta el DNS de tu dominio a la IP del servidor. Usa Caddy o Nginx + Certbot para HTTPS.
- 07
Conecta los televisores
Ingresa la URL pública del backend en la app del Android TV. Las pantallas se registran automáticamente.
Configuración con Docker Compose
La forma más rápida de ejecutar el stack completo en cualquier lugar donde Docker esté disponible. Funciona en Linux, macOS y Windows.
# docker-compose.yml
version: "3.9"
services:
db:
image: postgres:16-alpine
restart: unless-stopped
environment:
POSTGRES_DB: hospitalitytv
POSTGRES_USER: htv
POSTGRES_PASSWORD: ${DB_PASSWORD}
volumes:
- db_data:/var/lib/postgresql/data
api:
image: ghcr.io/your-org/hospitality-tv-api:latest
restart: unless-stopped
depends_on: [db]
ports:
- "4000:4000"
environment:
DATABASE_URL: postgresql://htv:${DB_PASSWORD}@db:5432/hospitalitytv
APP_URL: ${APP_URL}
LICENSE_SECRET: ${LICENSE_SECRET}
admin:
image: ghcr.io/your-org/hospitality-tv-admin:latest
restart: unless-stopped
depends_on: [api]
ports:
- "3001:3001"
environment:
API_URL: http://api:4000
volumes:
db_data:
- 01
Copia y configura
Copia el archivo compose de arriba. Crea un archivo .env con DB_PASSWORD, APP_URL y LICENSE_SECRET.
- 02
Inicia el stack
docker compose pull && docker compose up -d
- 03
Accede al panel de administración
Abre http://localhost:3001 en tu navegador para acceder al panel de administración.
- 04
Procedimiento de actualización
docker compose pull && docker compose up -d
(Actualización sin tiempo de inactividad)
