Installation ============ * `Linux Debian Based`_ * `Windows 7 and up`_ * `OpenWRT Routers`_ Linux Debian Based ------------------ Install pilight by using the apt repository in Debian / Ubuntu based distributions. #. Login to your computer. #. Make sure you are running as root. Run the following command and use your own password. .. code-block:: console pi@pilight:~# sudo su Password: #. Add the apt repository to the apt sources list: .. code-block:: console pi@pilight:~# echo "deb http://apt.pilight.org/ stable main" > /etc/apt/sources.list.d/pilight.list If you want to install the nightly version of pilight then also add: .. code-block:: console root@pilight:~# echo "deb http://apt.pilight.org/ nightly main" >> /etc/apt/sources.list.d/pilight.list #. pilight uses a signed repository. This means packages get validated before installation. So, to safely download and install pilight packages the pilight key needs to be installed. .. code-block:: console root@pilight:~# wget -O - http://apt.pilight.org/pilight.key | apt-key add - #. Now update the apt package list: .. code-block:: console root@pilight:~# apt-get update #. And install pilight .. code-block:: console root@pilight:~# apt-get install pilight #. When no errors are shown, pilight will be installed and automatically started at boot time. To manually start pilight: .. code-block:: console root@pilight:~# service pilight start #. And to stop pilight: .. code-block:: console root@pilight:~# service pilight stop .. note:: pilight makes it easy to install previous version, because all stable versions and all nightly versions between two stable versions will remain available in the apt repository. To see what versions are available, you can run the following command: .. code-block:: console root@pilight:~# apt-cache policy pilight pilight: Installed: 7.0.16-g233c268 Candidate: 7.0.21-ga8b12ea Version table: 7.0.21-ga8b12ea 500 500 http://apt.pilight.org nightly/main armhf Packages *** 7.0.16-g233c268 500 500 http://apt.pilight.org nightly/main armhf Packages 7.0.9-gfbc2643 500 500 http://apt.pilight.org nightly/main armhf Packages 7.0.8-g953bb85 500 500 http://apt.pilight.org nightly/main armhf Packages 7.0 500 500 http://apt.pilight.org stable/main armhf Packages 6.0 500 500 http://apt.pilight.org stable/main armhf Packages 5.0 500 500 http://apt.pilight.org stable/main armhf Packages 4.0 500 500 http://apt.pilight.org stable/main amd64 Package In this case, both the stable and the nightly apt repositories are enabled. If you want to install a specific version run the following command: .. code-block:: console root@pilight:~# apt-get install pilight=7.0.67-g960219e .. raw:: latex \newpage Windows 7 and up ---------------- #. Go to http://download.pilight.org. #. Download the latest Windows executable called pilight-vX.0-win32.exe. Run it to install pilight. #. By default pilight will install into to c:\\pilight\\. #. A default configuration can also be found in that folder. #. If you want to use the pilight USB nano you can use the pilight-usb-nano.hex found in the default folder. OpenWRT Routers --------------- #. When using OpenWRT you are assumed also to know how to login to your router with SSH. #. Go to http://download.pilight.org. #. Download the latest pilight OpenWRT compilation called pilight-Atheros-AR9132-vX.0.tar.gz. #. Unpack this file like this: .. code-block:: console root@OpenWrt:~# tar -zxvf pilight-Atheros-AR9132-vX.0.tar.gz -C / #. The OpenWRT package only contains pilight-daemon to save space. #. A default configuration is put into /etc/pilight/config.json. Manually Compiled Version ------------------------- .. warning:: We try to provide as many options as possible for you to keep up-to-date with the latest developments. Compiling C software requires some level of expertise, which we cannot and will not provide. This means that **no support is given** if any issues occur with manually compiling pilight. Manually compiling pilight is also possible. Use this method is you are not using a Debian-based or a \*BSD based operating system. #. Login to your computer. #. Make sure you've configured the pilight stable apt repository, because some required dependencies are not available elsewhere. #. Make sure you are running as root. Run the following command and use your own password. .. code-block:: console pi@pilight:~# sudo su Password: #. Install all packages needed for manually compiling pilight. The best way to do this depends on your operating system. The packages needed for Debian are: #. build-essential #. cmake #. git #. dialog #. libwiringx-dev #. libwiringx #. libpcap0.8-dev #. libpcap0.8 #. libmbedtls-dev #. libmbedx509-0 #. libmbedcrypto0 #. libmbedtls10 #. liblua5.2 #. liblua5.2-dev #. Then download the pilight source code from the pilight GitHub: .. code-block:: console root@pilight:~# git clone --depth 5 -b [branch] https://www.github.com/pilight/pilight.git root@pilight:~# cd pilight #. Replace the [branch] with either **master** for the latest stable version. This version is exactly the same as the stable version available through the apt repository. Or use **development** for the very latest developmental build. This development version of pilight is also automatically generated each night. You can download it from the pilight nightly repository. #. pilight can be compiled with various built-in features which can be included or excluded. This is done through a menu driven program. This program will also automatically compile and install pilight: .. code-block:: console root@pilight:~/pilight# chmod +x setup.sh root@pilight:~/pilight# ./setup.sh .. image:: images/installation.png #. When you are thrown back into the command prompt without error(s), pilight has been installed successfully. It will also install a default configuration in /etc/pilight/config.json. #. Make sure to run the following command after installation: .. code-block:: console root@pilight:~/pilight# ldconfig #. pilight can now be started with: .. code-block:: console root@pilight:~/pilight# service pilight start