nymea:core

The typical use case is to have nymea:core installed on a low power machine in the network. nymea offers a ready to use Raspberry Pi image for this but it can also be installed manually on any GNU/Linux based system. nymea provides repositories with packaged builds for Ubuntu and Debian, as well as a distribution independent snap.

Raspberry Pi

The recommended way to install nymea on a Raspberry Pi is to use nymea’s prebuilt images for the Raspberry Pi. However, if you already have a Raspberry Pi set up, nymea can be installed on top of that without the need of reflashing the entire SD Card.

Please pick one of the options below:

Raspberry Pi images

The latest Raspberry Pi image can be obtained from the nymea downloads section.

After downloading, this image needs to be written to an SD card. This step varies between operating systems.

nymea recommends to use balenaEtcher for writing the image to the SD card.

Alternatively, various other options can be found at the Raspberry Pi installation guide. The nymea image is built using the same tools as the Raspberry Pi image and all the provided installation guides should work for the nymea image too.

After the image has been written to the SD card, insert the SD card into the Raspberry Pi and connect it to the power supply. nymea:core will automatically start upon boot. Please proceed with the usage guide.

Manual installation on a Raspberry Pi

If the nymea Raspberry Pi image is not used, nymea:core can also be installed on an existing Raspberry Pi running Raspbian.

Create a file named /etc/apt/sources.list.d/nymea.list with this content:

deb http://repository.nymea.io buster rpi

Add the repository signing key by running

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key A1A19ED6

Once done so, nymea:core can be installed using apt-get:

sudo apt-get update
sudo apt-get install nymea nymea-plugins

Once this command completes, nymea:core should be up and running on the Raspberry Pi.

Debian GNU/Linux and Ubuntu

The recommended way to install nymea on a Debian GNU/Linux or Ubuntu machine is to use nymea’s repository. However, nymea also offers the option to install nymea:core using a snap directly from the snap store.

Please pick one of the options below:

Using apt-get

nymea provides a repository for Debian GNU/Linux and Ubuntu.

Currently, these versions are officially supported:

  • Debian 9 (“stretch”)
  • Debian 10 (“buster”)
  • Ubuntu 16.04 (“xenial”)
  • Ubuntu 18.04 (“bionic”)
  • Ubuntu 19.10 (“eoan”)

For each of the repositories four architectures are provided:

  • i386
  • amd64
  • armhf
  • arm64

To enable the repository, create a file named /etc/apt/sources.list.d/nymea.list with the following content:

Note: Replace <distro> with the codename of the distro, e.g. buster for Debian 10 or bionic for Ubuntu 18.4

deb http://repository.nymea.io <distro> main

Add the repository signing key by running:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key A1A19ED6

Once done so, nymea:core can be installed using apt-get:

sudo apt-get update
sudo apt-get install nymea nymea-plugins

Once this command completes, nymea:core should be up and running.

From the Snap store

The nymea:core snap can be found in the snap app store. For the snap, nymea provides amd64 and armhf packages.


It can be installed using the app store application of the used distribution, or via this command:

sudo snap install nymea

Other distributions or architectures

To install nymea:core on other distributions or architectures, nymea:core needs to be built manually from the sources. Please see the developer section for instructions on how to build nymea:core.