Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/blackh8t/hmm

A terminal-first helper toolkit for Linux web servers running NGINX, Apache, Certbot, PHP, and common service/process diagnostics.
https://github.com/blackh8t/hmm

apache certbot cli-tools hosts linux nginx open-ports php ports ssl supertool vhost

Last synced: 23 days ago
JSON representation

A terminal-first helper toolkit for Linux web servers running NGINX, Apache, Certbot, PHP, and common service/process diagnostics.

Awesome Lists containing this project

README 

          
# hmm — VHost + SSL + Port Toolkit



A terminal-first helper toolkit for Linux web servers running NGINX, Apache, Certbot, PHP, and common service/process diagnostics.



This fork/continuation adds a cleaner single-key interface, improved terminal visuals, process-aware port inspection, simplified log viewing, wildcard SSL helpers, and a basic user process manager.



![HMM UI Screenshot](https://raw.githubusercontent.com/Blackh8t/hmm/main/hmm-ui.png)

---



## Credit / Attribution



Original project credit goes to:



**Blackh8t**  

https://github.com/Blackh8t/hmm



Credit where it is due.



The attribution notice in the script must not be removed from copies, forks, redistributed versions, installer scripts, modified builds, or derivative works.



---



## Features



### Single-Key Menu



- Select tools with one key.

- No Enter required for main menu selections.

- Clears the screen between tools so each result is readable.

- Returns to the menu after each action.



### Improved Terminal UI



- Bold menu options.

- Bold feature names.

- Green bold prompt line at the bottom.

- Clear visual separation between sections.

- Status, success, warning, and error messages use distinct colours.



### SSL / Certbot Tools



- Rebuild wildcard SSL certificates.

- Supports manual DNS challenge.

- Supports Cloudflare DNS plugin.

- Supports DigitalOcean DNS plugin.

- Supports AWS Route53 DNS plugin.

- Repair existing Certbot certificates from discovered NGINX vhosts.

- Reloads NGINX and Apache where available.



### Port Inspection



#### Port Stalker



Shows listening TCP/UDP services with:



- Protocol

- Port

- Local bind address

- PID

- Process name



#### Port Sniffer



Shows externally-bound services with:



- Protocol

- Port

- External exposure status

- PID

- Process name

- Local bind address



This helps quickly identify whether services are listening locally only or exposed on `0.0.0.0`, `[::]`, `*`, or the public IP.



### User Process Manager



A simplified process list for the current user.



- Shows top user-owned processes.

- Single-letter selection.

- Sends `TERM` first.

- Offers `KILL` if the process remains alive.

- Avoids forcing destructive action by default.



### Domain Scanner



Scans NGINX vhost files from:



- `/etc/nginx/sites-enabled`

- `/etc/nginx/sites-available`



Filters out common placeholders like `_`, `localhost`, and wildcards.



### PHP Option Checker



- Scans PHP files under `/var/www` by default.

- Lists detected `require`, `require_once`, `include`, and `include_once` references.

- Lists currently loaded PHP CLI modules when PHP is installed.



### Log Viewer



- Finds common NGINX, Apache, and system log files.

- Lets you choose a log from a numbered list.

- Remembers the last opened log.

- Lets you choose how many lines to display.



### Debug Terminal



Opens a child shell with helper aliases:



```bash

ports

nginx-test

nginx-reload

apache-test

certs

logs-nginx

```



Type `exit` to return to `hmm`.



### System Health Snapshot



Displays a quick system overview:



- Hostname

- Uptime

- Current user

- Disk usage

- Memory usage

- NGINX / Apache / Certbot service status where available



---



## Install



Clone or copy the script, then make it executable:



```bash

chmod +x hmm_fixed.sh

./hmm_fixed.sh

```



To install globally from inside the tool, select:



```text

i

```



Or manually install:



```bash

sudo cp hmm_fixed.sh /usr/local/bin/hmm

sudo chmod +x /usr/local/bin/hmm

hmm

```



---



## Configuration



The tool stores lightweight user settings at:



```bash

~/.hmmrc

```



Currently stored values:



```bash

CERT_EMAIL="admin@example.com"

LAST_LOG_FILE="/var/log/nginx/error.log"

```



The config reader only loads known keys and does not execute arbitrary shell code from the config file.



---



## Environment Overrides



You can override default paths with environment variables:



```bash

HMM_CONFIG_FILE="$HOME/.custom-hmmrc"

HMM_SITES_ENABLED="/etc/nginx/sites-enabled"

HMM_SITES_AVAILABLE="/etc/nginx/sites-available"

HMM_WEBROOT="/var/www"

```



Example:



```bash

HMM_WEBROOT="/srv/www" ./hmm_fixed.sh

```



---



## Requirements



Recommended packages:



```bash

sudo apt update

sudo apt install -y iproute2 certbot curl procps coreutils findutils

```



Optional packages depending on use:



```bash

sudo apt install -y nginx apache2 php-cli python3-certbot-nginx python3-certbot-apache

```



For DNS wildcard SSL modes, install the relevant Certbot plugin:



```bash

sudo apt install -y python3-certbot-dns-cloudflare

sudo apt install -y python3-certbot-dns-digitalocean

sudo apt install -y python3-certbot-dns-route53

```



Package names may vary by distro.



---



## Safety Notes



This tool is designed for server administration. Some actions can affect live services.



Use care with:



- Certificate rebuilds

- Web server reloads

- Process termination

- Running with sudo/root privileges



The process manager sends `TERM` first and only offers `KILL` after the process remains active.



---



## Suggested Git Commit Message



```text

Improve hmm UI, SSL tooling, port/process inspection, and attribution



- Add single-key menu flow with clean screen transitions

- Add bold menu choices and green bold prompt styling

- Add process names and PIDs to port inspection tools

- Add simplified user process list with safe kill workflow

- Add wildcard SSL rebuild helper with DNS challenge modes

- Add Certbot repair wizard from discovered NGINX vhosts

- Add log viewer, debug shell, and system health snapshot

- Harden config loading by avoiding arbitrary source execution

- Add mandatory attribution to Blackh8t original hmm project

```



---



## License / Attribution Notice



This continuation keeps visible attribution to the original project:



**Blackh8t / hmm**  

https://github.com/Blackh8t/hmm

admin@securenode.io



Do not remove the attribution block from the script or redistributed copies.