Kerberos Open Source comes with different installation flavours. So you might think, why? The reason is simple, depending on the use case one option is better than another. A short list of recommendations:
A simple window will appear once Etcher fully loads. There are three steps in the flashing process for Etcher. To start, click the 'Select Image' button. A new window will appear which you can use to navigate to the location of the image file you wish to flash. Some of the image file types Etcher. Etcher copies images to drives byte by byte, without doing any transformation to the final device, which means images that require special treatment to be made bootable, like Windows images, will not work out of the box.
Plug and play
- KiOS: You have a Raspberry Pi, and you only want to run a Kerberos agent on it.
- Docker: You have a lot of IP cameras, and/or don't want to mess with dependencies.
- Balena: Runnning the Kerberos Docker container on top of Balena.
Advanced
- Raspbian: You have a Raspberry Pi, but you want other services running next to the Kerberos agent.
- Generic: You want to develop/extend Kerberos with your own features, or you want to run a Kerberos agent on a not supported OS/architecure.
Following installation methods aim for the simplicity of installing Kerberos Open Source. With almost no efforts you can have Kerberos Open Source running.
KiOS
KiOS (Kerberos Operating System) is our custom linux OS, which runs the Kerberos agent out-of-the-box (read plug-and-play). It's an OS designed for the Raspberry Pi (all version are supported), which you can flash to an SD card.
It can be installed using our own installer, which comes with a nice interface that handles the flashing and network configuration for you, or you can handle the flashing yourself by using Etcher.
Github
KiOS is compiled using Buildroot, the project can be found on following Github repo.
Kerberos Open Source installer
Installing the Kerberos agent to your Raspberry Pi, 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!
Download the correct installer for your OS below:
Etcher
If you love Etcher, or the Kerberos installer is not working as expected, you can also flash the Kerberos agent to your SD card manually. It goes as following:
- Download the KiOS image,
- flash it to your SD card with Etcher,
- and edit some configuration files at the boot directory.
Once you have download the KiOS image (make sure you downloaded the right image) and flashed it to an SD card, put it back into your working station. Navigate to the SD card and creating following files.
Https Etcher Io Download
Connecting to WiFi
If you want to connect your Raspberry Pi to a WiFi connection, you will need to create a file wireless.conf on your SD card, with following contents. Change the SSID and password properties to your own WiFi credentials.
Setup a static IP-address
If you want to assign a static ip-address to your Raspberry Pi, create a file static_ip.conf on your SD card, with following contents:
Power on the Raspberry Pi
Once you've finished the installation using either the KiOS installer or Etcher, you can put the SD card into your Raspberry Pi and turn it on. 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 agent's front-end, which you can access with the username: root and password: root.
Access the Raspberry Pi
You can access the KiOS system with attaching your Raspberry Pi to a HDMI monitor or by using ssh.
Note that by default no root password is set, you can define a password in the /data/etc/kios.conf file. Once you added a password, make sure to reboot the OS.
Docker
A Docker image (amd64, armv7, arm64) is available on the Docker hub, which contains all the necessary software to setup the Kerberos agent in a matter of seconds. Before you can run this image, make sure you have Docker installed. Visual boy advance source. Afterwards you can use Docker, to get the Kerberos agent up and running. All Docker images can be found on the Docker hub.
This installation guide assumes you already have a good understanding of Docker. If you want to learn more about Kerberos.io on Docker, have a look at these tutorials.
Prerequisites
Docker or Docker Desktop (Linux, OS or Windows)
Github
All technical information, such as Dockerfile, can be found on following Github repo.
Download docker image
Before you are able to run the Kerberos agent inside a container, you will need to pull the docker image from the Docker hub.
When you pulled succesfully you can run your first Kerberos container as following. This will run Kerberos agent and expose the web interface on port 80, and the livestream on port 8889.
You can access the KiOS system with attaching your Raspberry Pi to a HDMI monitor or by using ssh.
Note that by default no root password is set, you can define a password in the /data/etc/kios.conf file. Once you added a password, make sure to reboot the OS.
Docker
A Docker image (amd64, armv7, arm64) is available on the Docker hub, which contains all the necessary software to setup the Kerberos agent in a matter of seconds. Before you can run this image, make sure you have Docker installed. Visual boy advance source. Afterwards you can use Docker, to get the Kerberos agent up and running. All Docker images can be found on the Docker hub.
This installation guide assumes you already have a good understanding of Docker. If you want to learn more about Kerberos.io on Docker, have a look at these tutorials.
Prerequisites
Docker or Docker Desktop (Linux, OS or Windows)
Github
All technical information, such as Dockerfile, can be found on following Github repo.
Download docker image
Before you are able to run the Kerberos agent inside a container, you will need to pull the docker image from the Docker hub.
When you pulled succesfully you can run your first Kerberos container as following. This will run Kerberos agent and expose the web interface on port 80, and the livestream on port 8889.
To add more containers, you can change the name parameter and assign another port to expose the web interface and livestream (ports are unique on a OS).
When the containers are created, you can open your browser and browse to your different containers.
Volumes
Instead of just running the Kerberos container, you can also persist your configuration by assigning volumes. An example of mounting volumes looks like this; an overview of the different volumes can be found here.
- preload configuration,
- or centralise the images/videos on your working station.
Balena
Running Kerberos inside a Docker container is great, it makes it possible to run Kerberos everywhere; basically on any OS. You can deploy Kerberos easily to the many different IoT boards we nowadays have available. The challenge with all these IoT boards is that they have different system architecures, however thanks to Docker (and its multi architecture builds), we can ship Kerberos to any of them. If you have a Raspberry Pi, you have two options: Docker and KiOS. If you have any other board, then Docker is the way to go.
Once you've deployed the Kerberos Docker container, you can start monitoring your video surveillances cameras, however it doesn't have to stop here. Probably you also want remote access to your IoT board, and maybe some other cool stuff like system control, a VPN, a public url? This is where Balena.io comes in.
Before getting into the details, you can find a more detailed tutorial at this blog.
1. Create a Balena account
Before moving on, make sure you have registered on Balena.
2. Create a device and flash
After you signed up, you can create an application for a specific IoT board (e.g. Raspberry Pi 3). Once created you will be able to download the balena OS image, which you can flash to your SD card using Etcher.
3. Connect
Once you've flashed the balena OS, turned on your IoT board, a new device should come up on the Balena dashboard (below the application you've created). At this point you will be able to connect to your device using the balena-cliread more about the installation here.
First connect the balena-cli to your account by executing following command. Choose the recommended option.
After succesfully logged in you should be able to list your devices.
4. Write
Finally, we can push our Kerberos Docker container to our application (and devices). To do this we need to create two files.
- Create a new directory and the Dockerfile.
The first file is named Dockerfile this file will contain a base image which references to our Kerberos image, which you can find here.
Please note that we specified a sha256 tag, you have to make sure you use the right sha256 tag for your architecure. In the example above we use the sha256 tag for a armv7 architecture (Raspberry Pi3).
- Create a Docker compose file.
The Docker compose file is optional, but can be very useful. It can be used to deploy multi container application (e.g. a webserver + database). As Kerberos has everything in one single container, this is not needed.
Https Etcher Io Sandbox
We will use the `docker-compose.yml to mount volumes, so that when we restart our container all our configurations and recordings stay persisted.
Create a new file named docker-compose.yml, and copy-paste following content.
5. Push
Now we created our two files, we can publish the Kerberos container to balena (our application), by executing the push command (replace by the name of your application).
Once finished you should see following message, and on the dashboard you should see your devices updating (Yes you can add multiple devices to an application). You're ready ;)
My preferred method for writing an Raspberry Pi SD card image is a tool called Etcher. It is free, works on Windows, Linux and Mac and has a nice clean interface. The newer version even allows multiple SD cards to be written at the same time.
Download and Install Etcher
Etcher can be downloaded from https://www.balena.io/etcher/. The Windows version is available in Portable and Installed versions for both 32-bit and 64-bit flavours. I use it on my Windows PC and Ubuntu laptop.
Https Etcher Io Crazy Games
To our surprise there was nothing out there that fitted our needs. So we built Etcher, a SD card burner app that is simple for end users, extensible for developers, and works on any platform. – resin.io Team
Download Your Favourite Raspberry Pi Image
Download your preferred SD card image. If in doubt the Official Raspbian (with Desktop) image from the Raspberry Pi Foundation's website is a good start : Official Raspbian SD Card Images
Using Etcher to Write a Raspberry Pi SD Card Image
The interface looks like this :
Step 1
Browse to the image file. This can be a conventional img file or a zip file. This allows you to burn Raspberry Pi images without even extracting them from the source Zip files.
Step 2
Select a drive. The list of drives provides a nice set of information so it should be clearer exactly what physical device you are selecting. You can select multiple drives and it is possible to write multiple SD cards at the same time.
Step 3
Wait for the process to complete.
Once the process has finished you have the option to burn the same image again or to choose a different image.
Troubleshooting
Depending on the state of the SD card you are using you may need to format it first. On Windows I always use the official SD Formatter application.
Overall I'm very impressed and not sure if SD card image burning can get any easier than this!
