Skip to content

Issue #7940 : Add a configurator for Hop environment variables - #7942

Merged
hansva merged 2 commits into
apache:mainfrom
mattcasters:issue-7940
Aug 15, 2026
Merged

Issue #7940 : Add a configurator for Hop environment variables#7942
hansva merged 2 commits into
apache:mainfrom
mattcasters:issue-7940

Conversation

@mattcasters

Copy link
Copy Markdown
Contributor

What

Adds a bundled hop-misc-setup plugin so new Hop users can move configuration out of the install tree.

  • GUI: Tools → Configure Hop environment… (Variables + Location tabs), Welcome topic, first-start prompt
  • CLI: hop setup / hop setup show / hop setup apply
  • Writes HOP_CONFIG_FOLDER, HOP_AUDIT_FOLDER, HOP_JAVA_HOME, HOP_OPTIONS, and HOP_SHARED_JDBC_FOLDERS to:
    • Windows user environment (PowerShell, not setx)
    • bash/zsh rc file (idempotent marked block)
    • well-known hop-env.sh / hop-env.cmd
  • Launchers source that hop-env file so desktop restarts pick up the folders
  • Optional copy of <install>/config when the new config folder is empty
  • Hop Web only previews a script (does not write the server OS environment)

Recommended folders: ~/.local/share/hop + ~/.local/state/hop (Linux/macOS, honors XDG), %USERPROFILE%\.hop\config + audit (Windows). Existing defaults stay ./config and ./audit. Install fallbacks in Const are unchanged.

Why

#7940

Without these variables Hop stores config and audit next to the install, which is lost on upgrade. The same friction showed up when documenting first-run setup (#7931).

How to test

  1. From a Hop install: ./hop setup apply --defaults --dry-run
  2. In Hop Gui: Tools → Configure Hop environment… — Variables tab, Location tab, Preview, Apply
  3. Restart Hop and confirm HOP_CONFIG_FOLDER is used (About dialog / config path)
  4. Confirm launchers source ~/.config/hop/hop-env.sh (or %USERPROFILE%\.hop\hop-env.cmd)

Fixes #7940

Add a bundled hop-misc-setup plugin with hop setup (CLI) and Tools →
Configure Hop environment (GUI) so users can move HOP_CONFIG_FOLDER,
HOP_AUDIT_FOLDER, HOP_JAVA_HOME, HOP_OPTIONS and HOP_SHARED_JDBC_FOLDERS
out of the install tree. Launchers source a well-known hop-env script.
Add a Projects tab so a new HOP_CONFIG_FOLDER is not empty after restart:
create a user-owned default project and register the install samples
project in the new hop-config.json.
@hansva
hansva merged commit a7b8ace into apache:main Aug 15, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature Request]: Configurator for your Hop configuration

2 participants