7.6 KiB
KiOS
Introduction
KiOS (Kerberos.io Operating System) is our own custom linux OS, which runs Kerberos.io out-of-the-box. KiOS is installed like every other OS for the Raspberry Pi, you need to flash the OS (.img) to a SD card. If you want to get Kerberos.io up and running at a short time frame, this is the most simple and basic installation procedure.
You can install KiOS by using our own installer, which gives you a nice GUI that will handle the flashing and network configuration for you, or you can do the flashing yourself by using Etcher.
Easy installation Advanced installation
Easy Installation
ATTENTION!
We've experiencing issues with the easy installation if you are running Windows 10. When you're also experiencing issues, please follow the advanced installation using the Etcher installer. Meanwhile we'll try to resolve those issues.
Installing Kerberos.io to your IoT device, has never been so easy. By using our cross-platform installer, you can run a fully configured video surveillance system within 3 minutes. Indeed, we also think that's awesome!
By using the KiOS installer, you'll get an easy to use GUI which allows you to configure and flash KiOS to your SD card. Just download the installer, select a version, specify your network configurations, select your SD card and press the flash button; it can't be easier.
Advanced Installation
If you prefer the hard way, you can also flash Kerberos.io to your SD card manually. So it's not a problem if you don't want to use the KiOS installer. It goes as follows: download the KiOS .img yourself, flash it to your SD card with Etcher and edit some configuration files at the boot directory. The big difference with the easy installation, is that you'll need to download the image manually, and edit some files on the SD card to setup your network configuration.
1. Download the .img
All releases are stored on the KiOS Github repository, each release contains several images (for every Raspberry Pi version a different image is created). It's important to download the correct image; installing an image for another Raspberry Pi version will not work. After downloading, make sure to unzip the release.
2. Flash the .img to a SD card with Etcher.io
For the advanced installation we'll use Etcher, it will handle the flashing for us. As you may have noticed the installer, used in the Basic installation, is forked from the original Etcher application. The major difference between Etcher and our own installer is that we've added some configurational sugar on top of Etcher, setup your network configuration and automatic downloading of the KiOS release.
So the only thing you'll need to do for flashing, the hard way, is to go to Etcher.io and download the Etcher installer that matches your OS. After installation you can simply open Etcher and go with the flow: select the KiOS image which you've previously downloaded, select your SD card and click the flash button. Tadaaaa, and you're ready to rumble.
3. Network configuration
After the image has been transferred, you can plug the SD card in to your Raspberry Pi and everything will work magically. By default the KiOS image will require an ethernet connection and use DHCP to give you a dynamic IP-address. However if you want to have a static IP-address or/and use a wireless connection, you'll need to do a small configuration. Insert the SD card into your working station and open the SD card, you'll see two files static_ip.conf and wireless.conf.
Static IP-address
Open and edit the file static_ip.conf.
#####################################################################
# Enter the IP-address you want to have, followed by the subnet mask
# e.g. 192.168.0.10/24
static_ip=""
#####################################################################
# Enter the Gateway and DNS, this will be your router in most cases
# e.g. 192.168.0.1
static_gw=""
static_dns=""Wireless connection
Open and edit the file wireless.conf. Fill-in your WIFI credentials: SSID the name of your wireles network, and PSK the password of your wireless network.
update_config=1
ctrl_interface=/var/run/wpa_supplicant
network={
scan_ssid=1
ssid=""
psk=""
}Power on the Raspberry Pi
When the installation is completed, you can plug the SD card into your Raspberry Pi. From this point KiOS will boot the kernel and re-partition your SD-card; Please note that the first time you boot KiOS it can take about 2 mins before the system is operational. When KiOS is ready you can open your favorite browser and type in the IP address of your Raspberry Pi. This will open the Kerberos.io login page, which you can access with the username: root and password: root.
Access the Raspberry Pi with SSH
To use Kerberos.io you only need access to the webinterface, however you can also access the system with SSH.
Cedrics-Mac-mini:build cedricverst$ ssh root@192.168.0.12
Welcome to kios-79e30bbb!
[root@kios-79e30bbb ~]# Note that by default no root password is set, you can define a password in the /data/etc/kios.conf file.
[root@kios-79e30bbb ~]# nano /data/etc/kios.conf
[root@kios-79e30bbb ~]# rebootAdd your password, save the file and reboot the system.