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.