Documentation

SIVO documentation

From the one-line install to subscribers watching in their apps.

Quick install

A panel in minutes, from one command.

Run it as root on a fresh Ubuntu 24.04 or 26.04 server (x86_64) inside your network.

Read the full installation guide
Ubuntu — bash
curl -fsSL https://sivo.securytik.com/install.sh | sudo bash

Getting started

Overview

SIVO is an IPTV platform you run on your own server inside your network. It pulls each live channel from the Internet once and serves it to every subscriber who watches it, so the uplink cost of a channel does not grow with its audience. Movies, series and catch-up recordings live on the same server.

Subscribers watch in the apps they already use: IPTV Smarters, TiviMate, VLC, smart-TV apps. SIVO speaks the Xtream Codes API and M3U, so you only send them a server address, a username and a password, or one M3U link.

  • The panel (port 80) is where you manage channels, content and subscribers.
  • The streaming door (port 8080 by default) is what the apps connect to; every request on it is checked: account enabled, not expired, package allows the channel, devices at once.

Getting started

Requirements

  • Ubuntu 24.04 or 26.04, x86_64 (amd64). ARM and Docker are not supported.
  • 4 CPU cores and 8 GB RAM for a few hundred viewers; more viewers need more network than CPU, since channels are copied, not re-encoded.
  • Disk for the library and catch-up: a film is 1 to 20 GB, a catch-up day of one HD channel about 30 to 40 GB.
  • A network path from the Internet for pulling channels, and from your subscribers to the server.

Getting started

Installation

Run as root on a fresh server:

curl -fsSL https://sivo.securytik.com/install.sh | sudo bash

The installer downloads the latest signed release (from GitHub, or the dl.securytik.com mirror when GitHub is blocked), installs PostgreSQL, the streaming engine, nginx and the panel, and prints the admin password at the end. Re-running it is safe: it keeps your data and settings.

Getting started

First login

Open http://SERVER-IP/admin/ and sign in as admin with the password the installer printed. Change it from your profile.

  • Settings → Streaming: set the public address subscribers use (for example http://tv.example.net:8080). It goes into every login and M3U link.
  • Live channels → Starter channels: adds the free channels broadcasters stream themselves.
  • System → Licence: register the install with your SecuryTik account (Free covers 100 users).

Getting started

Streaming settings

  • Public address and port: what apps connect to.
  • Quality pulled from sources: best available, or a cap (1080p, 720p, 576p, 480p) when your Internet line is small.
  • Idle connections end on their own after the timeout you set.
  • Media folder: where movies, series and catch-up are stored.

Content

Live channels

Add a channel with its source address (HLS, RTMP, RTSP, SRT, UDP) and an optional backup source. A channel on demand starts when the first viewer opens it and stops a minute after the last one leaves; turn on-demand off for channels that must always run.

  • State: streaming, idle, or no-signal screen (the source does not answer; viewers see your screen).
  • Number, category, logo and guide ID are what the apps show.
  • Import M3U adds many channels at once from a file or an address.

Content

No-signal screen

When a source does not answer, viewers see SIVO's screen instead of an app error, and the picture replaces it by itself when the source comes back. Change its two lines of text, or upload your own image, in Settings → No-signal screen.

Content

Sources and imports

Sources holds provider accounts (Xtream Codes) that you hold the rights to. Add the server, username and password; SIVO checks the login and reads the account's live channels, movies and series. What you add is your responsibility: see the Terms and Policy.

  • Open an account, filter by type or category, search, tick the titles you want and choose Import selected.
  • Movies and episodes are downloaded to your server through one queue, one file at a time, so an account that allows one connection is never used twice. They appear in the apps once downloaded.
  • A series is imported with every season and episode the provider has, with posters and story.
  • Live channels imported from an account are pulled from it while someone watches; each channel watched at the same moment uses one of the account's connections.

Only import content you have the right to distribute.

Content

Mobile

  • Upload a file, or give its address and choose Store on this server to download it.
  • Status shows queued, downloading with its percentage, ready or error.
  • Story, cast, director, poster and backdrop by hand or from TMDB (add a TMDB key in Settings).
  • Add audio languages and subtitle files; SIVO puts them into one file so apps list them in their menus.

Content

Series

  • Series → a series → its seasons → a season's episodes; each level is a list you can search, sort and act on in bulk.
  • Files named S01E01, S01E02… get their season and episode numbers by themselves.
  • Season names, stories and posters are shown in the apps.

Content

Catch-up

Set Catch-up days (1 to 30) on a channel. SIVO records it in 10-second pieces, the apps offer the past programmes from the guide, and recordings older than the setting are removed. Recordings shows each channel's disk use.

Content

TV guide

Add XMLTV guide addresses in TV guide. They are fetched every 6 hours and matched to channels by guide ID. Subscribers' apps get the guide with their own link.

Subscribers

Packages

A package opens chosen categories of channels, movies and series. A subscriber with no package sees everything.

Subscribers

Subscribers

  • Username and password (used in the app), full name, phone, package, expiry and devices at once.
  • Access shows the server, login, M3U and guide links to send.
  • Extend adds days from today or from the current expiry, whichever is later; Disable ends what the subscriber is watching.
  • Each new subscriber counts toward the licence's user limit.

Subscribers

Apps and links

In IPTV Smarters, TiviMate and most apps choose Xtream Codes and enter the server address, username and password. Apps that only take a playlist use the M3U link from Access.

http://tv.example.net:8080/get.php?username=USER&password=PASS&type=m3u_plus&output=ts

Subscribers

Watching now

Watching now lists every open connection: subscriber, channel or title, device and address. End one from its menu; a subscriber over his devices at once is refused the next stream.

Operating

Search, filters & export

  • Type in the search box to filter the rows; press Enter to keep it as a token.
  • The menu beside the box has filters, Group by, saved searches and custom filters.
  • Tick rows for bulk actions; Export downloads CSV.

Operating

Admins & roles

Add admins with roles that choose what they can see and change. Two-factor login is available per admin, and every change is in the audit log.

Operating

Backup & restore

Tools → Backup takes a backup of the database and settings (the media library is not inside it; copy your media folder separately). Restore from the same page.

Operating

Updates

Updates are signed by SecuryTik and checked before they are applied. System → Updates shows the current and latest version; updates can be applied by hand or automatically.

Operating

Licensing & plans

Each install is licensed on its own by the number of users (subscribers). An install that is not registered serves up to 25 users; registered on Free, 100. Paid plans: Lite 500, Plus 1,000, Pro 2,000, Mega 5,000, Max 10,000 and Unlimited. See Pricing.

Request a plan from System → Licence or from your dashboard; the first request on an account is a free month. If a paid licence lapses there is a warning, then a grace period; no data is ever deleted.

Operating

Cloudflare Tunnel

System → Cloudflare Tunnel puts the panel (and, if you choose, the streaming door) on your own domain over HTTPS without opening ports.

Reference

REST API

System → API creates tokens with scopes. The API manages subscribers (create, change, extend, enable, disable, delete, access links), packages, channels, movies, series, who is watching and totals. The full reference with a Try it button is on your install at /api/v1/docs.

curl -H "Authorization: Bearer sivo_YOUR_TOKEN" http://SERVER/api/v1/subscribers

Reference

Webhooks

System → API → Webhooks sends subscriber.created, subscriber.updated and subscriber.deleted to your address as JSON, signed with X-Sivo-Signature: sha256=HMAC of the body. Failed deliveries are retried.

Reference

Troubleshooting

  • A channel shows the no-signal screen: its source does not answer from your server; open the channel's menu and Test it.
  • A channel opens slowly or stutters: the source's quality is higher than your Internet line allows; set a quality cap in Settings → Streaming.
  • An app says the login is wrong: check the public address in Settings and that the subscriber is enabled and not expired.
  • Too many devices: the subscriber's devices at once is reached; end an old connection in Watching now.