https://github.com/risuorg/risu
Automation Troubleshooting Framework to validate and report configuration, software installed, etc with bash, python, and your language of choice.
https://github.com/risuorg/risu
automation bash compliance devops hacktoberfest hardening linux proactive python security-audit shell support troubleshooting
Last synced: 8 months ago
JSON representation
Automation Troubleshooting Framework to validate and report configuration, software installed, etc with bash, python, and your language of choice.
- Host: GitHub
- URL: https://github.com/risuorg/risu
- Owner: risuorg
- License: gpl-3.0
- Created: 2017-06-11T07:08:51.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-05-16T13:19:17.000Z (8 months ago)
- Last Synced: 2025-05-16T14:33:57.723Z (8 months ago)
- Topics: automation, bash, compliance, devops, hacktoberfest, hardening, linux, proactive, python, security-audit, shell, support, troubleshooting
- Language: Shell
- Homepage: https://risuorg.github.io
- Size: 12 MB
- Stars: 107
- Watchers: 10
- Forks: 35
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
---
modified: "2022-01-26T13:04:03.311Z"
---
[](LICENSE)
[](https://readthedocs.org/projects/risu/builds/ "Read The docs build")
[](https://img.shields.io/docker/pulls/risuorg/risu.svg)
[](https://codecov.io/gh/risuorg/risu)
[](https://github.com/risuorg/risu/releases)
[](https://badge.fury.io/py/risu)
**Table of contents**
- [Introduction](#introduction)
- [Highlights](#highlights)
- [How does it looks like?](#how-does-it-looks-like)
- [Collaborate](#collaborate)
- [Documentation](#documentation)
- [Contact us!!](#contact-us)
## Introduction
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.
## Highlights
- 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](http://htmlpreview.github.io/?https://github.com/risuorg/risu/blob/master/doc/sampleweb/risu.html)
- Ansible playbook support.
- Save / restore default settings
Framework contains additional README for the tools included:
- [Risu](doc/risu.md)
- [Magui](doc/magui.md)
## How does it looks like?
Check how does it look in an execution at:
[](https://asciinema.org/a/169814)
## Collaborate
- Open issues/feature requests, etc at
- Read the [Contributing](https://risu.readthedocs.org/en/latest/development/CONTRIBUTING/) document on how to submit patches
- Provide the sosreports to check against via , specially if running Debian based distributions and or Fedora/CentOS based ones so that we can improve support for it
## Documentation
Documentation is available at [Read the docs](https://risu.readthedocs.org)
## Contact us!!
You can reach to us via:
- irc at #risu in [Libera](https://libera.chat/)
- our mailing list:
-
-