Skip navigation

STB software is a set of programs that is intended to control STB operation. STB software includes Linux kernel and Root File System (Root FS) that contains software components provided by CPU manufacturer and STB MAG manufacturer.

Procedure of combining STB software components (STB software building) is performed at STB manufacturing plant. As result of building procedure the system image (hereinafter - image) is created which is applied for loading and running in STB.
STB manufacturer permits to users of STB (IPTV operators and individual users) to make changes of certain components of STB software and independently create image according to instructions of manufacturer. This process is called as STB software customization. It enables IPTV operators to configure STBs according to its own work environments and preferences, as well as, to integrate STB software with other developers' applications.

Open and closed platforms of STB

The сontents of this electronic documentation refers to open platform STB (except when specifically indicated  that closed platform is described).

STB models with open and closed platforms

STBs of MAG family can be produced on the basis of open and closed hardware-software platforms, depending on focus of its application. Provided STB models are listed in Basic models of STB Linux & WebKit section, considering the division into open and closed platforms.

Difference between open and closed STB platforms

The idea of open platform is to provide users (both individual users and IPTV / OTT operators) with the opportunity to make changes (perform customizations on their own) of STB software and integrate it with applications of other developers.

In turn, сlosed platform is intended for operator solutions that uses CAS / DRM system providing content protection. The CAS / DRM system is a hardware-software complex that is integrated into operator's IPTV networks and, in particular, into subscriber receivers (STBs). To protect media content, encryption of transmiting audio-video streams is used providing media content playing back only on registered models of media players (STB) of required IPTV operator. In addition, the content protection system restricts various actions with copyrighted audio-video content (copying, modification, repeated playback, distribution etc.). There are various types of content protection systems that differ in hardware/software implementations, levels of content protection, types of content being processed, and so on. Particular CAS / DRM system to be used in IPTV project is selected by IPTV operator. STBs that are used on the operator's network must be pre-integrated with reqiured CAS / DRM system.

STB software for closed platform is produced at the manufacturing plant by individual agreement with every concerned operator. STB software with closed platform prohibits modifying STB software by users (without participation of IPTV operator) whose signature (operator key) is installed in STB.

Variants of STB software images for open and closed platforms

To meet various requirements of users, several options of open platform's STB software image are designed that can be divided into two groups:

  1. PublicImage and FactoryImage - created and provided by manufacturer. They are intended mainly for individual users as well as for users of OTT operators.
  2. CustomImage and OperatorImage - created and provided by operator. They are intended for users of IPTV operators.

STB software image is created in accordance with manufacturer's instructions on basis of software components comprised in STB software release. It may include customized operator settings.

Closed platform's STBs, which are focused on operators solutions, use operator image that is signed by certain operator's digital signature (operator key).

STB software versions

STB software version parameters

STB software version (also called as Image version) consists of the following parameters:

  • Model - model number of STB, for which the version is intended;
  • Version - number that is assigned by developer during image making. For images from the STB manufacturer three-digit number is used;
  • Date - date of image creation that is assigned automatically during image making;
  • Description - detailed description of software version. It can be assigned by developer during image making. The image creator (developer) can use this parameter to specify the image type, operator name, STB software features, and so on. For example, description 0.2.18-r19-pub-254 means: version 218, release 19, public image, STB model - MAG-254.

Viewing of software version in STB

STB software version can be obtained by user:

  • From Bootloader menu - for MAG250/254/270: via Image info item (see Version, Date, Description items)

Image Documentation

  • From System Recovery Utility menu - for MAG256 and MAG322/324/349/351: from Device information (see Image version number, Image date, Image description items):

Image Documentation

  • From Embedded portal: Settings / System settings / Device info (see Image version, Image description, Image date items):

Image Documentation

Viewing of software version in imageupdate file

Description of the software image included in imageupdate file can be viewed with text editor app. To get Description, on the PC, open the imageupdate file in text view mode. Software version information (imageupdate content) is located at the top of the window. For example:

Image Documentation

STB software release

Software release location

STB software release (hereafter - release) contains new (current) version of STB software provided by the manufacturer of STB. Releases for various STB models are in public access by the next URL:



 <model>  - number value of basic STB model (for example, 254, 256, 322, etc.);

Example of STB MAG322 release location (URL):

Releases are divided according to basic STB models (MAG254, MAG256, MAG322, MAG324, MAG349, MAG351,...). Release of each basic STB model is applied to entire corresponding STB model range: for example, MAG254 release is also applied for MAG254w1, MAG254w2 models.

Release parameters

List of Release parameters:

  • STB model to which the release/version is being intended;
  • Release version = software version, included in release;
  • Release date = date of software version, included in release

Example of folder with STB MAG254 Release is given below: version 0.2.18-r19, date - 2017-11-15.

Image Documentation

Release contents

Release contains the following update files:

  • imageupdate - public image created by manufacturer which based on software components included in Release;
  • Bootstrap - startup file that is used to load the image into RAM. Used for updating from Bootloader to STB models MAG250/254/270. It is also used for system recovery of STB models MAG-256/322/324/349/351 and higher.

Release also contains software components that are provided to users for creating next variants of STB software image: public image, custom image, operator image. Software images are made according to the Instructions for building image.

STB software provided by manufacturer - public and factory images

STB software is issued and provided by manufacturer in public access. The following two basic variants of STB software are applied:

  • Factory image is created by factory and installed in STB at factory in manufacturing process. Factory image is distributed for STB updating - last version of Factory image (imageupdate file) is provided to users from manufacturer's web-server. Factory image contains mechanism that prevents updating to other (non-factory) images. This mechanism allows to use only proven (factory made) STB software. In factory image, access to STB root file system on SSH protocol is forbidden.
  • Public image is created by manufacturer and is issued in Release of every STB model. At the same time, manufacturer provides with Release the necessary software components, on base which users can create your own publick image modification (in order to customize image) according to instructions of manufacturer.
    Public versions of the software are signed with the public key (ID_KEY = STB_PUBLIC), included in Operator Utilities to make STB SW image.

    Public image can be updated in STB manually by user at STB booting stage (from Bootloader menu - for STB MAG-250/254/270 or System Recovery Utility menu for STB MAG-256 and MAG-322/324/349/351).
    As a rule,
    Public image
    is intended for debugging, operative changes of internal settings, monitoring and other auxiliary purposes. Public image is open for changing running STB software. To access STB root file system SSH protocol is used.

Update to Factory image

Description of software update for various STB models: STB software update

Update to Factory image is performed from STB  Embedded portal -  automatically or manually (by user commands).
If STB runs the Factory image, for updating only Factory image versions are accepted. Any different image types (public, custom) are rejected when trying to upgrade from Embedded portal.


Automatic updating to the factory image is carried out over network (HTTP protocol), from URL specified in STB software. Automatic update settings can be accessed by user from STB Embedded portal or performed by Middleware server administrator (if STB connected to external portal).

  • Autoupdating settings in Embedded portal on example of STB MAG254 is described in section Software autoupdate
  • Configuring the auto-update URL in the STB software and update procedure steps are described in developer section Autoupdate module description.

Manual update

Manual updating to factory image is performed from Embedded portal. Depending on the location of an update file (imageupdate) which can be placed on the manufacturer's web-server or locally on a USB-drive, the following update options are available:

Factory image versions are issued at the web-server of manufacturer by address:


where <model> is a number value of basic STB model (for example 250, 254, 256, 322, etc.).

For example, for STB MAG322 the last factory image version address :

As a rule, only one last stable version of software for every STB model is located on the update server. But in some cases update server comprises several software versions of the same STB model to select by user (they are accessible from Embedded portal).

Update to Public image

Update to Public image is performed manually only on booting stage of STB (from Bootloader menu - for STB MAG-250/254/270 or System Recovery Utility menu - for STB MAG-256, MAG-3xx and MAG-4xx). This way user can update STB to required version of Public image or make transition from any other type of image (factory, custom) to Public image.

Public image versions produced by  manufacturer are issued in STB Releases .

Images created by Operators

As described in STB software provided by manufacturer section, operators can create their own public image modifications (PublicImage). In addition, two special kinds of SW image are intended to be used in operator's IPTV-networks: Custom Image (CustomImage) and Operator Image (OperatorImage).

Every operator creates image on his own and handle it with your own secure cryptographic key (see Cryptographic signature of image section). When attempting to update the STB software, the digital signature is checked. This ensures that only the software created by particular operator is used in STB.

STB software image version created by operator are put on his web-server. In order to ptovide STB updating, STB software image should comprise specific update URL defined in STB software image (see STB software customization - setting update URL, autoupdate URL).

Unlocking STB  with installed operator key


If certain operator key has been set in STB, then all issues related to "STB unlocking" (reprogramming, switching to other image versions - factory's or other operators'), user should direct to Operator directly. Neither STB Manufacturer's Technical Support Services nor Service Center is able to unlock STB if operator key was set in STB.

Update to Custom image

Update STB to Customimage is performed from Portal - external or embedded. Update means transition to another version of Сustomimage of the same Operator.
Note. Description of specific first two-stage installation of CustomImage is described in the CustomImage making instruction. Subsequent updates of Сustom image are carried out in the usual way from the portal (using HTTP or USB methods).

CustomImage contains installed operator (custom) key, which is checked when trying to update the image. Thus, if STB is running Customimage, only the same operator CustomImage versions (containing the same custom key) are allowed to update STB from Portal. Image versions of other types (Factory image, Public image) or Customimage with different custom key are rejected when trying to update.

Update to Customimage from the Embedded Portal is similar to the one described for Update to Factory image - in automatic or manual mode. However, as the update file is hosted on the Operator's Web server, a corresponding update URL changes.
Note. The addresses for manual and / or automatic updates are specified during image making - see STB software customization.

Example of how to configure update from External portal

1. Manual Update configuring from the MW Ministra Portal (update from URL):

  Configuring Example

Image Documentation

Image Documentation

Image Documentation

Image Documentation

Image Documentation

2. Configuring STB update in MW Ministra administration panel:

Cryptographic signature of image

In order to prevent running of unauthorized software in STB, every STB software image is signed with a digital signature, using the GnuPG (GPG) program. The RSA algorithm is applied to provide data encryption and integrity of image checking as well.

GPG program generates сryptographic key that consists of secret part (private key or secret key) and open part (public key). While a key creating, it is assigned unique ID (ID_KEY) - a name of the key to be stored in the GPG data base. Private key is a property of image creator (i.e. Operator). It is kept secret and used for new images signing during image building process.
Using public key installed in the STB, the authenticity of SW image being loaded in STB is checked. During an image loading in the STB, the signature availability and correctness are checked (whether public and private keys match each other). In case of the keys mismatch, the 'Wrong Signature' error is displayed, and the image is not loaded in the STB.

To create Operator's images (CustomImage, OperatorImage), the operators uses their own keys. If OperatorImage is used by operator, the public part of the operator key must be signed with the Manufacturer key before installation in STBs. Creating images by operators and installing operator key in the STB are performed according to the instructions of the manufacturer of STB.

Public images (PublicImage) are signed with Manufacturer's default operator key (ID_KEY = STB_PUBLIC). The public key of the default operator key is installed in the STB at the factory. Default operator key is included in Image making utilities and is used in build procedure of PublicImage and CustomImage.

Instructions for building image

Public image making

Images making by Operators


STB software customization

STB software customizing refers to configure STB software user interface and STB operation parameters according to customer (operator) demands, as well as integrating necessary applications, including external media portal support.

To customize certain STB model, IPTV operator makes changes to STB image according to STB manufacturer instructions. STB image components are provided in STB software release. During customization process, necessary changes are made to the root file system, before including it in the image building.

As a rule, image customization is used to create custom and operator images. For purpose of testing and debugging, customization can be also performed in public image.
Customization can deal with the following points:

New portal development

To perform customization of web applications, the manufacturer provides the users (operators) with an API set. Thus, users (operators) can create their own versions of the media portal to control the operation of the set-top box. In addition, the manufacturer provides the ability to upgrade the Embedded portal of STB (the source code of the portal is provided in each SW release) and build its version of the portal with its further inclusion in the customized image of STB software. For example, you can change the algorithm for loading and operating the portal, change design of the portal, etc.

Description of some issues related to portal customization is given in the next sections:

Need Help

Dave is an expert on the MAG STB and the author of this article.

Was this article helpful?

Yes No

Sorry to hear that.
How can we improve this article?

We use cookies in order to optimise our website, provide you with the best possible user experience and help us promote our products. Please read our Cookie Policy to find out how we use cookies and how you can control cookies.
By using this website or closing this message, you acknowledge our Privacy Policy and agree to our use of cookies as described in our Cookie Policy.