Home
XtreamUIPro

Setup guide

Live Events setup guide

Configure the platform as the streaming service of a conference, festival or ceremony: a channel per stage, access per ticket, a node at the venue and short expiries.

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 stage or a ticket. The table says which object plays which role; the chapters below set them up in that order.

In your industryOn the platformWhere in the panel
Stage channelLive channel: a stream with its sources, EPG and output formatsStreams → add a live stream (source URL or RTMP push)
Ticket typeBouquet: a named set of channels, films or series that a package grantsBouquets, from Streams and Movies / Series
Ticket or passLine: one access with its package, bouquets, expiry, connection limit and outputsLines → add, or activation codes, or the Reseller API
End of the eventExpiry date of the line, renewed by a package, a credit or the APIThe line's expiry date and the package's duration
Devices per ticketMax connections of the line: how many devices may watch at onceThe line's max connections
Ticketing or registration integrationReseller API and webhooks: the operations of the panel from your own systemReseller API keys and webhooks in the reseller's dashboard
Venue nodeStreaming nodes: edge servers enrolled from the panel, one per site or buildingServers → add a node, installed over SSH

Prerequisites

What to have before installing.

  1. A server (Ubuntu 22.04 or 24.04) with a public address or a domain and uplink for the expected peak audience, and, for a venue node, a machine on the venue's network.
  2. An encoder per stage that can push RTMP, and the list of stages, days and ticket types.
  3. A decision on how tickets reach the panel: activation codes generated in bulk, or the ticketing system calling the Reseller API.

Infrastructure deployment

The origin first, then the venue.

  1. Run the installer on the management server and put the panel behind a reverse proxy with TLS; set the trusted proxies so IP rules see the viewer's real address.
  2. Set the playback base URL to the public address attendees reach.
  3. Enrol a node from Servers on the machine at the venue; the panel installs it over SSH, and the local screens are routed to it.
  4. Create a partner account (reseller) for the ticketing desk with permissions for lines and none for the catalogue.

Content organisation

Stages as channels, tickets as packages.

  1. Add categories per day or per track so the channel list reads like the programme.
  2. Create one bouquet per ticket type: the stages that ticket may watch.
  3. Create one package per ticket type with the length of the event as its duration, and a trial package for press and speakers if needed.
  4. Create a bouquet for the sponsors' stage or lounge feed and grant it only through the sponsor package.

Partner (reseller) configuration

The ticketing desk, if it issues the access.

  1. Create a group with line permissions and no catalogue permissions for the ticketing desk.
  2. Add the desk as a reseller with that group and enough credits for the codes it will issue.
  3. A co-organiser or a regional partner that sells its own tickets gets its own partner account and its own packages.

Attendee access configuration

One line per ticket.

  1. Generate activation codes in bulk, one per ticket, each tied to the package of its ticket type, and print or e-mail them with the ticket.
  2. For online ticket sales, install the connector of your commerce platform, or have the ticketing system call action=create_line with the package and a request id.
  3. Set max connections to one or two devices per ticket so a code cannot be shared across the audience.
  4. Test with a trial line before doors open, using the same player the attendees will use.

Session recordings

Recordings after the event.

  1. Record each stage and add the files to the library as episodes of a series per track, or ingest them with the VOD ingest job.
  2. Grant the recordings through a bouquet and a package of their own, so attendees keep access after the live lines have expired.
  3. Check playback of the recordings with a test line of that package before announcing them.

Stage channels

A stage as a live channel.

  1. Add a live stream per stage with the encoder's RTMP push, and place it in the bouquets of the ticket types that may watch it.
  2. Enable catch-up so an attendee who missed the start of a session can rewind.
  3. Check before the first session that the venue node takes each stage once from the origin and that the screens are routed to it.

Expiry

Access ends with the event.

  1. Give every ticket package a duration that ends with the last day of the event, so the lines lapse without any work.
  2. Extend one line, or issue a short-lived code, for a speaker or a late sponsor instead of making a new package.
  3. Disable a lost or shared ticket's line from Lines; the audit log keeps the record.

Integration with ticketing

Systems drive access; the player plays.

  1. The ticketing or registration system creates lines through the Reseller API and listens to webhooks such as line.created and line.expired.
  2. Online ticket sales on a supported commerce platform use its connector; there is no native connector for a specific ticketing product.
  3. There is no single sign-on for viewers: an attendee signs in to the player with the credentials of the line or with an activation code.

Security considerations

A ticket is one person.

  1. Serve the panel and the playback base URL over TLS and set TRUSTED_PROXIES to your reverse proxy.
  2. Two-factor sign-in for every panel account, and permission groups so the ticketing desk cannot change the stages.
  3. Signed and expiring playback links and a low connection limit per ticket.
  4. Encrypted database backups with an off-site copy, and the audit log for every change of lines and stages.

Troubleshooting

The usual first checks.

  1. An attendee cannot open a stage: check the line's package, the bouquet that holds the stage, and the expiry date.
  2. A stage freezes in the room but not online: check the venue node's heartbeat and the screens' route to it.
  3. An activation code is refused: check that it has not been used already and that its package is still valid.
  4. The audit log shows the proxy's address: set TRUSTED_PROXIES to the proxy and restart the panel.