-
Notifications
You must be signed in to change notification settings - Fork 0
Logs, Errors, and Bugs
This page explains how logging works in Hyprland-Rice, how to interpret common messages, and how to report issues properly.
Not every warning or error message indicates a problem. This page will help you understand the difference.
Hyprland-Rice creates log files during installation to help with debugging and issue reporting.
Logs are typically stored in:
logs/
Each installation run generates a new log file. Older logs are not overwritten.
Log files may include:
- Detected Linux distribution
- Package installation attempts
- Skipped or unavailable packages
- Installer decisions and user choices
Logs do not contain personal data.
Messages indicating a package was skipped are normal.
This usually means:
- The package is already installed
- The package is not available on your distribution
- The package name differs between distros
Skipped packages do not indicate failure.
A “package not found” message means the package does not exist in your distribution’s repositories.
This is expected behavior for optional packages and does not stop the installer.
If you see permission-related errors:
- Ensure you are running the installer from a normal user account
- Ensure your user has sudo access
Do not run the installer as the root user.
A bug is an issue where:
- The installer behaves incorrectly
- A confirmed supported distribution fails unexpectedly
- Configs are copied incorrectly despite confirmation
Warnings, skipped packages, or missing optional tools are not bugs.
Before opening an issue, please:
- Read the relevant Wiki pages
- Check your log file
- Confirm your distribution is supported
Many issues can be resolved without opening a report.
If you believe you have found a bug, include the following:
- Your Linux distribution and version
- The log file from the failed installation
- A clear description of what went wrong
- What you expected to happen
Attach logs as files or paste relevant sections only.
Hyprland-Rice does not provide support for:
- Running the installer on unsupported distributions
- Manually modified installer scripts
- Heavily customized systems without logs
This helps keep support manageable and effective.