diff --git a/README.md b/README.md index aa7a5bb..7f9f07a 100644 --- a/README.md +++ b/README.md @@ -1,47 +1,23 @@ -

- - Armbian logo -
- Applications distributed as Armbian appliance -

-

+

+ Armbian logo +

+

-## [Armbian Home Assistant](https://www.home-assistant.io/) (home automation) +### Purpose of This Repository -Home Assistant is an open source smart home platform that allows you to connect your smart home devices like your TV, fan, cameras, thermostats, lights, and sensors. As a user, you can build intricate automation using Home Assistant's user-friendly, unified web-based user interface. +This repository provides **ready-to-use Armbian-based OS images** with selected open-source applications preinstalled and preconfigured. These images, known as **Armbian Appliances**, are designed to deliver out-of-the-box functionality while retaining the flexibility and performance of the Armbian base system. -Home Assistant Operating System is tailored for mainstream hardware such as Raspberry Pi and X86, while **Armbian Home Assistance**: -- extends installation to [large selection of devices](https://www.armbian.com/download/), -- provides option to use instance to host other applications, -- allows extended customisation of your OS. +Each appliance image transforms a supported single board computer (SBC) into a dedicated solution, such as: -|Functionality|HAOS|Armbian with HA| -|:--|:--:|:--:| -|Automations|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:| -|Dashboards|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:| -|Integrations|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:| -|Add-ons|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:| -|One-click updates|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:| -|Backups|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:| -|General purpose server|:x:|:white_check_mark:| -|Running on exotic hardware|:x:|:white_check_mark:| +- **Home automation hubs** (e.g. Home Assistant, openHAB) +- **Network-attached storage (NAS)** servers (e.g. OpenMediaVault) +- **Security auditing platforms** (e.g. Kali Linux tools on Armbian) -FAQ: +Compared to traditional application-specific OS builds, Armbian Appliances: -1. Where do I find images for my hardware? - -https://www.armbian.com/download -> select your device -> Dedicated applications +- Support a **wider range of hardware** beyond Raspberry Pi or x86 +- Allow **running multiple services** alongside the main application +- Provide **full access to the underlying Linux system** +- Are easily reproducible using the [Armbian build framework](https://github.com/armbian/build) -2. How do you generate my own image? - -[Follow instructions](https://forum.armbian.com/topic/33245-armbian-with-preinstalled-home-assistant-supervised/). - -3. There are no HA images for my device? - -If hardware is supported by Armbian ([.conf](https://github.com/armbian/build/tree/main/config/boards)), sent a pull request to the [configuration file](https://github.com/armbian/os/blob/main/userpatches/targets-release-apps.template). - -## [Armbian OpenHab](https://www.openhab.org/) (home automation) -## [Armbian Security](https://www.kali.org/) (Security applications - Kali) -## [Armbian OMV](https://www.openmediavault.org/) - (NAS: network attached storage) - -Sources: [extensions for Armbian build framework](https://github.com/armbian/os/tree/main/userpatches/extensions) +This repository contains configuration templates and logic for building these appliances, which are then published on [armbian.com/download](https://www.armbian.com/download).