These guides map an industry's concepts onto the objects the platform has today (bouquets, lines, packages, partner accounts, nodes, the API). They are conceptual mappings, not industry-specific features, and a partner account is a delegated account, not an isolated tenant.
Conceptual mapping
Nothing in the panel is called a gallery or a member. The table says which object plays which role; the chapters below set them up in that order.
| In your industry | On the platform | Where in the panel |
|---|---|---|
| Exhibition film and archive | VOD catalogue: movies and series with seasons and episodes, categories and metadata | Movies and Series, or the VOD ingest job |
| Opening or lecture broadcast | Live channel: a stream with its sources, EPG and output formats | Streams → add a live stream (source URL or RTMP push) |
| Gallery or members' collection | Bouquet: a named set of channels, films or series that a package grants | Bouquets, from Streams and Movies / Series |
| Visitor or member access | Line: one access with its package, bouquets, expiry, connection limit and outputs | Lines → add, or activation codes, or the Reseller API |
| Membership period | Expiry date of the line, renewed by a package, a credit or the API | The line's expiry date and the package's duration |
| Devices per member | Max connections of the line: how many devices may watch at once | The line's max connections |
Prerequisites
What to have before installing.
- A server in the building (Ubuntu 22.04 or 24.04), the installer, and the gallery network that the screens and the members' devices will use.
- The exhibition film, the archive recordings you hold the rights to, an encoder for the lecture hall, and the screens or media players for the galleries.
- The licence key and, if the building has no internet, the offline activation procedure; and a decision on who at the desk sells memberships.
Infrastructure deployment
The server in the building, activated on site.
- Run the installer on the server and set the playback base URL to the address the gallery network reaches.
- Activate the licence key offline from the panel; after activation the service runs on the local network without the internet.
- Add the exhibition film under Movies and the lecture-hall feed under Streams, and check them in the web player.
- For a second site or a large public programme, enrol a node from Servers; the panel installs it over SSH and routes that site's viewers to it.
Content organisation
Galleries, archive and members' collections.
- Create categories per exhibition and per year, and a series for a lecture cycle with one episode per talk.
- Create one bouquet for the gallery screens and one for the members' library of talks and archive film.
- Create a package for the galleries and one per kind of membership, each granting its bouquets; the membership package's duration is the membership period.
- Add posters and short descriptions to every movie so the library reads well in the player.
Partner (reseller) configuration
The desk and the shop as delegated accounts.
- Create a group with permissions limited to lines and activation codes, and no access to the catalogue or the servers.
- Add the desk, or the shop, as a reseller with that group, the membership packages and a credit balance.
- A cultural centre that runs several venues can add a reseller per venue, each selling memberships from its own balance.
Visitor and member access configuration
Screens and members on lines.
- Create one line per gallery screen under Lines → add with the gallery package, and bind it to the screen's address when the network gives fixed addresses.
- Create activation codes at the desk for each membership sold; the member enters the code in the player and the line starts.
- Set max connections per membership to the number of devices a member may use, typically two.
- Hand the member the player app, an M3U playlist or the web player address, whichever fits their device.
Exhibition film and archive
The library on demand.
- Upload the exhibition film and the digitised archive as movies, or ingest them with the VOD ingest job into the media root.
- Add TMDB metadata where it exists, and write the title and description yourself for the rest.
- Keep the archive that is not for the public in the members' bouquet only, and check what each package sees with a test line.
Openings and lectures
An event as a live channel.
- Add a live stream for the lecture hall's encoder (RTMP push) and place it in the members' bouquet, or in the gallery bouquet for an opening shown on the screens.
- Enable catch-up so a member who arrives late can rewind, and upload the recording to the library afterwards.
- Test the encoder and the stream before the event with a test line, on the same network the audience will use.
Membership expiry and renewal
The membership as the line's validity.
- A line expires at the end of its package's period; a renewal at the desk adds another period.
- Disable a line when a membership is cancelled; activation codes that were never used stay unused until they are redeemed.
- Subscribe the shop or the membership system to the webhooks to see lines that are about to expire or already expired.
Integration with the shop or membership system
Systems sell the access; the player plays.
- Create a Reseller API key for the shop or the membership system; it calls create_line, renew_line and disable_line, with a request id on each write.
- Use a commerce connector when memberships are sold online; any other system uses the Reseller API and webhooks.
- There is no single sign-on for viewers: a member signs in to the player with the line's credentials or the activation code.
Security considerations
Keep the collections where they belong.
- Keep the gallery network separate from the visitors' network, and serve any public access behind a reverse proxy with TLS and TRUSTED_PROXIES set.
- Two-factor sign-in for every panel account; the desk gets a permission group limited to lines and codes.
- Signed and expiring playback links, a connection limit per membership, and address binding for the gallery screens.
- Enable the encrypted database backup with an off-site copy, and use the audit log to review changes of lines and catalogue.
Troubleshooting
The usual first checks.
- A gallery screen is black: check that its line is enabled and not expired, the screen's address binding, and that the server is reachable on the gallery network.
- A member's code does not work: check that the code was not redeemed already and that the package it opens is still assigned to the desk.
- Licence activation fails offline: check the activation file against the licence key and the clock of the server.
- The live opening stutters: check the encoder's bitrate against the uplink and the stream's status under Streams.