Awesome Open Source
Awesome Open Source


Web Control Panel for Raspberry Pi

Original repository:

If you like the GumCP: please ⭐️star the GumCP repo to make it more popular! You can also Donate to support more frequent updates of GumCP if you wish!

Web Control Panel for Raspberry Pi

Find more screenshots in the screenshots folder.


Web Control Panel for Raspberry Pi


  • system details, like cpu load, disk and memory usage, cpu temperature etc.
  • start/stop services
  • kill processes
  • change mode and value of the GPIO pins
  • system reboot
  • system update
  • execute command (for advanced users only) requires php-ssh2
  • create custom buttons to execute custom commands (i.e. set GPIO pin to HIGH/LOW, execute python script, execute bash script etc.) requires php-ssh2
  • added third party modules like: File Manager and Database Manager which you can activate in the config.php file

How to install GumCP (simple way) which should work in most cases

  1. Login to your Raspberry Pi via ssh.

    default username is: pi

    default password is: raspberry

  2. run this command:

cd && sudo apt-get update && sudo apt-get install wget -y
  1. run this command:
sudo wget && sudo sh ./

This should install everything.

Other ways of installation

To install web server on your raspberry pi do this you can use the instructions from here: or use commands below

sudo apt-get update && sudo apt-get install apache2 php5 php5-ssh2

install git:

sudo apt-get update && sudo apt-get install git

make sure that php5-ssh2 is installed:

sudo apt-get install php5-ssh2


sudo apt-get install php-ssh2

restart apache:

sudo service apache2 restart

Get the wiringPi project using this commands:

git clone git://
cd wiringPi
git pull origin

Install GumCP:

cd /var/www/html

sudo git clone

make your changes to your /include/config.php file.

open GumCP in your browser:


To upgrade GumCP use this commands:

cd /var/www/html/GumCP

sudo git pull origin

after update make sure to edit the include/config.php file

If the actions.php or buttons.php page doesn't open or you get some http error, it means that php-ssh2 is not installed.

For PHP 7 use this:

sudo apt-get install php7.0-ssh2

For PHP 7.1 use this:

sudo apt-get install php7.1-ssh2

Or try this command:

sudo apt-get install php-ssh2

If your Raspberry Pi is accessible from internet, you should tell the bots and spiders like googlebot not to crawl the pages of GumCP and exclude GumCP from search results with a robots.txt file. Just create a file robots.txt, place it in the webroot of your raspberry pi (usually its /var/www/html/) and define in the robots.txt the parts of web content which shouldn't be crawled like this:

User-agent: *
Disallow: /GumCP/

which disallows access to GumCP folder


User-agent: *
Disallow: /

to exclude the entire web root from being crawled by bots

TeHyBug module

TeHyBug is a low power temperature/humidity and barometric air pressure wifi data tracker which can be ordered here:

The TeHyBug module requires sqlite3 to be installed:

sudo apt-get install sqlite3

For php5 sudo apt-get install php5-sqlite

For php7 sudo apt-get install php7.0-sqlite3


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
php (16,694
css (7,421
web (1,041
http (938
raspberry-pi (656
js (555
cpu (137
raspberrypi (129
raspberry (60
raspbian (50
rpi (50
control-panel (19