License codecov Release status PyPI version

Table of contents


Risu is a framework to help with system configuration validation on either live system or a sosreport snapshot of the filesystem. This empowers the user to quickly troubleshoot known issues found in the system or the ones arising from different settings across a group of systems.

Via execution of 'plugins' it reports status on each one execution against the system that gives you an idea on health status, actual problems or problems that will reveal themselves if no preventive action is taken.

Please if you have any idea on any improvements please do not hesitate to open an issue.


  • Plugins written in your language of choice.
  • Allows to dump output to json file to be processed by other tools.
  • Allow to visualize html from json output.
  • Check our sample at: Risu-www
  • Ansible playbook support.
  • Save / restore default settings

Framework contains additional readmes for the tools included:


Check README above for detailed instructions outside os simple ones:

  • Just clone the git repository and execute it from there 'or'
  • use 'pipsi' or create a python virtual env to install package 'risu'

  • Give it a try running as 'root' on your system with: ./ -l so it will show live execution and only Failed tests.

How does it looks like?

Check how does it look in an execution at: asciicast

HTML Interface

Additional resources



Documentation is available at Read the docs

Contact us!!

You can reach to us via: