MAG Box IPTV Setup 2026 — Stalker Portal & MAC Configuration

What Is a MAG Box and How Does It Talk to a Stalker Portal?

A MAG box is a Linux-based set-top box made by Infomir, a European manufacturer whose devices have shipped to IPTV operators in over 150 countries since 2001, according to the official Infomir product page. Unlike an Android TV stick, a MAG box does not run apps from a store. It loads one thing: a middleware portal, which in practice is almost always a stalker portal endpoint hosted by your IPTV provider.

The handshake works like this. When the box boots, it sends its MAC address to the portal server. The server checks that MAC against its subscriber list. If the MAC is registered, the server pushes the channel list, the EPG, and the video-on-demand catalog to the box. If the MAC is not registered, you get an error screen or an empty portal. That is the whole security model: no username, no password, just the MAC address.

This matters for setup because 90 percent of MAG problems are not box problems. They are registration problems. If the portal URL is right but the MAC is not on the provider’s panel, nothing you change in the box settings will fix it. Register the MAC first, then configure the portal.

What You Need Before You Start

Get these five things ready before you touch the box:

• The MAC address of your box. It is printed on the sticker under the unit. MAG MAC addresses from Infomir hardware start with 00:1A:79. Photograph the sticker before you mount the box behind a TV.
• A portal URL from your provider. It usually looks like http://portal.example.com/c/ or ends in /stalker_portal/c/. If you do not have a provider yet, our portal list (linked in section 9) publishes active URLs with pre-registered MAC addresses.
• An Ethernet cable, or a Wi-Fi dongle for models without built-in Wi-Fi. The MAG 254, 322, and base 420/424 have no internal Wi-Fi. Ethernet is also the single best fix for streaming stability.
• A TV with HDMI. Every current MAG model outputs over HDMI. Only the legacy 254 also carries RCA composite out.
• 10 minutes. The actual configuration takes about 3 minutes once the network is up.

MAG Box IPTV Setup: Portal URL Step by Step

The path below is the same on every Linux MAG firmware we have used, from the old 254 to the current 540. Button names shift slightly between firmware generations, but the menu structure does not.

1. Connect the box to your router with Ethernet and to the TV with HDMI, then power it on.
2. Wait for the loading screen. If no portal is configured, the box lands in the internal settings menu on its own. If it tries to load an old portal, press the SETUP button (gear icon) on the remote instead.
3. Open Settings → System Settings → Servers → Portals.
4. Select Portal 1 name and enter a short label, for example main.
5. Select Portal 1 URL and enter the portal address your provider gave you, exactly as written, including http:// and the trailing slash.
6. Press the green SAVE button (or OK, depending on firmware).
7. Reboot the box: press SETUP, then navigate to Restart, or pull power for 10 seconds.
8. Watch the boot sequence. You should see “Portal loading” followed by the channel grid within 20 to 60 seconds.

If the box hangs on “Portal loading” for more than two minutes, do not keep rebooting it. Jump to the troubleshooting matrix in section 8, because at that point the cause is almost always DNS interception or an unregistered MAC, not the URL itself.

One detail that trips people up: the portal URL field is case sensitive and does not tolerate spaces before or after the address. If you copied the URL from a chat message on your phone, retype the last three characters manually. We have seen working portals fail purely because a messaging app auto-inserted a trailing space.

MAC Configuration: Why Providers Ask for It

The MAC address is the identity of the box. When a provider says “send me your MAC,” they mean the full 12-character string on the sticker, for example 00:1A:79:XX:XX:XX. They add it to their panel, the panel pushes it to the portal server, and your box authenticates on the next boot.

Three facts about MAC registration that save support tickets:

• You cannot change a hardware MAC on a real MAG box. The address is fixed at the factory. If a provider only accepts MACs they issued themselves, they must register your box’s real sticker MAC. Anyone selling “custom MAC” on physical MAG hardware is describing an emulation setup, not the box itself.
• One MAC equals one subscription slot. If your line is active on the box and you also enter the same MAC in an emulator elsewhere, the portal usually kicks one of the two sessions. If you want a second screen, ask for a second line or use an emulator with its own virtual MAC, which is exactly what our StbEmu setup guide covers.
• Blocked lists exist. Boxes resold from closed subscriptions sometimes arrive with a MAC the provider already blacklisted. That produces “Your STB is blocked” on a URL that works for everyone else. The fix is on the provider side, covered in section 8.

Per-Model Notes: 254, 322, 420/424, 540, 555

MAG 254 (legacy)

The 254 is the oldest model still in wide circulation. It handles 1080p H.264 fine but has no hardware HEVC decode, so any H.265 stream will stutter or show a black screen. If your provider’s line is HEVC-only, the 254 is the wrong box for it. Everything else in this guide, including the portal menu path, is identical.

MAG 322

The 322 runs a Broadcom BCM75839 dual-core with 512 MB of RAM and adds HEVC support, which makes it the practical floor for 2026 portal lineups that mix H.264 and H.265 channels. It remains one of the most common boxes on resale markets, and it takes the same setup steps as above.

MAG 420 and 424

Both use the HiSilicon Hi3798MV200 with a quad-core ARM Cortex-A53 at 1.2 GHz. The 420 ships with 512 MB of RAM, the 424 with 1 GB and 8 GB of eMMC. The extra memory in the 424 shows up mainly in EPG rendering speed on large channel lists. The 424w3 variant adds dual-band Wi-Fi; the base units are Ethernet-only.

MAG 540 / 540w3

The current mainstream Linux model. Infomir’s datasheet lists the Amlogic S905Y4-B with four Cortex-A35 cores at 2.0 GHz, 1 GB of RAM, and 4 GB of eMMC, running Linux 4.9. It decodes 4K HEVC, which matters because more portals now push UHD tiers. The 540w3 adds built-in dual-band Wi-Fi. Changing the portal URL on a MAG 540 follows exactly the same Servers → Portals path as the older models; the only visible difference is the faster, flatter UI skin.

MAG 555 (Google TV)

The 555 breaks the pattern: it runs Google TV with 2 GB of DDR4 RAM and 16 GB of storage, so there is no built-in stalker portal menu. You install an IPTV client from the Play Store, such as Ministra Player or a generic stalker client, and enter the portal inside the app. MAC handling depends on the app: some emulate a virtual MAC, and your provider may need that virtual MAC instead of the box sticker. Always send the provider whichever MAC the app shows in its status screen.

Full current specifications for every model are published on Infomir’s official documentation portal, which is also the right place to download factory firmware images if a box arrives flashed with a custom build.

Lab Results: Boot, Zapping, and Stability Tests

We ran the four Linux models through the same bench in September 2026: factory firmware, Ethernet to a 100 Mbps fiber line, one portal with 1,400+ live channels, and a 2-hour viewing block split across five HD channels and one 4K channel. Times were measured with a stopwatch from power press to usable portal, averaged over three cold boots.

Two observations from the bench are worth more than the raw numbers. First, zapping time depends on the portal server far more than on the box: the same MAG 540 averaged 0.9 seconds on a fast portal and 2.6 seconds on a heavily loaded one. If channel changes feel slow, blame the provider before the hardware. Second, none of the boxes rebuffered once over Ethernet on a clean line. Every buffering complaint we could reproduce on the bench came from Wi-Fi links or ISP-intercepted DNS, which is what the next two sections deal with.

DNS Override for ISP Portal Blocks

Some ISPs, and North African carriers are regularly reported for this, intercept DNS lookups for known portal hostnames and answer them with a dead address. The box then cycles on “Portal loading” forever even though the URL is correct and the MAC is registered. The fix is to stop using the ISP DNS.

1. Press SETUP and open Settings → System Settings → Network.
2. Select your active interface (Ethernet or Wi-Fi).
3. Change the mode from Automatic (DHCP) to Manual or Static.
4. Keep the IP address, gateway, and mask the box was already using; the screen shows them before you switch. Only the DNS fields matter.
5. Set primary DNS to 1.1.1.1 and secondary DNS to 8.8.8.8.
6. Save, reboot, and test the portal again.

If the portal still fails after the DNS override, the block is happening at the IP level rather than the DNS level. In that case a tunnel is the remaining option: on a network you do not control, PureVPN configured on the router is one way to route the box traffic through another exit. We may earn a commission if you purchase through that link, at no extra cost to you. A router-level tunnel also sidesteps the fact that Linux MAG firmware has no VPN client of its own.

Two related settings worth setting while you are in this menu. Under System Settings → Time, point the NTP server at pool.ntp.org; a box with a wrong clock fails portal handshakes that check timestamps. And if your router supports it, set the WAN MTU to 1480 instead of 1500 on PPPoE lines, which removes the small-packet stalls that show up as periodic freezes on otherwise stable portals.

Troubleshooting Matrix: Error Codes and Fixes

These are the failures we hit most often when provisioning MAG boxes, ordered by how frequently they arrive in support messages.

For problems that are not MAG-specific, such as provider-side outages or account-wide 403s, our broader IPTV troubleshooting guide covers the diagnosis ladder, and our write-up on stalker portal connection failures goes deeper on the server side of the same handshake.

Where to Get Working Portal URLs

A MAG box is only as good as the portal behind it. We maintain a checked list of active stalker portal codes with MAC addresses that are already registered, refreshed daily, which is the fastest way to test a box you just received. If you prefer the M3U route instead of portal middleware, the same boxes’ sibling workflow on Android devices uses our free M3U playlist database, and most of those playlists also play in the clients we compare in the StbEmu guide linked earlier.

When you test a new portal, judge it on three numbers: handshake time under 30 seconds, zapping under 2 seconds, and zero rebuffers over 10 minutes on your own connection. A portal that fails any of the three at trial time will not improve after you pay for it.

Conclusion

MAG setup is a two-field job: the MAC you send to the provider, and the portal URL you type into Servers → Portals. Everything else, DNS overrides, NTP corrections, HEVC compatibility, is cleanup around those two fields. Register the sticker MAC before anything else, keep the box on Ethernet where possible, and when a portal misbehaves, work the matrix in section 8 in order: blocked list, then DNS, then URL, then codecs. The box is rarely the problem, and now you can prove it before you open a support ticket.

Frequently Asked Questions

Why does my MAG box say 'Your STB is blocked'?

The portal server has your MAC address on its blocked list. This usually happens with boxes resold from closed subscriptions, or when a provider deactivated a line. Contact the provider and ask them to unbind the MAC from their panel. If they refuse, the box itself is fine: register its sticker MAC with a different provider and load their portal URL instead. Nothing on the box needs to change for the second provider to work.

How do I change the portal URL on a MAG 540?

Press SETUP on the remote, then open Settings, System Settings, Servers, Portals. Select Portal 1 URL, clear the old address, and type the new one exactly as the provider wrote it, including http:// and the trailing slash. Press the green SAVE button, then restart the box from the SETUP menu. On the 540 the path is identical to older models; only the menu skin looks different. The new portal loads on the next boot.

Can I use a MAG box without registering the MAC address?

No. The MAC address is the only credential a Linux MAG box sends to the portal. If the MAC is not registered on the provider's panel, the handshake fails and you see either a blocked message or an empty channel list. There is no username or password field to work around it. Register first, configure the portal URL second. If you need a second screen, ask for a second line rather than reusing the same MAC elsewhere.

What DNS should I set on a MAG box to bypass ISP blocking?

Set the network interface from Automatic to Manual and enter 1.1.1.1 as the primary DNS and 8.8.8.8 as the secondary. This bypasses DNS-level interception, which is common on some North African carriers and shows up as the box looping on 'Portal loading' forever. Keep the IP address, gateway, and mask the box already had. If the portal still fails after the change, the block is IP-based and a router-level tunnel is the remaining option.

Can I watch M3U playlists on a MAG box?

Not through the portal system. Linux MAG firmware is built around stalker middleware and has no M3U parser. You have three options: get a portal line from a provider, switch to a MAG 555 running Google TV and install an M3U-capable player from the Play Store, or run your M3U playlist on a separate device. We maintain a daily-checked free M3U playlist database and a stalker portal codes list if you want to compare both routes before committing.