Installation
The first step to getting started with KS Assistant is to install it on a device. There are many ways to run it for all kinds of scenarios and all kinds of skill levels.
Plug and play with KS Assistant Green
The affordable KS Assistant Green is the easiest way to start using KS Assistant. It's plug-and-play and comes with KS Assistant already installed.
DIY with Raspberry Pi
Raspberry Pi, a mini low-cost computer, is one of the most popular platforms for running KS Assistant. If you want to learn how to DIY, this is a good way to start and gain experience.
Extend with KS Assistant Yellow
The extensible KS Assistant Yellow comes with all the ingredients you need to help you build a robust smart home. All you need to do is to bring your own Raspberry Pi Compute Module.
Install on other hardware
KS Assistant can be repurposed and installed on various hardware, such as an Odroid or a generic x86-64 machine. The KS Assistant Operating System allows you to install KS Assistant on these devices even if you have little to no Linux experience.

Install KS Assistant on x86-64 machines
Repurpose workstation hardware to run KS Assistant
- You can use a command line and install a boot medium on your hardware
- You're comfortable configuring the BIOS based on instructions.
- An x86-64 machine
- Storage hard drive
- USB stick
- Ethernet connection
Advanced installation methods
KS Assistant offers four different installation methods. We recommend using KS Assistant Operating System. Other methods are available for experienced users for their specific needs, for example, running Home Assistant in a virtualized environment (e.g. Proxmox), or on top of an existing operating system (e.g. Windows, macOS, Linux):
- KS Assistant Container: Standalone container-based installation of KS Assistant Core (e.g. Docker).
- KS Assistant Supervised: Manual installation of the Supervisor.
- KS Assistant Core: Manual installation using Python virtual environment.
Note that while these installation methods may provide some features for advanced users, they may also have some major limitations. For example, add-ons and other important KS Assistant features may not be available.
HA OS1 | Container1 | Core1 | Supervised1 | |
---|---|---|---|---|
Automations | ||||
Dashboards | ||||
Integrations | ||||
Add-ons | ||||
Blueprints | ||||
One-click updates |
|
|||
Backups |
- KS Assistant Operating System
- KS Assistant Container
- KS Assistant Core
- KS Assistant Supervised
2: KS Assistant Supervised requires users to maintain their own operating system.

Install KS Assistant variants on Raspberry Pi
A low-cost DIY solution to get started with KS Assistant
- Assembling a Raspberry Pi setup
- Flashing a Raspberry Pi
- Advanced knowledge of Linux
- Using Linux command line
- Raspberry Pi 3, 4 or 5 with power supply
- MicroSD card
- Ethernet connection
Install KS Assistant on other systems
Use KS Assistant on virtual machines, NAS, and more
- Know how to find an IP address on your router
- Advanced knowledge of Windows
- Using Linux command line
- Machine with Windows installed
- VirtualBox (for VM)
- Windows Subsystem for Linux (for Core)