Installation instructions

Installation (for Mac OS X)

Make sure you have brew installed and updated: http://brew.sh/.

brew install lopter/lightsd/lightsd

Or,

brew tap lopter/lightsd
brew install lightsd

Please, also install Python 3 and ipython if you want to follow the examples in the next section:

brew install python3
pip3 install ipython

Read on First steps to see how to use lightsd.

Installation (for Arch Linux)

Note

A pre-built package may already exist at: https://downloads.lightsd.io/archlinux/ for your convenience.

Make sure you have Yaourt installed: https://archlinux.fr/yaourt-en (wiki page):

yaourt -Sya lightsd

Make sure to follow the post-installation instructions: replace $USER with the user you usually use.

Please also install ipython if you want to follow the examples in the next section:

yaourt -Sya ipython

Read on First steps to see how to use lightsd.

Installation (for Debian/Raspbian)

Check if an appropriate package exists at: https://downloads.lightsd.io/debian/. Download it and install it with dpkg -i.

If you were able to install lightsd from a package then read on First steps to see how to use lightsd. Otherwise look for the Debian/Ubuntu build instructions below.

Installation (for OpenWRT)

Check if a package already exists at: https://downloads.lightsd.io/openwrt/. If that’s the case transfer it to your device and install the package with opkg install. The lightsd package will depend on libevent2-core.

If you were able to install lightsd from a package then read on First steps to see how to use lightsd. Otherwise look for the OpenWRT build instructions below.

Build instructions (for Debian based systems, including Ubuntu/Raspbian)

Note

Those instructions have been tested on Debian Wheezy & Jessie.

Install the following packages:

apt-get install build-essential cmake libevent-dev git ca-certificates ipython3 fakeroot wget devscripts debhelper

Download and extract lightsd:

wget -O lightsd_1.2.1.orig.tar.gz https://downloads.lightsd.io/releases/lightsd-1.2.1.tar.gz
tar -xzf lightsd_1.2.1.orig.tar.gz
cd lightsd-1.2.1
wget -O - https://downloads.lightsd.io/releases/dpkg-1.2.1.tar.gz | tar -xzf -

Build the package:

debuild -uc -us

Install the package:

Note

You will need to run this command as root with sudo(8) or be logged in as root already.

dpkg -i ../lightsd_1.2.1-1_$(dpkg --print-architecture).deb

Still as root, run the command the package asks you to run:

gpasswd -a $USER lightsd

Note

Unless you are using sudo, don’t forget to replace $USER with your username.

Log out and back in as $USER for the change to take effect.

Read on First steps to see how to use lightsd.

Build instructions (for OpenWRT)

Follow the buildroot instructions then, from your build root, just add lightsd’s feed:

cat >>feeds.conf$([ -f feeds.conf ] || echo .default) <<EOF
src-git lightsd https://github.com/lopter/openwrt-lightsd.git
EOF
./scripts/feeds update -a

Install lightsd:

./scripts/feeds install lightsd

Run your usual make menuconfig, make firmware flash flow, lightsd should be running at startup. If you only wish the build the lightsd package and not the entire system follow the single package howto.

Read on First steps to see how to use lightsd.

Build instructions (for other systems)

lightsd should work on any slightly POSIX system (i.e: not Windows), make sure you have the following requirements installed:

  • libevent ≥ 2.0.19 (released May 2012);
  • CMake ≥ 2.8.9 (released August 2012).

lightsd is developed and tested from Arch Linux, Debian, OpenBSD and Mac OS X; both for 32/64 bits and little/big endian architectures.

Please also install ipython with Python 3 if you want to follow the examples in the next section.

From a terminal prompt, clone the repository and move to the root of it:

git clone https://github.com/lopter/lightsd.git
cd lightsd

From the root of the repository:

mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=RELEASE ..
make -j5 lightsd

Read on First steps to see how to use lightsd.