DHIVA LABS · LEARN

Appearance

Install ​

SysVitals is one Python file, sysvitals.py. Installing it means downloading that file and making it runnable. There is nothing to compile and no libraries to install.

What you need ​

  • Linux on x86-64 or ARM64
  • Python 3.8 or newer. Check with python3 --version. Most distributions include it.
  • Optional: smartmontools, for health data from SATA drives. NVMe drives do not need it.

Download the script ​

  1. Download version 1.0.0 of the script:

    bash
    curl -LO https://raw.githubusercontent.com/Dhiva-Labs/SysVitals/v1.0.0/sysvitals.py

  2. Make it executable:

    bash
    chmod +x sysvitals.py

  3. Check that it runs:

    bash
    ./sysvitals.py --version

    It prints sysvitals 1.0.0.

You can now run it from that folder as ./sysvitals.py.

Optional: run it from anywhere ​

Copy it to a folder on your PATH under the name sysvitals:

bash
sudo install -m 755 sysvitals.py /usr/local/bin/sysvitals

Then type sysvitals (or sudo sysvitals) in any folder. The rest of this documentation uses ./sysvitals.py; replace it with sysvitals if you did this.

Clone the repository instead ​

If you prefer Git:

bash
git clone https://github.com/Dhiva-Labs/SysVitals.git
cd SysVitals
git checkout v1.0.0
./sysvitals.py

Install SATA health support ​

SysVitals reads SATA drive health through smartctl, from the smartmontools package. On Debian or Ubuntu:

bash
sudo apt install smartmontools

On Fedora, use sudo dnf install smartmontools; on Arch, sudo pacman -S smartmontools.

Distribution packages ​

The project builds packages for Fedora and RHEL-family systems, openSUSE and Arch Linux, which install the command as sysvitals. They are attached only to releases made after v1.0.0, so v1.0.0 has none. When a release lists them on its releases page, install the file with your package manager, for example:

bash
sudo dnf install ./sysvitals-<version>-1.noarch.rpm

On Arch, use sudo pacman -U ./sysvitals-<version>-1-any.pkg.tar.zst. For help with package files, see Installing apps.

Update or remove ​

To update, download the newer sysvitals.py the same way and replace the old file. To remove SysVitals, delete the file (and /usr/local/bin/sysvitals if you copied it there). It stores no settings anywhere.

Next steps ​