Device Management
How CASTOVIA connects physical devices to subscriptions — no model knowledge needed, no firmware updates, just a MAC address.
Supported Device Types
MAG Boxes
MAG 250, 254, 322, 324, 420, 424, etc.
Formuler Boxes
Z8 Pro, Z10 Pro, Z11 Pro, GTV, etc.
Android TV / STB
Any Android TV box with IPTV app
Enigma2 / Linux STB
Dreambox, VU+, and similar
How MAC Matching Works
The entire flow is beautifully simple. No login screens, no credentials, no configuration files on the box. Here's exactly what happens:
Read the MAC Address
Every Set-Top Box has a unique MAC address burned into its hardware at the factory. You'll find it on a sticker on the bottom or back of the device (format: 00:1A:79:xx:xx:xx).
The MAC address is permanent and cannot be changed. It uniquely identifies this specific physical device.
Register in Admin Panel
In Admin → Devices, click "Add Device" and enter the MAC address. Assign it to a subscriber line (subscription). That's all you need — no device model, no firmware version, no technical details.
You can also bulk-import MACs via CSV for large deployments.
Set Portal URL on Box
On the box itself, there's ONE setting to configure: the Portal URL. Enter your domain (e.g., http://tv.yourdomain.com). This is the only configuration the box needs — ever.
Many operators pre-configure this on boxes before shipping to customers, so the end user has zero setup.
Box Connects Automatically
When the box starts up, it sends an HTTP request to the Portal URL and includes its MAC address in the request. CASTOVIA looks up the MAC in the database, finds the matching subscription, and delivers the channel list, EPG data, and VOD catalog.
The box doesn't "know" anything about its configuration. It just announces its MAC and the server does the matching.
Subscriber Watches TV
The end user sees their channels, EPG guide, and VOD library — branded with your identity. They have no idea CASTOVIA exists behind the scenes. It's your brand, your service.
The Connection Flow
Box Powers On
Reads its MAC
Contacts Portal URL
Sends MAC in request
Server Lookup
Finds matching subscription
Delivers Content
Channels, EPG, VOD
Why MAC-Based > Username/Password
Traditional panels like XUI.ONE use username/password authentication. Here's why MAC-based is superior for STB devices:
No Account Sharing
One MAC = one physical device. A MAC address can't be shared like a username/password can.
Instant Device Swap
Subscriber's box breaks? Enter the new box's MAC in the panel, old one deactivated instantly. Done in 10 seconds.
Zero End-User Setup
The subscriber plugs in the box, connects to WiFi — that's it. No login screens, no passwords to forget.
Automatic Deactivation
Remove a MAC from the panel → the box can't connect anymore. No remote wiping or complex deprovisioning.
Username/Password Also Supported
CASTOVIA also supports traditional username/password lines for app-based subscribers (Android, iOS, web players). MAC-based management is specifically for STB/MAG-type devices where the hardware identity replaces credentials.