Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/superbox-dev/unipi-control-os
Unipi Control OS is a Linux based operating system optimized to host Unipi Control.
https://github.com/superbox-dev/unipi-control-os
buildroot embedded internet-of-things iot raspberry-pi smarthome unipi
Last synced: about 2 months ago
JSON representation
Unipi Control OS is a Linux based operating system optimized to host Unipi Control.
- Host: GitHub
- URL: https://github.com/superbox-dev/unipi-control-os
- Owner: superbox-dev
- License: apache-2.0
- Created: 2021-08-11T10:08:36.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-12T19:51:56.000Z (8 months ago)
- Last Synced: 2024-05-12T23:22:03.005Z (8 months ago)
- Topics: buildroot, embedded, internet-of-things, iot, raspberry-pi, smarthome, unipi
- Language: Shell
- Homepage:
- Size: 934 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://opensource.org/license/apache-2-0/)
# Unipi Control OS
Unipi Control OS is a lightweight and memory-efficient Linux based operating system optimized to host [Unipi Control](https://github.com/mh-superbox/unipi-control).
---
For more information please read the documentation at:
[docs.superbox.one](https://docs.superbox.one)
---
## Getting started
1. Download the latest [release](https://github.com/superbox-dev/unipi-control-os/releases) `*.img.xz` from GitHub.
2. Write the image `*.img.xz` to your SD card with [Balena Etcher](https://www.balena.io/etcher).
3. Insert SD card to your Unipi Neuron and power the system on.
4. Connect to your Unipi Neuron with `ssh` on Linux/macOS or with [Putty](https://www.putty.org/) on Windows (The username and password are `unipi`).
```shell
ssh [email protected]
```
5. Install Unipi Control with the OPKG package manager.
```shell
sudo opkg install unipi-control
```
6. Read the [Unipi Control documentation](https://github.com/superbox-dev/unipi-control#configuration) to configure your Unipi Neuron and copy the configuration files to `/usr/local/etc/unipi`.
7. Start the service with:
```shell
sudo systemctl start unipi-control.service
```
The Unipi Neuron I/O are now available in your network via MQTT.
> Optionally: You can use the Unipi Neuron I/O in Home Assistant. Read the [MQTT documentation](https://www.home-assistant.io/integrations/mqtt) from Home Assistant.
## Supported hardware
- Unipi Neuron (Raspberry Pi 3B+)
If you have an Unipi device, that is not supported, then contact use.
## Changelog
The changelog lives in the [CHANGELOG.md](CHANGELOG.md) document. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## Contributing
We're happy about your contributions to the project!
You can get started by reading the [CONTRIBUTING.md](CONTRIBUTING.md).
## Donation
We put a lot of time into this project. If you like it, you can support us with a donation.
[](https://ko-fi.com/F2F0KXO6D)
## Additional information
This is a third-party software for [Unipi Neuron](https://www.unipi.technology). This software **is NOT** from [Unipi Technology s.r.o.](https://www.unipi.technology).