Ted - 2025-02-27

I have chased this down. In new versions of Ubuntu (at least 2.4.0 and up) Firefox is installed as a Snap with permissions that prohibit rendering local html files. Unfortunately Firefox does not drop an exit code, it just displays an error message.
There is some discussion about fixing this. I don't know if this will happen.

A workaround is to uninstall Firefox Snap and reinstall from .deb.

Another possibility would be to convert the file to an .md file and okular will open it
Okular is very likely to be installed if gscan2pdf is installed.

The problem seems not to exist for brave-browser, but that is not part of the normal Ubuntu install.

A way to adjust this for users would be to put the local file location in the .config/gscan2pdfrc file and a commented out copy that points to the documentation on your website which firefox is happy to display.