New pilight version 6.0 has been released!

If you have troubles with pilight 6 starting on boot just reinstall it.
There was a small bug in the installation package.

sudo apt-get update
sudo apt-get install --reinstall pilight

What is pilight?

pilight is an Open Source and Free domotica solution that runs on various small form factor computers with support for more than 60 different devices. It offers an integrated webGUI natively Android App and a advanced Eventing library. For more information check the About Us page.

The latest pilight version is 6.0 which has been released on the 24th of February 2015.


If you want to get started quickly, read the Installation and Configuration pages.

If you need the correct hardware, check out our Shop. When buying your hardware from pilight, you also support the project.

In you encounter issues, first check the FAQ for the most common questions. If this doesn't resolve your issue, ask us on the Forum.

If you need more in-depth information on various topics, refer to the wiki.

To see the Full Potential of pilight, check the build of our user Terrar, who uses pilight to automate his Terrarium.

Quick start guide

This guide is written with the Raspberry Pi as an example. If you use one of the other supported devices please check wiringX for the proper GPIO pin numbering.

This step-by-step assumes you know basic Linux commands to edit text files and have some basic electronic skills.

  1. Order the hardware
    1. Go to shop and order the Full Kit.
    2. Get yourself a small blank circuit board or breadboard to solder the components on.
    3. Get a Raspberry Pi with at least an SD card and a charger.
  2. Hook it up
    1. Hook up the filter according to the schemetic provided with the Filter.
    2. Connect the DATA pin on the Receiver to the 433.92 Receiver Data Pin on the Filter.
    3. Connect the 5v pins on the Filter, the Sender and the Receiver to the 5v pin (pin 2 or pin 4) on the Raspberry Pi.
    4. Connect the GND pins on the Filter, the Sender and the Receiver to the GND pin (pin 6, 9, 14, 20 or 25) on the Raspberry Pi.
    5. Connect the DATA on the Sender to pin 11 on the Raspberry Pi.
    6. Connect the pilight IN on the Filter to pin 12 on the Raspberry Pi.

      The next steps are optional, but recommended, they are for updating the firmware on the Filter.
    7. Connect the MOSI on the Filter to pin 19 on the Raspberry Pi.
    8. Connect the MISO on the Filter to pin 21 on the Raspberry Pi.
    9. Connect the SCK on the Filter to pin 23 on the Raspberry Pi.
    10. Connect the RESET on the Filter to pin 24 on the Raspberry Pi.
  3. Install the software on the Raspberry Pi
    1. Download one of the supported Operation Systems.
    2. Follow the instructions to write it to your SD card.
    3. Plug the SD card in the Raspberry Pi and follow the instructions on screen.
    4. Follow the steps in the installation manual to install pilight.
  4. Configuring pilight
    1. All configurations are done to the file: /etc/pilight/config.json.
    2. Before any configurations are done you have to stop the pilight service (sudo service pilight stop).
    3. After the configuration you have to start the pilight service again (sudo service pilight start).
    4. Read getting started and read it again.
  5. More help?
    1. Look around on this website.
    2. Look around on the pilight wiki.
    3. Search through the forum.
    4. Post a question on the forum.

Thanks to our forum user bazb for this write up.

Published on