From The Kinguard Project Wiki
Jump to: navigation, search

Current release

The current release for The Kinguard Project is "Kinguard 20.07".

Install images

Install images are provided on the Kinguard Download Area for both OPI and KEEP.

Please read the ReleseNotes.

How to install

For KEEP write the img-file to a USB stick and press and hold the button for 10 seconds while inserting power.

A simple cross platform tool to write .img files to an SD Card or USB Stick is Etcher.

For KEEP, the installation takes about 3 minutes. Unfortunately there is currently no visual indication that the installation has completed. A hint though is that when the harddrive spins down, the installation is complete. After the completed installation the unit needs to be power cycled.

For OPI write the image file (.img) to a uSD card (using Etcher or similar tool), insert it into OPI and apply power. OPI will turn off all LEDs when the installation is complete. When the installation is complete replace the installation SD-card with a blank SD card.

Special OPI note when upgradeing from the older OPI software to the newer Kinguard-based version. It is not possible to reuse data directly from an old SD-card. The default procedure is to perform a backup to USB and then do a complete reinstall with a new/newly formatted SD card.

If data is to be restored from a backup, the recommended way is to make sure that a backup on USB exists (usually faster than downloading from on-line servers), make a clean shutdown of OPI and then leave the USB memory inserted during the setup. The data set can then be chosen during the "Restore" step of the setup procedure.

Installer Configuration

In the installer image there is a configuration file that can be used to alter the behavior of the installer image.

In "/etc/kgp-install.conf" there are few parameters available. Note that you need to be "root" in order to change these parameters.


By default this parameter is set to "1", which will cause the image to basically do a factory reset by formatting the internal eMMC and reinstalling system software. Any data on the data disk will be left intact.

If set to '0', the system will boot into a rescue mode, leaving all data on the system intact, but allowing access to the system using ssh and serial console.


By default this parameter is set to "0". By changing this to "1", the system will be installed a root account is added with the password "op237". This is only available on the serial port, ssh is not enabled by default.

How to connect to the serial port is described here.

Older releases provided by OpenProducts


Installation images

Rescue images

Instructions on how to reinstall is available here

The rescue image is very similar to the install image, only that the image does not re-install the system. The system will be available both on the serial port and on ssh with the user/password of root/op237. The root file system can then be accessed and manipulated, but all user data is only available if the encrypted partition in unlocked and mounted by hand.


Installation images