Installatiegids
In minuten klaar, niet in dagen
Installeer rechtstreeks op Android TV, of draai de beheer-backend op een Raspberry Pi, Ubuntu-server of Docker-container.
Installatie op Android TV
- 01
Download de app
Zoek naar HospitalityTV in de Google Play Store, of download de APK rechtstreeks van onze releasepagina.
- 02
Schakel onbekende bronnen in (alleen APK)
Ga naar Instellingen → Beveiliging en schakel "Installeren uit onbekende bronnen" of "Onbekende apps" in voor je bestandsbeheerder.
- 03
Installeer en start
Open de Play Store-app (of de gedownloade APK) en installeer. Start HospitalityTV vanuit je app-overzicht.
- 04
Verbind met de beheerserver
Voer de URL van je beheer-backend in (lokaal IP of openbaar domein) om de content en instellingen van je accommodatie te synchroniseren.
- 05
Voer je licentiesleutel in (Cloud)
Heb je een HospitalityTV Cloud-abonnement? Voer je licentiesleutel in tijdens de installatie of bij Instellingen om alle functies en eigen branding te ontgrendelen. Zelf-gehoste installaties kunnen deze stap overslaan.
Backend-installatie op Raspberry Pi
Draai de HospitalityTV-beheer-backend lokaal op een Raspberry Pi. Ideaal voor opstellingen met één locatie zonder cloudserver. Alle Android TV's in hetzelfde netwerk verbinden automatisch.
- 01
Flash Raspberry Pi OS
Download Raspberry Pi OS Lite (64-bit) en flash het naar een SD-kaart. Schakel SSH in en stel je wifi-gegevens in.
- 02
Installeer Docker & Docker Compose
Maak via SSH verbinding met je Pi en voer uit:
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
- 03
Kloon de repository
git clone https://github.com/your-org/hospitality-tv-admin.git
cd hospitality-tv-admin
- 04
Configureer de omgeving
Kopieer .env.example naar .env en vul je instellingen in: APP_URL, databasegegevens en license secret.
- 05
Start de stack
docker compose up -d
Het beheerpaneel is beschikbaar op http://<pi-ip>:3001
- 06
Koppel je Android TV
Voer in de tv-app http://<pi-ip>:4000 in als backend-URL. Schermen verschijnen automatisch in je beheerpaneel.
Installatie op Ubuntu Server
Implementeer de beheer-backend op een VPS of dedicated Ubuntu-server. Ondersteunt toegang op afstand via internet met HTTPS.
- 01
Installeer Ubuntu 22.04 LTS
Richt een VPS in (minimaal 2 vCPU, 2 GB RAM).
sudo apt update && sudo apt upgrade -y
- 02
Installeer 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
Klonen en configureren
git clone https://github.com/your-org/hospitality-tv-admin.git
cd hospitality-tv-admin
cp .env.example .env
- 04
Voer databasemigraties uit
npm run db:migrate
npm run db:seed
- 05
Start de backend
docker compose up -d
- 06
Configureer SSL & domein
Wijs de DNS van je domein naar het server-IP. Gebruik Caddy of Nginx + Certbot voor HTTPS. Werk APP_URL in .env bij naar je domein.
- 07
Verbind tv's
Voer je openbare backend-URL in de Android TV-app in. Schermen registreren zich automatisch.
Installatie met Docker Compose
De snelste manier om de volledige stack overal te draaien waar Docker beschikbaar is. Werkt op Linux, macOS en 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
Kopiëren en configureren
Kopieer het compose-bestand hierboven. Maak een .env-bestand met DB_PASSWORD, APP_URL en LICENSE_SECRET.
- 02
Start de stack
docker compose pull && docker compose up -d
- 03
Open het beheerpaneel
Open http://localhost:3001 in je browser om het beheerdersdashboard te openen.
- 04
Updateprocedure
docker compose pull && docker compose up -d
(Rolling update zonder downtime)
