If you find GumCP useful, please ⭐️ star the repo to help others find it!

More screenshots in the screenshots folder.

• Dashboard — live CPU usage, temperature, memory & disk, uptime, load averages, active users (auto-refreshes every 30 s without reloading the page)
• Services — list all system services with their status; start or stop any service with one click (loads asynchronously so the page appears instantly)
• Processes — browse running processes sorted by memory usage; kill by PID or name
• GPIO control — view and toggle pin mode (IN/OUT), voltage (HIGH/LOW) and pull-up/down for all header pins; auto-detects WiringPi (Pi 1–4) or raspi-gpio (Pi 5)
• Command Buttons — create custom one-click buttons for any shell command; choose between a confirmation modal or direct execution with inline output; drag to reorder
• Button API — every button gets a unique secret URL; call it from curl, Home Assistant, or any automation tool without logging in
• Actions — execute arbitrary shell commands over SSH; run commands in the background with output saved to a log file; reboot; pull the latest GumCP version from GitHub with one click
• phpinfo — view PHP configuration directly from the browser
• System Check — built-in diagnostic page (check.php) that verifies PHP extensions, directory permissions, SSH connectivity and GPIO tools; Fix buttons repair common issues over SSH without touching the terminal
• Menu reorder — drag and drop navbar items into any order; preference saved automatically
• Authentication — optional login page, HTTP Basic Auth, or both simultaneously with separate credentials
• Optional modules — File Manager, Database Manager, TeHyBug sensor support (temperature, humidity, barometric pressure)

PHP 7.0, 7.4, 8.0, 8.1, 8.2, 8.3 are all supported.

Run these two commands on your Raspberry Pi (via SSH or a terminal):

sudo apt-get update && sudo apt-get install -y wget
wget https://raw.githubusercontent.com/gumslone/GumCP/master/installer.sh && bash ./installer.sh

The installer will:

• Install Apache, PHP and all required extensions (php-ssh2, php-sqlite3, php-curl, php-zip)
• Install WiringPi (Pi 1–4) or raspi-gpio (Pi 5) automatically
• Clone GumCP into /var/www/html/GumCP/
• Create include/config.php from the bundled template
• Create writable directories (buttons/, command_logs/) with correct ownership
• Set file permissions for the www-data web-server user

Once complete, open GumCP in a browser:

http://<your-pi-ip>/GumCP/

Default credentials (set in include/config.php):

• Username: pi
• Password: raspberry

Change these before exposing GumCP to any network.

wget https://raw.githubusercontent.com/gumslone/GumCP/master/uninstall.sh && bash ./uninstall.sh

The uninstaller will:

• Ask whether to back up your config.php, buttons and logs to ~/gumcp_backup_<timestamp>/ before removing anything
• Remove /var/www/html/GumCP/
• Leave Apache, PHP, WiringPi and all other system packages untouched

sudo apt-get update
sudo apt-get install -y apache2 php libapache2-mod-php php-ssh2 php-sqlite3 php-curl php-zip
sudo systemctl restart apache2

Pi 1, 2, 3, 4 — WiringPi community fork (the original git.drogon.net URL is no longer available):

git clone https://github.com/WiringPi/WiringPi.git ~/wiringPi
cd ~/wiringPi && ./build

Pi 5 — WiringPi does not support the RP1 GPIO chip; use raspi-gpio instead:

sudo apt-get install -y raspi-gpio

GumCP's GPIO page detects the available tool automatically.

sudo git clone https://github.com/gumslone/GumCP.git /var/www/html/GumCP
cd /var/www/html/GumCP

# Create your local config from the template
sudo cp include/config.example.php include/config.php

# Create runtime directories
sudo mkdir -p buttons command_logs

# Set ownership and permissions
sudo chown -R www-data:www-data /var/www/html/GumCP
sudo chmod -R 755 /var/www/html/GumCP
sudo chmod 664 /var/www/html/GumCP/include/config.php

Edit include/config.php to set your credentials and SSH settings:

sudo nano /var/www/html/GumCP/include/config.php

Key settings:

define('SSH_PORT', '22');        // SSH port
define('SSH_USER', 'pi');        // SSH username
define('SSH_PASS', 'raspberry'); // SSH password

define('LOGIN_REQUIRED', false); // true = require login via the login page
define('LOGIN_USER', 'pi');
define('LOGIN_PASS', 'raspberry');

define('BASIC_AUTH', false);     // true = also accept HTTP Basic Auth
define('BASIC_AUTH_USER', 'api');
define('BASIC_AUTH_PASS', 'secret');

include/config.php, buttons/ and command_logs/ are not tracked by git — your credentials, buttons and logs are preserved across upgrades automatically.

cd /var/www/html/GumCP
sudo git pull origin master

Or use the Update GumCP button on the Actions page — no terminal needed.

GumCP supports three modes, configurable independently:

// Login page
define('LOGIN_REQUIRED', true);
define('LOGIN_USER', 'admin');
define('LOGIN_PASS', 'changeme');

// HTTP Basic Auth (separate credentials — useful for API/curl access)
define('BASIC_AUTH', true);
define('BASIC_AUTH_USER', 'api');
define('BASIC_AUTH_PASS', 'secret');

Create one-click buttons for any shell command from the Buttons page.

Toggle between modes with the Direct execution checkbox when creating or editing a button.

Enabled by default. Disable in config.php like any other module:

$gumcp_modules['button_api']['module_active'] = 0;

Every button gets a unique secret hash. Use it to trigger the button from any HTTP client without logging in — no session or Basic Auth required:

curl http://<your-pi-ip>/GumCP/api.php?hash=<32-char-hash>

Response:

{"success": true, "button": "Restart Apache", "output": ""}

The API URL is shown in the button's Edit dialog. Use Regenerate hash to invalidate an old URL and get a new one instantly.

Every API call is logged to command_logs/api_calls.log (JSON lines) with timestamp, IP, user-agent, and command output. Log files are not accessible via the browser.

Example: trigger from Home Assistant

rest_command:
  restart_apache:
    url: "http://192.168.1.10/GumCP/api.php?hash=a3f8c2d1e4b79056..."
    method: GET

GumCP includes a built-in diagnostic tool. Open it in your browser:

http://<your-pi-ip>/GumCP/check.php

Or run the CLI version on the Pi:

# Check only
bash /var/www/html/GumCP/check.sh

# Check and auto-fix permissions/missing directories
sudo bash /var/www/html/GumCP/check.sh --fix

The check covers PHP extensions, directory writability, SSH connectivity, GPIO tools and required system commands. Each failing item shows a Fix button that applies the repair over SSH without needing a terminal.

These pages require the php-ssh2 extension and a running SSH server:

sudo apt-get install -y php-ssh2
sudo systemctl enable ssh && sudo systemctl start ssh
sudo systemctl restart apache2

The buttons/ directory is missing or not owned by www-data:

sudo mkdir -p /var/www/html/GumCP/buttons
sudo chown www-data:www-data /var/www/html/GumCP/buttons

Or use the System Check page's Fix button.

• Pi 1–4: Install WiringPi (see above) and verify with gpio readall
• Pi 5: Install raspi-gpio: sudo apt-get install -y raspi-gpio and verify with raspi-gpio get

Apache strips the Authorization header by default. The included .htaccess passes it through via RewriteRule. Make sure mod_rewrite is enabled:

sudo a2enmod rewrite
sudo systemctl restart apache2

TeHyBug is a low-power temperature/humidity/pressure Wi-Fi tracker available at Tindie.

Enable it in config.php (module_active => 1). Requires SQLite:

sudo apt-get install -y php-sqlite3

• Change default credentials in include/config.php before putting GumCP on any network
• Enable LOGIN_REQUIRED and/or BASIC_AUTH in config.php for protected access
• Button API is enabled by default — set $gumcp_modules['button_api']['module_active'] = 0 in config.php to disable it
• Button API hashes are secret URLs — treat them like passwords; use Regenerate hash if a hash is compromised
• command_logs/ and buttons/ are blocked from direct web access via .htaccess
• GumCP executes commands as the SSH user — use a dedicated user with only the permissions it needs
• robots.txt is included and blocks all search crawlers from indexing GumCP