Skip to content

TigerComputing/PawPrint-System-Profiler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

PawPrint-System-Profiler

A first step to understanding your system’s health

Before we begin supporting your systems, we like to get a clear picture of how everything is set up and performing. PawPrint is a lightweight system profiling tool that helps us do that.

It gathers key information about your Linux environment so we can:

  • Understand the overall health of your systems
  • Spot potential risks or misconfigurations early
  • Identify anything that might impact support or performance
  • Ensure a smooth and informed onboarding process

If you have any questions or would prefer us to assist, just reach out at support@tiger-computing.co.uk


📦 Overview

PawPrint is a compact Bash-based tool designed to collect essential Linux system information.


🚀 Usage

Run as root:

sudo ./pawprint.sh [--debug | --full]

Options

  • --full → Detailed, verbose output
  • --debug → Same as full, but includes function names per line for troubleshooting

PawPrint will exit if not run on Linux or without root privileges.


⚙️ Requirements

Core

  • Bash

  • Standard Linux utilities:

    • dmidecode, free, uptime, df, ip, ping, ss

Optional (enhanced checks)

  • ethtool
  • ipmitool
  • subscription-manager / ua
  • Container tools: docker, podman, lxc

🔍 What PawPrint Checks

🖥️ System Information

  • Hostname and OS (including EOL status)
  • Virtual vs bare metal detection
  • BIOS and hardware details
  • CPU, memory, and swap usage
  • Time configuration and sync status
  • Uptime and system load
  • Disk layout (including RAID, ZFS, Btrfs, network mounts)

🌐 Networking

  • Interface configuration, speed, and error rates
  • Connectivity checks (ping latency)
  • /etc/hosts configuration review

📦 Software & Platform

  • Hosting panels (e.g. Plesk, cPanel)
  • Hypervisors (Proxmox, TrueNAS, QEMU, VirtualBox)
  • Available updates
  • Containers (Docker, Podman, LXC)

🔐 Security

  • Firewall status (ufw, iptables)
  • SSH root login configuration
  • Sudo access for non-root users
  • Ransomware indicator scan (common file extensions)

🧪 Sanity Checks

  • Open ports overview
  • Root mail alias configuration
  • Running and failed services

🎨 Output Format

Results are colour-coded for clarity:

  • 🟢 Green → OK / Pass
  • 🟡 Yellow → Warning / Needs attention
  • 🔴 Red → Alert / Issue detected
  • 🔵 Blue → Informational

📋 Summary Output (Planned)

Future output improvements will include a concise, copy-paste summary:

Info:        Key system snapshot (fastfetch-style)
Problems:    Critical issues identified
Warnings:    Items needing review
Recommendations: Suggested actions (e.g. updates, OS lifecycle)

Additional guidance may include:

  • External port scan command
  • Suggested reboot validation steps

⚠️ Disclaimer

PawPrint has been thoroughly tested across a wide range of environments and is designed to be safe and non-intrusive. However as with any publicly avalible script we reccomend you read it. Running it is at your own risk.

If you have any questions or concerns before running it, please get in touch at support@tiger-computing.co.uk

About

A first step to understanding your system’s health

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages