Shutdown button with Raspberry PI and Python


Because of their low price, mini button switches are useful for many purposes. We have already analyzed how they work (ref. Using mini Switch Button with Raspberry PI and Python) and a funny use case (ref. Reaction Game (v2) with Raspberry PI and Mini Button Switch).

Switch Button

One more way to use these buttons allows people to solve a practical need: shutting down their Raspberry PI.

You know that powering off a RPI requires being logged in and following procedure:

In this tutorial I’m going to show you how to create a physical shutdown button for Raspberry PI.

I’ll use a Raspberry PI Zero W, but this tutorial applies to all Raspberry PI boards.

Follow peppe8o posts on -> Twitter

What We Need

As usual, I suggest adding from now to your favourite e-commerce shopping cart all the needed hardware, so that at the end you will be able to evaluate overall costs and decide if continue with the project or remove them from the shopping cart. So, hardware will be only:

Raspberry PI Zero W unpopulated

You can also evaluate the useful Elegoo kit, including electronic components (excluding Raspberry PI and it accessories) plus many other useful sensors.

Check hardware prices with following links:

Amazon raspberry pi boards box
Amazon raspberry pi Zero W box
Amazon Micro SD box
Amazon Raspberry PI Power Supply box
Amazon Dupont Wiring box
Amazon Breadboard box
Amazon mini button switch box

Wiring Diagram

This wiring diagra is really simple to arrange, as it requires only 2 wires, a button and a button. Please note that cables are connected to ground and GPIO 21 (according to Raspberry PI pinout):

Raspberry PI shutdown button wiring

Please find below some detail pictures:

Raspberry PI shutdown button overall picture
Raspberry PI shutdown button board details
Raspberry PI shutdown button breadboard details

Step-by-Step Procedure

Prepare Operating System

Start installing Raspberry PI OS. You can both install Raspberry PI OS Lite (for headless, fast environments) or Raspberry PI OS Desktop (in this case, using its internal terminal).

Make your OS up-to-date. From terminal, issue following command:

sudo apt update -y && sudo apt upgrade -y

You don’t need to install Python, as it is already installed in all Raspberry PI OS distros.

RPI.GPIO should be already installed (otherwise, you can get it installed with the command “sudo apt install python3-rpi.gpio”).

Prepare Shutdown Button Script with Python

You can easily get a copy of my shutdown script directly in your Raspberry PI with following terminal command:


Following lines explain script parts.

Required libraries are imported to be used in script. We use RPI.GPIO libary to manage PINs and OS library to get shutdown command working:

import RPi.GPIO as GPIO
import os

Then we associate shutdownPIN variable to improve code reading and PINs management. Change it if you use a different wiring:

shutdownPIN = 21

We then set used PIN according to our needs. First row set naming convention to Broadcom (BCM), then shutdownPIN is defined as INPUT, also using a pull-up software defined resistance to get it up when reading undefined state (please read Using mini Switch Button with Raspberry PI and Python about this configuration):

GPIO.setup(shutdownPIN,GPIO.IN, pull_up_down=GPIO.PUD_UP)

We also use a shutStarted variable. This will start to 0 and will be set to 1 once a shutdown procedure is started, so avoiding repeated shutdown commands if button is keep pushed:

shutStarted = 0

Then main program starts. The “try:” … “except” statement manages script running, catching and driving correctly exceptions.

All the work is performed by an endless while loop. Only if a previous shutdown has not performed by this script (“not(shutStarted)“) and button is pressed (“not(GPIO.input(shutdownPIN))“), then shutStarted variable is set to 1 and a “systemctl poweroff” command is send to operating system.

while True:
    if not(shutStarted) and not(GPIO.input(shutdownPIN)):
      shutStarted = 1
      os.system("systemctl poweroff")

Last script part only manages script interruption (CTRL+C from keyboard), by cleaning GPIO status and printing an “interrupted” message on console:

except KeyboardInterrupt:

Managing Poweroff Permissions

As you know, poweroff/shutdown command in Raspberry PI requires root privileges (“sudo shutdown -h“). To avoid script from going in error because of missing superuser authentication, we need to allow pi user to execute poweroff command in “raspberrypi” host without needing to type root/superuser password. This can be achieved by appending a specific row in sudoers file. Open to edit this file:

sudo nano /etc/sudoers

And append at the end following row:

pi raspberrypi =NOPASSWD: /usr/bin/systemctl poweroff

Save and exit. You could need a reboot for this change to be running.

Test Shutdown Script

From here, you can test your shutdown script by using following command:


Then push your button and Raspberry PI will immediately start to power off.

Running Shutdown Script as a Daemon

You can also need to use shutdown script as daemon, running in background from boot and managing its staus from systemctl.

To reach this, move in /usr/bin/ folder:

sudo mv /usr/bin/

Create a new service under /etc/systemd/system/ folder:

sudo nano /etc/systemd/system/shutdownButton.service

and add following lines:

Description=Shutdown button python script

ExecStart=/usr/bin/env python3 /usr/bin/


Close and save. Start your new service with command:

sudo systemctl start shutdownButton.service

Chech it is running correctlywith systemctl status, getting something similar to following:

pi@raspberrypi:~ $ sudo systemctl status shutdownButton.service
shutdownButton.service - Shutdown button python script
Loaded: loaded (/etc/systemd/system/shutdownButton.service; disabled; vendor
Active: active (running) since Tue 2020-11-24 16:52:11 GMT; 22s ago
Main PID: 1088 (python3)
Tasks: 1 (limit: 881)
CGroup: /system.slice/shutdownButton.service
└─1088 python3 /usr/bin/
Nov 24 16:52:11 raspberrypi systemd[1]: Started Shutdown button python script.

Moreover, if you want this script running after each reboot, enable it with systemctl:

sudo systemctl start shutdownButton.service

And test your button.

Final thoughts

Before closing this tutorial, I want to share some considerations.

Using a mini button switch for shutdown is a simple and practical way to trigger RPI power off without the need of entering its desktop or terminal and avoiding risks to corrupt filesystem with mere power supply detachment.

If you use RPI.GPIO python library within other scripts and closing them with GPIO.cleanup(), you need to manage shutdown PIN from being cleaned and disabled.

An alternative way to implement a shutdown button is also acting on overlay settings from /boot/config.txt (refer to for more info).


How useful was this post?

Click on a star to rate it anonymously!

Average rating 5 / 5. Vote count: 3

No votes so far! Be the first to rate this post.

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?