Need help with pi-power-button?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

194 Stars 91 Forks 22 Commits 9 Opened issues


Scripts useful for the Pi power button

Services available


Need anything else?

Contributors list


Scripts used in our official Raspberry Pi power button guide.


  1. Connect to your Raspberry Pi via SSH
  2. Clone this repo:
    git clone
  3. Run the setup script:


If you need to uninstall the power button script in order to use GPIO3 for another project or something:

  1. Run the uninstall script:


A full list of what you'll need can be found here. At a minimum, you'll need a normally-open (NO) power button, some jumper wires, and a soldering iron. If you don't have a soldering iron or don't feel like breaking it out, you can use this prebuilt button instead.

Connect the power button to Pin 5 (GPIO 3/SCL) and Pin 6 (GND) as shown in this diagram:

Connection Diagram

Is it possible to use another pin other than Pin 5 (GPIO 3/SCL)?

Not for full functionality, no. There are two main features of the power button:

  1. Shutdown functionality: Shut the Pi down safely when the button is pressed. The Pi now consumes zero power.
  2. Wake functionality: Turn the Pi back on when the button is pressed again.

The wake functionality requires the SCL pin, Pin 5 (GPIO 3). There's simply no other pin that can "hardware" wake the Pi from a zero-power state. If you don't care about turning the Pi back on using the power button, you could use a different GPIO pin for the shutdown functionality and still have a working shutdown button. Then, to turn the Pi back on, you'll just need to disconnect and reconnect power (or use a cord with a physical switch in it) to "wake" the Pi.

Of course, for the GND connection, you can use any other ground pin you want.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.