FAQ: component installation and updating KeeneticOS
Question: How do I update the KeeneticOS operating system?
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).
Updating KeeneticOS via the mobile application
Any Keenetic router can also update the KeeneticOS operating system automatically, without user involvement.
Question: Can I save the current KeeneticOS image and user settings (configuration file) before the OS update?
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'.
Question: Can I install a particular component without updating the entire system?
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.
Question: Why can't I update KeeneticOS? A 'request failed 507
' error occurs. The router's system log also contains a message with error number 507: 'request failed (507)
' and 'error:507 (insufficient storage)
'.
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 with16 Mbytes
of Flash memory.
Question: Why an error occurs when trying to install KeeneticOS from a file "firmware verification failed: raw firmware size 9571977 is not aligned by a block size 0x10000 (903)
"?
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.
Question: I update the components strictly according to your instruction, but after checking I see that the components have not been updated.
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'.
Question: How can I install a test version of an operating system to try out new features?
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.
Importante
Be careful when installing Dev builds! Before installing the KeeneticOS version from the Developer channel, we recommend you make a backup of the current router configuration by saving the startup-config.txt file and the Keenetic OS system file with the current set of installed KeeneticOS components. This will allow you to quickly restore the device configuration to its previous state if needed. Refer to the Updating KeeneticOS by a system file guide for more information.
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.
Importante
After installing a Dev version, you will automatically receive updates from the Dev Channel. Our Technical Support department supports only official releases ('Main' and 'Preview' channels). For Dev version support, please refer to the Keenetic Community forum.
Question: Why can't I install all available components?
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.
Question: Why does the 'General system settings' page under 'Updates and component options' contain the message 'Unable to connect to the update server
'?
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.
Question: Why the Keenetic fails when trying to install a new version of KeeneticOS via the file ('wrong firmware format
')?
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.
Question: After the KeeneticOS update, some interface pages are not loaded, or errors occur in the Keenetic web interface. What should I do?
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 thefirmware 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.
Question: When performing a KeeneticOS downgrade, the error 'firmware signed with a revoked certificate (8585290)
' appears. How can I roll back the firmware version from the current version to one of the old versions?
Answer: Starting with KeeneticOS
3.4.6
release dated09-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 beforeJuly 9
,2020
) to the router, you will see a message that the firmware to be written is signed with the revoked certificate.