zowe-cli icon indicating copy to clipboard operation
zowe-cli copied to clipboard

Web help does not open browser installed via snap

Open adam-wolfe opened this issue 10 months ago • 4 comments

Describe the bug

Chrome and Firefox are provided via snap by default in recent Ubuntu releases. Since the webhelp, by default, exists in a hidden folder (~/.zowe), users running Ubuntu or Ubuntu derivatives will not be able to open web help without reconfiguring their environment to use a non-snap-installed browser.

If I run a command and include the --help-web flag, the web help html files are generated, but a browser is not opened.

Expected and actual results

  1. Run zowe --hw
  2. Observe that the web help files are generated and "Launching web help in browser..." is printed to the terminal.
  3. A web browser is not opened.
  4. The command exits.

Describe your environment

  • Zowe CLI version installed (run command zowe --version): 8.23.1
  • Node.js and NPM versions installed (run node --version, npm --version): node 20.18.3
  • Operating system and version: Ubuntu 22.04
  • Shell/terminal (bash, cmd, powershell, etc...): bash
  • Daemon mode enabled or disabled: disabled

Additional context

I also tried Zowe CLI 8.3.0 and 7.29.14, which also failed to open a web browser.

adam-wolfe avatar Jun 17 '25 13:06 adam-wolfe

Thank you for creating a bug report. We will investigate the bug and evaluate its impact on the product. If you haven't already, please ensure you have provided steps to reproduce the bug and as much context as possible.

github-actions[bot] avatar Jun 17 '25 13:06 github-actions[bot]

This is caused by Firefox installed via snap (which is the default on Ubuntu 22.04). With this configuration, Firefox is unable to access html files in hidden directories.

It is a known bug captured here: https://bugs.launchpad.net/snapd/+bug/1972762

adam-wolfe avatar Jun 18 '25 16:06 adam-wolfe

The resolution in this case is to install a web browser without using the snap package manager.

adam-wolfe avatar Jun 18 '25 16:06 adam-wolfe

Reopened to consider options to work around snap limitations.

adam-wolfe avatar Jul 07 '25 15:07 adam-wolfe