Raspberry Pi With 4 Relay Module ( for Home Automation )





Introduction: Raspberry Pi With 4 Relay Module ( for Home Automation )

Firstly we will connect the raspberry and the 4 array module and test it locally. The next step is to make a web app that will control our module . We will make it with apache server , php , javascript , jquery , bootstrap , bootstrap- switch buttons and some python . Everything is explained with a comments when you open the file , you also can see the documentation in github. The files are uploaded here and can be also find in github .

Step 1: What You Need

We need :

  1. Raspberry Pi
  2. 4 Array Relay Module
  3. 6 Wires
  4. Wifi Dongle
  5. Filezilla (optional)
  6. SHH (optional)

Step 2: Wiring

We need to connect our Raspberry and the module .We will get the 5V from the Raspberry (not very recommended but its easy ) .So lets begin :

PI GPIO | Relay module

Pin 4 ---------VCC

Pin 6 ---------GND

Pin 8 ----------IN4

Pin 10 ---------IN3

Pin 11 ---------IN2

Pin 12 ---------IN1

Step 3: Testing

Now we need to start the raspberry and to connect to the power supply and connect to it over FTP with Filezilla or start it on monitor . Next download and put the test_relay.py file in the main dir (home/pi).Then start the python script by typing :

sudo python test_relay.py

If leds start flashing from IN1 to IN4 and shutdown from IN4 to IN1 then everything is okey and the wiring is like currect .We can move to the next step .


The relay boards are powered by 5v and the relays are triggered by taking the input pin to ground. Since the Raspberry Pi's GPIO pins output 3.3v I used a set of transistors to take the relay pins to ground.

So when you are setting the GPIO output value:

1) 0 the relay starts ;

2) 1 the relay stops .

Step 4: Installing Apache and Php

We will need them for the server part .Helpfull link.

To install apache2 we need to run :

sudo apt-get install apache2 -y

To test the webserver we can you on the raspberry browser

(raspberry ip address) .Type
to get the current IP .

Next install PHP5 module for APACHE :

sudo apt-get install php5 libapache2-mod-php5 -y

And remove index.html file :

sudo rm index.html

The next thing is to navigate to the default directory:

  • For Raspbian Wheezy is /var/www ,
  • For Rspbian Jessie is /var/www/html

So we type :

cd /var/www/html<br>ls -al

And this will output :

total 12<br>drwxr-xr-x  2 root root 4096 Jan  8 01:29 .<br>drwxr-xr-x 12 root root 4096 Jan  8 01:28 ..<br>-rw-r--r--  1 root root  177 Jan  8 01:29 index.html

We need to change the permission if we want to upload or modify files :

sudo chown pi: index.html

Delete the index.html file from the dir.

Step 5: Uploading the Needed Files for Your Web App

You need to download the .rar file , extract it and copy the files with Filezilla to the main dir of Raspberry home/pi and to the var/www. For pasting the files into var/www you need to set a permision .

at var/www<br>bootstrap.css<br>bootstrap-switch.css<br>bootstrap-switch.js<br>changeState.php<br>firstCheck.php<br>index.html<br>jquery.js
at home/pi

When you are done coping the files , just go to your browser , type RaspberryIP/index.html (ex: and the webpage will be opened .And also you can test it and remotely control the relays from any device that is connected to your local network(router) .

Step 6: How It Works

I will explain it shortly. If you want to get to more details you can see the project in github.

When we click on the button , the ajax request has been called and the php file from it is called . From the php we execute a python script file with some params . The python script return us json converted array , which we pass to the php and the php passes it to html file .We can go only in the one way but if we want to reload the page we need in what position the relays are . The other point is if we dont do it that way there is no feedback and we cant see what is happening .

Please share and write a comment bellow if it was usefull .

If you like my tutorial please donate.

To the next time .



    • Paper Contest 2018

      Paper Contest 2018
    • Pocket-Sized Contest

      Pocket-Sized Contest
    • Science of Cooking

      Science of Cooking

    We have a be nice policy.
    Please be positive and constructive.




    Can you help me?
    I can not install "sudo apt-get install php5 libapache2-mod-php5 -y" on Raspberry Pi 2 run os "2017-09-07-raspbian-stretch".
    I replaced "sudo apt-get install php" then PHP 7.0 @@.
    After, i run file .py on php but exec not working.
    Please help me!

    I too have tried this and have the same problem as many others.

    I went into the php and python code and put debug statements between practically every line until I found the problem (I think ???). However, I have not been able to work out a solution.

    The problem seems to center on the line in all the Python scripts:


    When this line is encountered in any of the three Python scripts, execution stops. Or at least output to my log files stops.

    I have also included the pinNum in the output of my debug and it is getting the correct pin number (14, 15, 17, 18).

    Of note, if I run the Python script directly it works fine - for example, if I go to the /var/www/html directory where the php code is and I enter the same command line with the path where I put the python scripts all three run as expected. However, when the python is called from the php code - not. I still get the expected output in my debug file - just all stops when it hits the GPIO.setup... line shown above.

    Any ideas?

    This looks like a great project and perfect for some of my home automation projects.

    Now if I can just get it to work .)



    Finally found a solution. Not the best (nor secure) by far, but it is working for now.

    The solution I found that worked was in this post:


    Basically involved changing how php called the py code - using the php shellexec and entering the www-data entry into the /etc/sudoers file. I undid the chmod +s and file ownership back to the original settings on the python modules. And it still works so now to move on and do my project - randomly turning lights on and off in the house from the office when I am working mid-night shifts and the wife is home alone sleeping ;}

    Hey there, I followed everything step by step but when I go to my website and press the buttons nothing happens. Relay works perfectly with the test_relay program. Any solution? :D

    When you try the test_relay.py file it only Turns On the relays ? Or in some other case it stays in the On position ?

    no way to access the RPI by smartphone via network 4g starting work?


    Yes you can by setting port forwarding in your home router (googling port forward for more details)

    existe forma de aceder ao rpi por smartphone via rede 4g apartir do trabalho?

    Hey, it is running now. I have changed the power supply from 5V to 3,3 V so that the output of the GPIO and the power supply have the same voltage. Then it is running.

    I will check now what circuit would be a good to add in advance to make it save running.

    Any advice? Thanks a lot, Mathias