First things first

The reason why you're on this page is because you want to know how to install on your microcontroller, Docker, local working station, server or whatever Linux environment you prefer. The good news is that we have different approaches from basic to advanced; it depends on how you want to install it.

Before you decide which installation method you will use, it might be interesting to read about our best practices and the one vs multi camera support discussion.

Raspberry Pi

When deploying on the Raspberry Pi there are two possible solutions. You can use our custom OS, KiOS ( Operating System), which is production-ready or install it on an existing OS, Raspbian.


KiOS is a custom linux OS (created by Buildroot) which runs out-of-the-box. This is the most simple and basic installation procedure. Note that with KiOS you don't have multiple camera support.

Install KiOS


If you already have a Raspberry Pi running with Raspbian, you probably don't want to reflash your SD card. Therefore you can install and download the different parts of (the machinery and the web) without the need for complex and time consuming compiling.

Install on Raspbian

Armbian supported boards

If you have an Armbian supported board*, you can follow the Armbian installation to transform it into a surveillance system.

Install on Armbian


A Docker image is available on the Docker Hub for x86 machines. By using docker-compose you can run with a one-liner.

Run on Docker


You can install on any Linux based OS like Ubuntu, Debian, Raspbian, OSX, etc. The only thing you need to do is to compile the machinery and install the web interface. can't be compiled on a native Windows machine, if you want to use on windows you should Docker.

Compile yourself