Installationsanleitung
In Minuten eingerichtet, nicht in Tagen
Installieren Sie direkt auf Android TV oder betreiben Sie das Admin-Backend auf einem Raspberry Pi, Ubuntu-Server oder Docker-Container.
Android TV Installation
- 01
App herunterladen
Suchen Sie nach HospitalityTV im Google Play Store oder laden Sie die APK direkt von unserer Releases-Seite herunter.
- 02
Unbekannte Quellen aktivieren (nur APK)
Gehen Sie zu Einstellungen → Sicherheit und aktivieren Sie "Installation aus unbekannten Quellen" für Ihren Dateimanager.
- 03
Installieren und starten
Öffnen Sie den Play Store (oder die heruntergeladene APK) und installieren Sie. Starten Sie HospitalityTV aus Ihrer App-Schublade.
- 04
Mit Admin-Server verbinden
Geben Sie Ihre Admin-Backend-URL (lokale IP oder öffentliche Domain) ein, um Ihre Unterkunftsinhalte zu synchronisieren.
- 05
Lizenzschlüssel eingeben (Cloud)
Wenn Sie ein HospitalityTV-Cloud-Abonnement haben, geben Sie Ihren Lizenzschlüssel während der Einrichtung oder in den Einstellungen ein, um alle Funktionen und individuelles Branding freizuschalten. Selbst gehostete Setups können diesen Schritt überspringen.
Raspberry Pi Backend-Setup
Betreiben Sie das HospitalityTV Admin-Backend lokal auf einem Raspberry Pi. Ideal für Einzelunterkunfts-Setups ohne Cloud-Server.
- 01
Raspberry Pi OS installieren
Laden Sie Raspberry Pi OS Lite (64-bit) herunter und flashen Sie es auf eine SD-Karte. Aktivieren Sie SSH und konfigurieren Sie WLAN-Zugangsdaten.
- 02
Docker & Docker Compose installieren
SSH auf Ihren Pi und ausführen:
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
- 03
Repository klonen
git clone https://github.com/your-org/hospitality-tv-admin.git
cd hospitality-tv-admin
- 04
Umgebung konfigurieren
Kopieren Sie .env.example nach .env und füllen Sie Ihre Einstellungen aus: APP_URL, Datenbank-Zugangsdaten und Lizenz-Secret.
- 05
Stack starten
docker compose up -d
Das Admin-Panel ist verfügbar unter http://<pi-ip>:3001
- 06
Android TV koppeln
Geben Sie in der TV-App http://<pi-ip>:4000 als Backend-URL ein. Bildschirme erscheinen automatisch im Admin-Panel.
Ubuntu Server Installation
Stellen Sie das Admin-Backend auf einem VPS oder dedizierten Ubuntu-Server bereit. Unterstützt Remote-Zugriff über das Internet via HTTPS.
- 01
Ubuntu 22.04 LTS installieren
Einen VPS bereitstellen (mind. 2 vCPU, 2 GB RAM).
sudo apt update && sudo apt upgrade -y
- 02
Node.js & Docker installieren
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
Klonen und konfigurieren
git clone https://github.com/your-org/hospitality-tv-admin.git
cd hospitality-tv-admin
cp .env.example .env
- 04
Datenbankmigrationen ausführen
npm run db:migrate
npm run db:seed
- 05
Backend starten
docker compose up -d
- 06
SSL & Domain konfigurieren
Richten Sie Ihren Domain-DNS auf die Server-IP. Verwenden Sie Caddy oder Nginx + Certbot für HTTPS.
- 07
TVs verbinden
Geben Sie Ihre öffentliche Backend-URL in der Android TV-App ein. Bildschirme registrieren sich automatisch.
Docker Compose Setup
Der schnellste Weg, den kompletten Stack überall dort zu betreiben, wo Docker verfügbar ist. Funktioniert auf Linux, macOS und 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
Kopieren und konfigurieren
Kopieren Sie die Compose-Datei oben. Erstellen Sie eine .env-Datei mit DB_PASSWORD, APP_URL und LICENSE_SECRET.
- 02
Stack starten
docker compose pull && docker compose up -d
- 03
Admin-Panel aufrufen
Öffnen Sie http://localhost:3001 in Ihrem Browser, um auf das Admin-Panel zuzugreifen.
- 04
Update-Vorgang
docker compose pull && docker compose up -d
(Zero-Downtime Rolling Update)
