User Manual

Answer: There are different ways to update your Keenetic router's operating system.

Manually, via the web interface (by clicking the appropriate button in the web interface, but in this case, the router must have a working Internet connection; via the operating system file - this method can be used for offline upgrades when the router is not connected to the Internet), via the Keenetic mobile app or the command-line interface (for advanced users).

Any Keenetic router can also update the KeeneticOS operating system automatically, without user involvement.

Answer: Yes, it is possible, and we recommend doing so. Save the current router firmware file and the user settings (startup-config) on your computer. With these system files, you can reset the router's settings at any time. Connect to the Keenetic web interface and go to the 'System settings' page. In the 'System files' section, select the firmware file and click the 'Save to computer' button to download this file's copy (the router's OS).

Your web browser will download the KeeneticOS operating system file (*.bin file). If the 'Save file' window appears, specify the location (the folder where the file will be saved) and click 'Save' or 'OK'.

See 'Saving KeeneticOS image to a file' for more information.

As a result, you will save a backup file of the router's built-in operating system on your computer, containing the currently installed version of KeeneticOS, with your set of components.

Later, if necessary, you can restore the saved version of the system. You can do this by following the instructions Updating KeeneticOS by a system file.

As for the Keenetic configuration, you can save the current user settings by clicking on the startup-config file entry.

You will find more information in the instructions 'Saving the startup-config configuration file'.

Answer: No. Any OS update will cumulatively update all KeeneticOS components. All components are designed to work together, and updating a single component can lead to various system errors. Therefore, a KeeneticOS rebuild is required even if you add or remove a single system component.

Answer: Error 507 during an operating system upgrade means that the router does not have enough internal memory to install the selected components. We recommend you uninstall unused components before the update. This is due to hardware limitations. This error may occur on entry models with 16 Mbytes of Flash memory.

Answer: As a rule, such an error appears due to the zip archive being selected as the system file. On our website, in the Download Center, KeeneticOS files are presented as zip archives. After downloading the file (for your router model) from our site, you should first unzip (unpack) it. The downloaded file must have the .bin extension.

Answer: Try to perform the update again using a different web browser. Various add-ons, plug-ins or toolbars can hinder the installation of components. We recommend using the latest versions of the most popular web browsers (Google Chrome, Mozilla Firefox, Opera).

If the actions above do not help, download the current KeeneticOS file for your router from the Download Center, and follow the instructions 'Updating KeeneticOS by a system file'.

Answer: Dev (test, bugfix, debug) versions are released by the developers and are available for installation. Information about testing can be found on the Keenetic Community forum. These versions have the same functionality as Main and Preview releases and contain additional bug fixes and new features. The latest Dev version available usually contains a fresh set of components that are used in current releases. This version differs from 'stable' releases in that it is not fully internally tested and is therefore distributed on an 'as is' (or 'at your own risk') basis. The Dev version is initially intended to test fixes' workability and get familiar with new features. This version may contain bugs.

You can update the router's OS to the latest available Dev version from the router's web interface or via the command-line interface (CLI).

If installing the Dev version of KeeneticOS via the web interface, open the 'General system settings' page, under 'Updates and component options', select the 'Dev' build update channel and click 'Install the update'.

In the case of installing a Dev OS version using commands, connect to the command-line interface (CLI) of the router and execute the following commands:

components list draft
components commit

After successful execution of these commands, the device will automatically reboot. After that, connect to its web interface and check the KeeneticOS version on the System dashboard' page in the 'About the system' section (it is indicated in the 'OS version' field). The list of system components will remain the same.

Answer: Due to the different hardware configurations of Keenetic routers, it is not guaranteed that all components and specific combinations of components available for a particular model can be installed simultaneously. This is usually the case for junior models with up to 16 Mbyte of Flash memory. Also, some operating system components are mutually exclusive and cannot be run simultaneously. We recommend uninstalling the components you do not use and then installing the ones you do need. The recommended set of components can be obtained by installing the KeeneticOS operating system for your router from the Download Center section.

Answer: This means that it was not possible to connect to our update server for some reason. Make sure that the router is connected to the Internet, and then try again. Perhaps, there may have been maintenance work on our server, and it was not accessible at some point. Try to perform a system update later.

Answer: This error means that you are trying to put the system file created for another Keenetic model. The built-in protection system has been activated.

Identify your Keenetic device's model. The model is shown on the device's bottom label, on the device's carton box, and in the web interface. Then, in the Download Center of our website, download the zip-archive with the KeeneticOS, designed specifically for your device model, unzip the archive, and use the resulting file with the extension .bin for writing to the router.

Answer: Different versions of KeeneticOS components may have different preset settings. Some device settings may not be refreshed when the operating system is updated. Also, upgrading firmware from a very old version to a new one can cause errors to appear in the web interface. We, therefore, recommend saving the current settings file (startup-config) and the firmware file before updating the router's firmware. If you are faced with such a situation, we recommend you perform a factory reset of the user settings and reconfigure your Keenetic.

Answer: Starting with KeeneticOS 3.4.6 release dated 09-07-2020, the firmware digital signature certificate has been updated on Keenetic cloud infrastructure and Keenetic devices. The previous digital signature certificates will be withdrawn. This has been done to improve the security of Keenetic devices and services.

If after installing version 3.4.6 and above, you try to write one of the previous firmware versions (released before July 9, 2020) to the router, you will see a message that the firmware to be written is signed with the revoked certificate.