86 lines
4.1 KiB
Markdown
86 lines
4.1 KiB
Markdown
# nymea - open source IoT edge server
|
||
--------------------------------------------
|
||
<p align="center">
|
||
<a href="https://nymea.io">
|
||
<img src="https://nymea.io/downloads/img/nymea-logo.svg" width=300>
|
||
</a>
|
||
</p>
|
||
|
||
nymea (/[n'aiːmea:]/ - is an open source IoT edge server. The plug-in based architecture allows to integrate protocols and APIs. With the built-in rule engine you are able to interconnect devices or services available in the system and create individual scenes and behaviours for your environment.
|
||
|
||
## Quick start
|
||
|
||
### Install nymea on a Raspberry Pi
|
||
|
||
<p align="center">
|
||
<img src="https://nymea.io/downloads/img/nymea-pi.svg" width=300 >
|
||
</p>
|
||
|
||
We have created an image for your Raspberry Pi that comes with an array of plugins for different smart devices!
|
||
|
||
Use the [Raspberry Pi imager](https://www.raspberrypi.com/software/) and select nymea as operating system. You'll have the
|
||
choice between a headless nymea:core setup or a kiosk image that contains nymea:core and nymea:app for Raspberry Pis with touch screen.
|
||
|
||
Alternatively, the image can be downloaded and flashed manually from [here](https://downloads.nymea.io/images/raspberrypi/). We recommend
|
||
the latest Raspberry Pi OS Bookworm [core](https://downloads.nymea.io/images/raspberrypi/nymea-core-image-raspios-bookworm-latest.zip) or
|
||
[kiosk](https://downloads.nymea.io//images/raspberrypi/nymea-kiosk-image-raspios-bookworm-latest.zip) image.
|
||
|
||
### Get nymea:app here:
|
||
|
||
<table align="middle">
|
||
<tr>
|
||
<td>
|
||
<p>
|
||
<a href="https://apps.apple.com/us/app/nymea-app/id1400810250">
|
||
<img border="0" align="middle" alt="iOS Badge" src="https://nymea.io/downloads/img/app-store/appstore.png" width=200>
|
||
</p>
|
||
</td>
|
||
<td>
|
||
<p>
|
||
<a href="https://play.google.com/store/apps/details?id=io.nymea.nymeaapp&hl=en&pcampaignid=MKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1">
|
||
<img border="0" align="middle" alt="Android Badge" src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" width=250>
|
||
</p>
|
||
</td>
|
||
<td>
|
||
<p>
|
||
<a href="https://open-store.io/app/io.guh.nymeaapp">
|
||
<img border="0" align="middle" alt="Openstore Badge" src="https://open-store.io/badges/en_US.png" width=200>
|
||
</p>
|
||
</td>
|
||
<td>
|
||
<p>
|
||
<a href="https://downloads.nymea.io/nymea-app/windows/latest">
|
||
<img border="0" align="middle" alt="Windows Badge" src="https://nymea.io/downloads/img/app-store/windows.svg" width=200>
|
||
</p>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
Manual download files of nymea:app can be found [here](https://downloads.nymea.io/nymea-app/).
|
||
|
||
A detailed description how to install and getting started with *nymea* can be found in the [nymea | user documentation](https://nymea.io/documentation/users/installation/getting-started).
|
||
|
||
## Developing with nymea
|
||
|
||
A detailed documentation on how to develop with *nymea* is available on the [nymea | developer documentation](https://nymea.io/documentation/developers/).
|
||
|
||
## Network discovery
|
||
|
||
When starting nymead as user without root privileges, the network device discovery will not available due to missing raw socket permission.
|
||
If you still want to make use of this feature, the binary capabilities need to be adjusted.
|
||
|
||
sudo setcap cap_net_admin,cap_net_raw=eip /usr/bin/nymead
|
||
|
||
This will allow nymead to create raw sockets for ARP and ICMP network discovery tools even when nymead gets started as user without root privileges.
|
||
|
||
## License
|
||
--------------------------------------------
|
||
nymea is free software developed by chargebyte austria GmbH, former nymea GmbH.
|
||
Server components, tools, plugins and tests in this repository are licensed under the GNU General Public License version 3 or (at your option) any later version.
|
||
Public SDK libraries found in `libnymea/` and `libnymea-core/` are provided under the GNU Lesser General Public License version 3 or (at your option) any later version so they can be linked from external applications.
|
||
|
||
Copyright (C) 2013 - 2024, nymea GmbH
|
||
Copyright (C) 2024 - 2026, chargebyte austria GmbH
|
||
|
||
See `LICENSE.GPL3` and `LICENSE.LGPL3` for the complete license texts.
|