Frequently Asked Questions on component installation and KeeneticOS update

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).

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

Question: Can I save the current version and user settings (configuration file) before the KeeneticOS update?
Answer: Yes, it's possible. 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).

faq01.png

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'.

As a result, you will save the file of the current built-in operating system on your computer. 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.

faq02.png

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)'.

err-507-en-02.png

err-507-en-01.png
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 models with 16 Mbytes of Flash memory (KN-1110, KN-1210, KN-1310, KN-1510, KN-1610).

 

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, the appearance of such an error is due to the zip-archive being selected as the system file. On our website in the Files section, 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 Files page, 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: Test (bugfix, debug) Dev-versions are released by the developers and are available for installation. Information about testing can be found on the Keenetic Community forum. These versions follow the Official and Preview releases' functionality 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 the workability of fixes and to get familiar with new features. This version may contain bugs, but if necessary, you can revert to the Official stable version at any time by selecting the 'Official' update channel in the web interface on the 'General system settings' page.

 

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'.

faq03.png

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.

NOTE: Important! After installing a Dev-version, you will automatically receive updates from the 'Dev' channel. Our Technical Support department supports only official releases ('Official' 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 Centre 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 Files section 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 software 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. This may cause errors to be displayed in the web interface. If you are faced with such a situation, we recommend you save a backup of the current settings (configuration file), then perform a factory reset of the user settings and reconfigure your Keenetic.

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.