Skip to content
Anonymous reporting tool for Liguros Linux
Perl Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Liguros-Report - v3.2.2 CI build test badge

Anonymous reporting tool for Liguros Linux


emerge -av Liguros-Report


The reporting tool is intended to run with root privileges for access to key system files. Use the method most appropriate on your system

Just launching the program will show you a help menu:


Liguros anonymous data reporting tool usage:

              -c, --config        Specify path to config file
              -u, --update-config Interactively updates the config file
              -l, --list-config   Lists the current configuration file's settings
              -j, --show-json     Shows the JSON report
              -s, --send          Sends the JSON report
              -d, --debug         Enables additional debug output
              -v, --verbose       Enables non-error output when sending
              -h, --help          Display this help text
              -V, --version       Prints the version and exits

Output can be omitted by modifying the config file (default `/etc/liguros-report.conf`):

The --help option shows you the same output:

'liguros-report --help'

The --version option shows you the script and module version numbers; ideally they should match:

'liguros-report --version'

To see what data the report is generating use the show-json option:

'liguros-report --show-json'

You may get an error that no config file is found:

Could not open the configuration file at /etc/liguros-report.conf
To generate a new configuration file use 'liguros-report --update-config'

You can follow these warning instructions and the program will ask you which sections you want to enable in your config file

'liguros-report --update-config'

You can send your report to the Elasticsearch database using the send option which can return a link to the data if successful in conjunction with --verbose:

'liguros-report --send [--verbose]'

your report can be seen at:

You can get HTTP debugging output for the send command with the --debug or -d option:

'liguros-report --debug --send'

Manual Configuration:

The reporting tool is completely anonymous and the individual categories that are in the report can be turned off or on by editing the config file. The config file is located at /etc/liguros-report.conf by default, and will be autogenerated by the script if one is not present. All lines of the config file that are empty or start with # are ignored. The rest are read but may be ignored if they do not match any expected setting. You can manually change the settings from 'y' to 'n' to disable a particular category. Using the show-json option, you can confirm that this portion of the report is not being output, since the show-json option actually shows exactly what is reported to Elasticsearch.

Here is an example of all possible values in the config file

# To report kernel info including O.S. type, release and version

# Allows the reporter to search your /boot directory and list
# any kernels it finds
# (limited to kernel names that start with "kernel" or "vmlinuz")

# To report versions of key softwares on your system including
# portage, ego, python, gcc, and glibc

# To report the contents of /var/lib/portage/world

# To report profiles information
# the same as epro show-json

# To report kit versions as reported by ego
# extracted from ego kit show

# To report all installed packages

# To report hardware info as is typical from lspci

Shell completions

Options completion for GNU bash is available in share/bash-completion/liguros-report.bash:

bash$ source share/bash-completion/liguros-report.bash

Options completion for zsh is available in share/zsh-completion/_liguros-report.


We are sorry to see you go!

You can uninstall the tool by running:

emerge -C Liguros-Report
You can’t perform that action at this time.