THIS TOOL IS FOR INTERNAL NETWORK AUDITS ONLY.
- PROHIBITED ENVIRONMENTS: Do not run this software on production servers, live business-critical infrastructure, or any host accessible via the public internet.
- RISK OF INSTABILITY: These checks may cause system instability, service interruptions, or unexpected reboots on unhardened systems.
- SECURITY POSTURE: This tool is not designed to withstand attacks from the open internet. Deploying it on a public-facing host may introduce new vulnerabilities to your network.
BY USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT YOU ARE DOING SO IN A CONTROLLED, NON-PRODUCTION ENVIRONMENT.
Mojoeye is a Linux and perl based application, for writing your own Linux security and system-health checks (in perl), and for monitoring their results.
Mojoeye currently currently supports Debian and Fedora distributions.
See:
See:
This is the overall depiction of a mojoeye implementation.
There is a mojoeye server host, with one or more mojoeye client host(s).
Note that the server host, also contains a client for running local checks and for debugging.
/etc/mojoeye - configuration files
/usr/local/lib/mojoeye - example checks
/opt/mojoeye - docs, application files, and required perl modules
/var/lib/mojoeye - check results and logs
.,................................................................
' '
' L I N U X '
' '
' Debian and Fedora based '
' '
' '
' .----------------. ' .-------------.
' | | ' | |
' | mojoeye server | <----------HTTP/S------------'-- | web browser |
' | | ' | |
' /'----------------'\ ' '-------------'
' / ^ ' '
' systemd or | |--- /etc/mojoeye '
' manual with | | '
' run_server | |--- /usr/local/lib/mojoeye '
' | | '
' | |--- /opt/mojoeye '
' HTTP/S | '
' | '--- /var/lib/mojoeye '
' non-login user | '
' mojoeye:mojoeye | '
' | '
' | '
' | '
' .----------------. '
' | |-. '
' | mojoeye client | | '
' | | | '
' /'----------------' | '
' / '-----------------'\ '
' CRONTAB or ' '
' manual with |--- /etc/mojoeye '
' run_client | '
' |--- /usr/local/lib/mojoeye '
' | '
' |--- /opt/mojoeye '
' | '
' '--- /var/lib/mojoeye '
' '
'..................................................................'
Mojoeye is designed to be as far-as-possible, easy to modify and extend.
Building on the Mojolicious::Lite framework:
- The server is a single perl file,
- The client is a single perl file,
- The installation is done by a single bash script,
- Each check is written as a single perl script.
Some example checks are supplied during installation:
- /usr/local/lib/mojoeye
See the file README.md in this directory.
Questions and general discussion are welcome via GitHub Discussions.
Please read CONTRIBUTING.md before opening issues or pull requests.