191 lines
6.5 KiB
ReStructuredText
191 lines
6.5 KiB
ReStructuredText
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
|