XC_VM IPTV Panel
Open-source, community-driven Xtream Codes panel
Built for modern IPTV workflows โ powerful, scalable, and free.
---
# ๐ Table of Contents
๐ Contents
* ๐ [Overview](#-overview)
* โ ๏ธ [Status](#๏ธ-status)
* ๐ [Documentation](#-documentation)
* ๐ [Migration Guide](#-migration-guide)
* ๐งฑ [Technology Stack](#-technology-stack)
* ๐งฉ [Supported OS](#-supported-operating-systems)
* ๐ฅ [Quick Install](#-quick-install)
* ๐งฐ [Service Management](#-service-management)
* ๐ [Project Structure](#-project-structure)
* ๐งฎ [Server Requirements & Sizing](#-server-requirements--sizing)
* โญ [Features](#-features)
* ๐ [Known Limitations](#-known-limitations)
* ๐ค [Contributing](#-contributing)
* โ ๏ธ [Legal & Licensing Notice](#๏ธ-legal--licensing-notice)
* ๐ [License (AGPL-3.0)](#-license-agpl-30)
---
## ๐ Overview
**XC_VM** is an open-source IPTV platform based on Xtream Codes.
It enables:
* ๐บ Live & VOD streaming
* ๐ Load balancing
* ๐ Full user/reseller control
* ๐๏ธ Transcoding & EPG
* ๐ Hardened security fixes
> โ
100% free. No license checks. No server locks.
---
## โ ๏ธ Status
> **BETA SOFTWARE** โ actively developed
---
## ๐ Documentation
* ๐ฌ๐ง **English Guide**
[https://vateron-media.github.io/XC_VM/](https://vateron-media.github.io/XC_VM/)
* ๐ท๐บ **ะ ัะบะพะฒะพะดััะฒะพ ะฝะฐ ััััะบะพะผ**
[https://vateron-media.github.io/XC_VM/ru/](https://vateron-media.github.io/XC_VM/ru/)
---
## ๐ Migration Guide
Migrating from Xtream Codes / XUI.one? Follow the step-by-step migration guide:
* ๐ **Migration Guide**
[https://vateron-media.github.io/XC_VM/info/migration_guide/](https://vateron-media.github.io/XC_VM/info/migration_guide/)
---
## ๐งฑ Technology Stack
| Component | Version | Description |
| --------- | ---------- | ------------------------------- |
| PHP | 8.1.33 | Backend runtime |
| Nginx | 1.24 | Web server & reverse proxy |
| FFmpeg | 8.0, 7.1, 4.0 | Media transcoding & processing |
| MariaDB | 11.4 | SQL database engine |
| KeyDB | 6.3.4 | Cache & session storage (Redis) |
---
## ๐ง Supported Operating Systems
XC_VM supports multiple Linux distributions. Distribution-specific binaries (PHP, Nginx) are downloaded automatically from [XC_VM_Binaries](https://github.com/Vateron-Media/XC_VM_Binaries) during installation.
### Ubuntu
| Version | Codename | Status |
| --- | --- | --- |
| **20.04** | Focal Fossa | โ ๏ธ *Outdated* โ installation possible, but some packages may need to be installed manually |
| **22.04** | Jammy Jellyfish | โ
**Recommended** |
| **24.04** | Noble Numbat | โ
**Recommended** |
### Debian
| Version | Codename | Status |
| ---------- | ---------- | --------------------- |
| **11** | Bullseye | โ
Supported |
| **12** | Bookworm | โ
**Recommended** |
| **13** | Trixie | โ
Supported |
### RHEL-compatible (Rocky Linux, AlmaLinux, CentOS, RHEL)
| Version | Status |
| ------- | ------------------ |
| **8** | ๐ง *Not yet supported* |
| **9** | ๐ง *Not yet supported* |
> โ ๏ธ RHEL-family support is planned but not yet available. The installer recognizes these distributions, but pre-built binaries are not provided yet.
---
### ๐ก Recommendations
For new installations:
* ๐ข **Ubuntu 22.04 / 24.04 LTS**
* ๐ข **Debian 12**
> โ ๏ธ Ubuntu 18.04 is in legacy mode โ it works but receives no priority fixes.
---
## ๐ฅ Quick Install
> โ
Ubuntu 22.04+, Debian 11+
```bash
# 1. Update system
sudo apt update && sudo apt full-upgrade -y
# 2. Install dependencies
sudo apt install -y curl wget python3 unzip
# 3. Download latest release
latest_version=$(curl -s https://api.github.com/repos/Vateron-Media/XC_VM/releases/latest | grep '"tag_name":' | cut -d '"' -f 4)
wget "https://github.com/Vateron-Media/XC_VM/releases/download/${latest_version}/XC_VM.zip"
# 4. Unpack and install
unzip XC_VM.zip
sudo python3 install
```
### ๐งช Beta Install
To install the latest **beta** (pre-release) version:
```bash
# 1. Update system
sudo apt update && sudo apt full-upgrade -y
# 2. Install dependencies
sudo apt install -y curl wget python3-pip unzip
# 3. Download latest beta release
beta_version=$(curl -s https://api.github.com/repos/Vateron-Media/XC_VM/releases | grep -m1 '"tag_name":' | cut -d '"' -f 4)
wget "https://github.com/Vateron-Media/XC_VM/releases/download/${beta_version}/XC_VM.zip"
# 4. Unpack and install
unzip XC_VM.zip
sudo python3 install
```
> โ ๏ธ Beta versions may contain unstable features. Use on test servers only.
---
## ๐งฐ Service Management
```bash
sudo systemctl start xc_vm # Start
sudo systemctl stop xc_vm # Stop
sudo systemctl restart xc_vm # Restart
sudo systemctl status xc_vm # Status
sudo /home/xc_vm/bin/nginx/sbin/nginx -s reload # Reload Nginx config
journalctl -u xc_vm -f # Live logs
```
---
## ๐ Troubleshooting โ Panel Won't Start
If the panel fails to start, check the following logs and commands:
**Nginx error log:**
```bash
cat /home/xc_vm/bin/nginx/logs/error.log
```
**PHP-FPM log:**
```bash
cat /home/xc_vm/bin/php/var/log/php-fpm.log
```
**Verify PHP binary works:**
```bash
/home/xc_vm/bin/php/bin/php -v
```
> If PHP fails to run, the panel cannot start at all โ fix PHP issues first before investigating Nginx.
---
## ๐ Project Structure
```text.
โโ docs/ # ๐ Project documentation
โโ lb_configs/ # โ๏ธ Configurations for building Load Balancer (LB)
โโ src/ # ๐ป Main project code
```
---
## ๐งฎ Server Requirements & Sizing
### ๐ง Minimum Specs
| Component | Recommendation |
| --------- | ----------------------------- |
| CPU | 6+ cores (Xeon/Ryzen) |
| RAM | 16โ32 GB |
| Disk | SSD/NVMe, 480+ GB |
| Network | Dedicated 1 Gbps port |
| OS | Ubuntu 22.04+, Debian 12+ (clean install) |
---
### ๐ Planning Formulae
* **Bandwidth (Mbps)** = Channels ร Bitrate
* **Max Users** = Bandwidth รท Stream Bitrate
```text
Example:
HD bitrate = 4 Mbps
1 Gbps = ~940 usable Mbps
โ Max Channels: 940 รท 4 = ~235
โ Max Users: 940 รท 4 = ~235
```
> โ ๏ธ 10 users watching the same channel = 10ร bandwidth (unless caching or multicast used)
---
### ๐ป RAM & CPU Usage
| Resource | Load per Stream |
| ---------------- | --------------- |
| RAM | 50โ100 MB |
| CPU (transcoded) | ~1 core |
---
## โ
Features
* โ
No server restrictions
* โ
EPG importer
* โ
VOD management
* โ
User/reseller panel
* โ
Security patches
* โ
Clean UI
---
## ๐ง Known Limitations
* โ Requires Linux knowledge
* โ Community-based support
* โ Some bugs in transcoding module (in progress)
---
## ๐ค Contributing
We welcome community help!
* ๐ ๏ธ [Contributing Guide](CONTRIBUTING.md)
* ๐ฅ [Contributors List](CONTRIBUTORS.md)
---
### โ ๏ธ Legal & Project Independence Notice
**XC_VM** is an independent software project and is **not affiliated with or endorsed by XUI.one**.
All backend systems, core logic, and infrastructure of XC_VM have been **independently developed** without using source code from XUI.one or related projects.
The administrative interface (UI/UX) is **inspired by general industry practices and partially by XUI.one in terms of usability concepts only**.
No proprietary source code or protected assets have been intentionally reused.
---
### ๐ License Enforcement (AGPL-3.0)
XC_VM is distributed under the **GNU Affero General Public License v3.0 (AGPL-3.0)**.
Under this license:
* Redistribution or modification is permitted **only under the same license (AGPL-3.0)**
* Any modified version **must remain open-source**
* Providing XC_VM as a service **requires making the source code available**
* **Copyright and attribution must be preserved**
Any attempt to redistribute this software under a different license, remove attribution, or obscure the origin of the project constitutes a violation of the license terms.
> โ๏ธ You are solely responsible for how it is used.
> We take no responsibility for misuse or illegal deployments.
---