# Aan de slag

> Wat Kyosk is, wat je nodig hebt en hoe een eerste scherm online komt.

Bron: https://kyosk.nl/docs/aan-de-slag

Kyosk laat digitale schermen draaien op een Raspberry Pi en houdt ze op afstand bij. Je beheert de inhoud, de updates en de status van alle schermen vanuit één plek. Deze pagina loopt in grote lijnen door hoe een eerste scherm online komt.

## Hoe het in elkaar zit

Elk scherm bestaat uit een Raspberry Pi met twee kleine programma's in Rust. Er draait geen browser en geen Node op de Pi.

- **De poller** draait elke minuut. Hij haalt de instellingen en slides op, maakt afbeeldingen en QR-codes klaar, voert opdrachten uit en stuurt een levensteken terug.
- **De weergave** tekent het beeld zelf, met of zonder grafische omgeving (X11 of DRM/KMS), en wisselt zacht tussen slides.

Het scherm praat met een API met een eigen token per scherm. Het panel is de plek waar jij klanten, schermen, slides en updates beheert. Het panel is niet publiek bereikbaar.

## Wat je nodig hebt

- Een Raspberry Pi 3B+, 4 of 5, een SD-kaart en een scherm met HDMI.
- Een internetverbinding op de locatie. Zonder verbinding speelt het scherm de laatst opgehaalde inhoud door.
- Een klant en een scherm in het panel, en het configuratiebestand `installer.env` dat het panel voor dat scherm maakt.
- Toegang tot de installatie-bestanden.

> [!OPMERKING] De installatie-bestanden en releases van Kyosk staan in een privé opslagplaats en zijn niet openbaar. Toegang vraag je aan via [contact](/contact).

## Een scherm online brengen

1. Maak in het panel de klant en het scherm aan, en download `installer.env` voor dat scherm. Het bestand bevat geheimen: nooit committen en nooit mailen.
2. Flash de SD-kaart met Raspberry Pi Imager. Zet een hostnaam, een gebruiker en SSH aan.
3. Kopieer `installer.env` en het installatiescript naar de Pi.
4. Draai het installatiescript op de Pi.
5. Controleer binnen enkele minuten of het scherm in het panel als online verschijnt.
6. Verwijder `installer.env` van je laptop. De installer ruimt het bestand op de Pi zelf op.

```bash title="Op je laptop en op de Pi"
scp installer.env install-from-github.sh <gebruiker>@<pi>.local:/tmp/
ssh <gebruiker>@<pi>.local
cd /tmp && sudo bash install-from-github.sh
```

Verschijnt het scherm niet, ga dan naar [Probleemoplossing](/docs/probleemoplossing).

> [!TEST] De testrelease v1.2.2-exp is bedoeld voor een test-Pi, niet voor productieschermen. Pas een versie vastzetten doe je met `sudo KIOSK_RELEASE_TAG=v1.2.2-exp bash install-from-github.sh`. Pi's op `latest` pakken een testrelease nooit op.

## Hoe verder

- [Een klant inrichten](/docs/klant-inrichten): klanten, schermen en toegang.
- [Schermen en tokens](/docs/schermen-en-tokens): de gegevens in `installer.env` en het token per scherm.
- [Slides en aankondigingen](/docs/slides-en-aankondigingen): wat het scherm kan tonen.
- [Live status](/docs/live-status): wat er speelt en hoe het scherm eraan toe is.