Guide d'installation
Configuré en minutes, pas en jours
Installez directement sur Android TV, ou exécutez le backend admin sur un Raspberry Pi, un serveur Ubuntu ou un conteneur Docker.
Installation sur Android TV
- 01
Téléchargez l'application
Recherchez HospitalityTV sur le Google Play Store, ou téléchargez l'APK directement depuis notre page de versions.
- 02
Activez les sources inconnues (APK uniquement)
Allez dans Paramètres → Sécurité et activez "Installer depuis des sources inconnues" pour votre gestionnaire de fichiers.
- 03
Installez et lancez
Ouvrez Play Store (ou l'APK téléchargé) et installez. Lancez HospitalityTV depuis votre tiroir d'applications.
- 04
Connectez-vous au serveur admin
Entrez l'URL du backend admin (IP locale ou domaine public) pour synchroniser le contenu et les paramètres de votre propriété.
- 05
Entrez votre clé de licence (Cloud)
Si vous avez un abonnement HospitalityTV Cloud, entrez votre clé de licence pendant la configuration ou dans Paramètres pour débloquer toutes les fonctionnalités et la marque personnalisée. Les installations auto-hébergées peuvent ignorer cette étape.
Configuration du Backend sur Raspberry Pi
Exécutez le backend admin de HospitalityTV localement sur un Raspberry Pi. Idéal pour les configurations à propriété unique sans serveur cloud.
- 01
Installez Raspberry Pi OS
Téléchargez Raspberry Pi OS Lite (64-bit) et gravez-le sur une carte SD. Activez SSH et configurez vos identifiants WiFi.
- 02
Installez Docker & Docker Compose
Connectez-vous en SSH à votre Pi et exécutez :
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
- 03
Clonez le dépôt
git clone https://github.com/your-org/hospitality-tv-admin.git
cd hospitality-tv-admin
- 04
Configurez l'environnement
Copiez .env.example en .env et remplissez vos paramètres : APP_URL, identifiants de base de données et secret de licence.
- 05
Démarrez le stack
docker compose up -d
Le panneau admin sera disponible sur http://<ip-pi>:3001
- 06
Associez votre Android TV
Dans l'app TV, entrez http://<ip-pi>:4000 comme URL du backend. Les écrans apparaissent automatiquement dans votre panneau admin.
Installation sur Serveur Ubuntu
Déployez le backend admin sur un VPS ou serveur Ubuntu dédié. Supporte l'accès distant via internet par HTTPS.
- 01
Installez Ubuntu 22.04 LTS
Provisionnez un VPS (minimum 2 vCPU, 2 Go RAM).
sudo apt update && sudo apt upgrade -y
- 02
Installez Node.js & 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
Clonez et configurez
git clone https://github.com/your-org/hospitality-tv-admin.git
cd hospitality-tv-admin
cp .env.example .env
- 04
Exécutez les migrations
npm run db:migrate
npm run db:seed
- 05
Démarrez le backend
docker compose up -d
- 06
Configurez SSL & domaine
Pointez le DNS de votre domaine vers l'IP du serveur. Utilisez Caddy ou Nginx + Certbot pour HTTPS.
- 07
Connectez les téléviseurs
Entrez l'URL publique du backend dans l'app Android TV. Les écrans s'enregistrent automatiquement.
Configuration avec Docker Compose
La façon la plus rapide d'exécuter le stack complet partout où Docker est disponible. Fonctionne sur Linux, macOS et 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
Copiez et configurez
Copiez le fichier compose ci-dessus. Créez un fichier .env avec DB_PASSWORD, APP_URL et LICENSE_SECRET.
- 02
Démarrez le stack
docker compose pull && docker compose up -d
- 03
Accédez au panneau admin
Ouvrez http://localhost:3001 dans votre navigateur pour accéder au panneau admin.
- 04
Procédure de mise à jour
docker compose pull && docker compose up -d
(Mise à jour sans interruption)
