Frequently Asked Questions on component installation and KeeneticOS update

Question: Can I save the current version and user settings (configuration file) before the firmware 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 the copy of this file (the Internet Center OS).


The KeeneticOS operating system file (.bin file) will be downloaded by the web browser. 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. You will find more information in the instructions Saving the startup-config configuration file.


Question: Can I install a particular component only without the entire system update?
Answer: No. Any firmware 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, 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 on 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 upgrade. This is due to hardware limitations. This error may occur on models with 16 Mbytes of Flash memory (Air, City, Lite, 4G, Start).


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 connected with the zip-archive being specified as the system file. On our website in the Files section KeeneticOS files are presented as zip-archives. After downloading the file (designed for your model of router) from our site, you should first unzip it (unpack). 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. Installation of components can be hindered by various add-ons, plug-ins or toolbars. We recommend to use 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, and follow the instructions Updating KeeneticOS by a system file.


Question: Cannot update the Keenetic operating system via the web interface to the latest available beta version. How can I do this?
Answer: Perform the following actions. Connect to the Internet Centre's command-line interface (CLI) and execute the commands:

components list beta
components commit

The device will reboot automatically after successful execution of these commands. Connect to the web-interface and check the software version on the 'System dashboard' page in the 'About the system' information panel (it is specified in the 'OS version' field). The list of system components will remain the same.


Question: How to install the draft version of KeeneticOS that contains the function I need?
Answer: Test versions are released by developers and are available for downloading from the Keenetic Community website. They reproduce the functionality that is available in the officially released or preview versions, but also contain additional fixes and new features. When you install them, you will automatically receive updates labeled 'Debug version'. 
To update your Keenetic software to the latest available draft version connect to the command-line interface (CLI) and execute the commands:

components list draft
components commit

After successful execution of these commands, the device will automatically reboot. Connect to the web interface and check the software version on the 'System dashboard' page in the 'About the system' panel (specified in the 'OS version' field). The list of system components will remain the same.
Another way to install the test version is to download the OS firmware file with the recommended set of components from the Keenetic Community website and upload it on the device by instruction Updating KeeneticOS by a system file.

NOTE: Important! After the test version is installed, you will automatically receive updates marked as 'Debug version'. The test version is intended for verification of fixes and new functions, but may contain errors. If necessary, you can return to the official stable KeeneticOS at any time.


Question: Why does the '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 Keenetic is connected to the Internet, and then try to update the system again. Perhaps our server was technically in operation and was not available 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 dedicated to another Keenetic model. The built-in protection system has been activated. Identify your Keenetic device model. The model is shown on the bottom label of the device, on the Keenetic's box, 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 to 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



Please sign in to leave a comment.