Report a Bug

Found something broken? Please report it. Bug reports are how a small project like this gets better, and every one is read by the same person who built the distro.

Before Reporting

A few quick checks first:

Is it specific to Spritz Linux? If the same bug exists in stock Linux Mint 23.2, report it to the Linux Mint forums or Linux Mint on GitHub instead. Spritz Linux doesn’t change the base system — only the packages listed on the home page.
Is it caused by a removal? If software stopped working after you installed Spritz Linux, check the list of removed packages. If a removed package was a dependency, that’s a Spritz Linux bug and should be reported here.
Is it a Brave settings issue? Brave Shields occasionally break specific sites. That’s expected — report it here so the offending setting can be documented.

How to Report

Email your bug report to jason [at] spritzlive [dot] net with the subject line Spritz Linux Bug: [short description].

Tip: The more specific your report, the faster it gets fixed. A subject line of “Spritz Linux Bug: Steam won’t launch after fresh install” is much more useful than “something is broken.”

What to Include

A useful bug report has:

What you were trying to do — in plain language, not jargon
What you expected to happen
What actually happened — exact error message if there is one
Steps to reproduce — numbered steps so the bug can be confirmed
Spritz Linux version — visible in the Welcome Screen or via cat /etc/os-release
Relevant logs — if applicable (see below)

Getting Logs

If the bug involves a crash or error, these commands collect the most useful information:

System journal (last 100 lines):

journalctl -n 100 --no-pager

Specific service log (e.g., UFW):

journalctl -u ufw -n 50 --no-pager

OS version info:

cat /etc/os-release && uname -r

Installed package version:

dpkg -l | grep <package-name>

Brave-Specific Bugs

If a website breaks in Brave and you suspect Shields is the cause, click the Brave Shields icon in the address bar and toggle Shields off for that site. If it works with Shields down, the issue is a setting conflict.

In your report, include the site URL, what breaks (images not loading, login fails, etc.), and whether disabling Shields made a difference. This narrows it down to the specific setting.

Known Issues

No known issues at this time. This section will be updated as reports come in.

Spritz Linux bugs only — for Linux Mint bugs, use the Linux Mint forums or Linux Mint GitHub.