How to set up a MAG IPTV box with a portal URL

By Castro Jones · Last updated November 17, 2026 · 4 min read

A MAG box works differently from every other device on this site. There is no app to install and no playlist to paste. You enter a portal address, and your provider must register the box before anything appears.

MAG IPTV set-top box above the words How to setup IPTV on MAG BOX

Give your provider the box's MAC address, enter the portal URL they send under Settings → System Settings → Servers → Portals, then reboot. Nothing works until the provider has registered that MAC address, because the portal is matched to the box, not to an account.

What you need to know

  • A MAG box uses a portal URL, not an M3U playlist or an app.
  • The provider must register the box's MAC address before the portal loads.
  • The MAC address is on the sticker under the box and usually starts with 00:1A:79.
  • The portal goes in Settings → System Settings → Servers → Portals.
  • The box reads the portal only when it starts, so reboot after saving.
  • A new box needs a new registration, because the MAC address is the account.

How is a MAG box different from other IPTV devices?

Other devices load a playlist you hold. A MAG box loads a portal the provider holds, and identifies itself by its hardware address.

Playlist deviceMAG box
You supplyAn M3U URLOnly the box's MAC address
Provider suppliesA linkA portal, registered against your MAC address
Changing providerPaste a new URLThey register the box, and you enter their portal
InterfaceWhatever app you choseFixed, from the portal

There is nothing for the household to set up and nothing to mistype. The cost is that you get whatever interface the provider's portal gives you.

How to set up a MAG box in 6 steps

Send the MAC address to your provider, enter their portal URL in the Portals screen, save, and reboot.

  1. Find the MAC address

    It is on the sticker under the box, and under Settings → System Settings → About. It is six pairs of characters, usually starting 00:1A:79.

  2. Send it to your provider

    Do this first. They register it against your subscription and send back a portal URL. Send it to us here if you are with HakunaXTR.

  3. On the box, open Settings

    It is the gear icon on the main menu.

  4. Go to System Settings → Servers → Portals

    This is the only screen you need.

  5. Enter a name and the Portal URL

    Choose any name. Enter the URL exactly as the provider sent it, including any /c/ or /stalker_portal/ at the end.

  6. Save, then reboot the box

    Restart it fully. Exiting the menu is not enough, because the portal loads only when the box starts.

The MAC address is the account

It is tied to the hardware. A replacement box needs a new registration, and copying a MAC address onto another box is how people get cut off by a provider.

Which MAG box should you buy?

If you already own a MAG box, use it. If you are buying one now, choose a 4K model such as the MAG 420/424 or 540/544.

ModelNotes
MAG 250 / 254The classic. Still widely supported, SD and HD only, no 4K
MAG 322 / 324The common middle ground, HD, built-in wifi on the W1 variants
MAG 420 / 4244K capable, the sensible choice if buying now
MAG 540 / 544Current generation, 4K, faster interface

If you are buying for IPTV only, a MAG box does less than a streaming stick. It does one job and runs nothing else.

Why won't the MAG portal load?

Usually because the provider has not registered the MAC address yet. The box shows no error that says so. Check these in order:

  1. The provider has not registered the MAC address. The portal does not appear, and there is no error message.
  2. The portal URL is incomplete. A missing /c/ or trailing slash stops it, so compare it character by character with what you were sent.
  3. The box was not rebooted. Saving the portal is not enough, because the box reads it at startup.
  4. The box has no network. Check Settings → System Settings → Network. A MAG box on weak wifi in another room is a common cause you cannot see.

For anything else, see the general troubleshooting guide.

Frequently asked questions

How do I set up IPTV on a MAG box?

Send your provider the box's MAC address so they can register it. Then go to Settings → System Settings → Servers → Portals, enter the portal URL they sent, save and reboot. There is no app to install and no playlist to paste.

Where is the MAC address on a MAG box?

On the sticker underneath, and under Settings → System Settings → About. It is six pairs of characters and usually begins 00:1A:79.

Why is my MAG portal not loading?

Usually because the provider has not registered the MAC address yet, and the box shows no error to tell you. After that, check for an incomplete portal URL, a box that was saved but not rebooted, or no network connection.

Can I use a MAG box with any provider?

No, only with providers that support portals, which is most but not all. They must register your MAC address and give you a portal URL. A plain M3U playlist does not work on a standard MAG box.

Is a MAG box worth buying in 2026?

Only if you want a dedicated, single-purpose device. It does one job reliably, but it runs nothing else and ties you to the provider's interface. A streaming stick usually costs less, does more, and lets you choose your own player.

Ready to start watching?

A 24-hour trial, set up in a few minutes on the device you already own.