For portal admins – how to make your Portal compatbile with Smart STB app.

Important message: 

This article is meant for the IPTV Provider (or Portal admin) to do to make sure their Portal settings are correct for our app.

We can help your IPTV Provider (or Portal admin) to get the settings right (on best effort basis) however making those changes is entirely up to the Provider.

A capable system administrator can easily perform all the steps below however not all Portal admins have the needed (root) access (to the Portal servers). Also Portal resellers have limited access.

We have no access or control over any Portals or streams and we do not provide any streaming services!

We recommend your users to use SmartSTB+ if it’s available on their platform, however due to OS and hardware limitations this app is not available on all platforms. 
The SmartSTB+ (plus) app connects directly to the Portal or Playlist. Usually there is no need to adjust the portal settings however in some cases some portals may not be fully compatible. You can also use m3u playlist with support for TV logos, EPG and categories for the TV channels. 
As of now SmartSTB+ is available on devices in all regions running Android 9 or newer including Android TV and Google TV. FireTV and Firestick support coming soon.

Cloudflare users – please check the end of the article for specific instructions

Dear Service Providers,

In order to guarantee smooth service and avoid compatibility problems we recommend you white list (or unlock in case of blocked) our Server IP’s in your Panels, Streaming Servers and Billing Servers.

The application works by connecting to your portal thru our app servers.
So app users may appear connecting to the Portal from our app servers’s IP (depending on region and availability, see the IP’s below)
We pass smart TV’s public IP via X-Forwarded-For header, please see below!

Smart TV’s always access any streaming links directly (from the TV’s Public IP address, we never proxy any streaming traffic!).

Please make sure you “read” the Public IP address of each TV by reading “X-Forwarded-For” headers coming from our app users.
This way you will always have the Smart TV’s public IP address and make the app compatible with your Portal.
Some popular middleware solutions are  doing this automatically.

Doing this is strongly recommended, it will fix possible black screen problems with your portals too.
Please do not forget to do this on all your Portal servers, streaming servers, time shift servers, recording (npvr), archive and catchup servers, billing servers and everything associated with your service. 
Otherwise, for example, if you don’t do it on your Time shift/recording servers, then Time shift  may not work for the Smart STB users.
Other example case: app may not remember the username and password if it’s blocked on the authentication server but not blocked on the Portal.

Properly unblocking the app for your IPTV service will fix the “Portal may be having problems” message.

Our current list of app IP’s is :

Australia (
Brazil 2, South America (
Balkans (UAT) (
Bulgaria (
Bulgaria (
Canada Montreal (
Canada Toronto (
Canada Quebec (
France – Bourgeoisie (
India (
Italy (
Luxembourg + Russia (
Rest of the world + Asia (Wide) (
Romania (
Singapore + Oceania (
South Africa + Lesotho (
Spain + Portugal HA (
UK + Ireland (
UK3 + Ireland (
UK4 + Ireland (
Ukraine (
USA (West) + North Continental Americas (
USA (East 2) (
World Web and Portal Validator #1 (
World Web and Portal Validator #2 (
World Web and Portal Validator #3 (

Click here for an NGINX sample config containing all of the IP’s above.

IP’s listed above are for international app delivery and can change.  There are possible regional or local servers in certain areas that may not be listed here. Read below for them.
In case of local network delivery: Local IP’s like are used in cases where IPTV and app delivery is done in a Local Area Network inside your local ISP. Local VLAN ID for Smart STB is 155 or whatever is used for IPTV delivery unless stated otherwise in your corporate activation email.

One good way to tell what server IP is used by the client is to ask them to press any number key on the Remote during “Loading Portal” – they will get similar screen:

In this example [] is the local server’s name and [] the IP address.

In case you use Apache2 configuration, you do not need to do anything special, default configuration should give you the correct Client IP’s

<VirtualHost *:88>

ServerAdmin webmaster@localhost

DocumentRoot /var/www

<Directory /var/www/stalker_portal/>

Options -Indexes -MultiViews

AllowOverride ALL

Require all granted


ErrorLog ${APACHE_LOG_DIR}/error.log

CustomLog ${APACHE_LOG_DIR}/access.log combined


In case you use nginx or other similar solution, we advise you to add those options to your nginx configuration for your Portals, Streaming Servers and Billing Servers to guarantee app compatibility and correct client IP’s visible to you at all times.

    server {
    listen 80;
    server_name localhost;

    location / {
    proxy_set_header Host $host:$server_port;
    proxy_set_header X-Real-IP $remote_addr;
    ###proxy smart stb


    location ~* .(htm|html|jpeg|jpg|gif|png|css|js)$ {
    root /var/www;
    expires 30d;

    One good way to check if the client’s IP you see is correct is to login to your Panel and see the user’s info. If the IP is like our app server IP’s then the configuration is wrong. If the IP address you see is the same as the public IP address of your client, then everything is okay.

    In this example clients with Virtual MAC 00:1A:79:95:9E:95 and 00:1A:79:01:02:03 have WRONG login and their actual Public IP is not visible.
    This can cause black screen problems for the example clients.

    Individual guides for other most popular middleware platforms is coming soon, examples above are for Ministra.



    Cloudflare users – please perform this instruction specific to Cloudflare to allow our app to function correctly for portals behind Cloudflare servers.

    If you want to use Cloudflare you must put their server IP ranges and get CF-Connecting-IP for your regular MAG box users and use X-Forwarded-For for your Smart STB users.

    Here is an example working configuration we tested, please note CloudFlare IP’s may change:

    (put in nginx before location /)


    server_name your-domain-name.tld;

    In case you want to proxy to Apache2 (assuming apache2 port is 88) thru nginx please configure reverse proxy like this:


    location / {
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $proxy_add_x_forwarded_for;
    proxy_set_header CF-Connecting-IP $http_CF_Connecting_IP;
    real_ip_header X-Forwarded-For;


    In case you use Apache2 you will need to enable remoteip module (usually done by sudo a2enmod remoteip command on popular distros)

    Please note that first IP is IP of the Smart TV, second IP is our app DP server and third IP is usually Cloudflare server which processed all this.

    More in-dept information available here:

    And technical info is available here:,visitor%20IPs%20Open%20external%20link%20.