Skip to content

Skip first-run onboarding wizard in gateway mode#48

Merged
cori merged 1 commit into
mainfrom
claude/hermes-webui-skip-onboarding
Jun 12, 2026
Merged

Skip first-run onboarding wizard in gateway mode#48
cori merged 1 commit into
mainfrom
claude/hermes-webui-skip-onboarding

Conversation

@cori

@cori cori commented Jun 12, 2026

Copy link
Copy Markdown
Owner

Summary

  • Sets HERMES_WEBUI_SKIP_ONBOARDING=1 in the container environment
  • When connecting to an existing Hermes gateway the provider/API config already lives on the gateway — the first-run wizard is redundant and confusing

Why

On fresh install the WebUI presents a wizard to configure a local gateway and upstream provider. Since this app definition always runs in gateway mode (HERMES_WEBUI_CHAT_BACKEND=gateway) against a user-supplied HERMES_WEBUI_GATEWAY_BASE_URL, the wizard should never appear.

Test plan

  • bun test passes (54 tests, verified locally)
  • Fresh install no longer shows the onboarding wizard on first login

https://claude.ai/code/session_01Xwf5nZf6d1npMerNteodq2


Generated by Claude Code

Set HERMES_WEBUI_SKIP_ONBOARDING=1 so the provider-setup wizard
doesn't appear on first login. When connecting to an existing gateway
the provider is already configured there; the wizard is redundant.

https://claude.ai/code/session_01Xwf5nZf6d1npMerNteodq2
@cori cori marked this pull request as ready for review June 12, 2026 04:11
@cori cori requested a review from Copilot June 12, 2026 04:11

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Hermes WebUI app definition so that the first-run onboarding wizard is skipped when the app is deployed in gateway mode, avoiding redundant setup steps when the gateway already contains the provider/API configuration.

Changes:

  • Adds HERMES_WEBUI_SKIP_ONBOARDING=1 to the Hermes WebUI container environment.
  • Increments the app’s tipi_version and updates the updated_at timestamp to reflect the definition change.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
apps/hermes-webui/docker-compose.json Adds the HERMES_WEBUI_SKIP_ONBOARDING env var to suppress the onboarding wizard in gateway deployments.
apps/hermes-webui/config.json Bumps tipi_version and refreshes updated_at to reflect the app definition update.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@cori cori merged commit 4fd9b3a into main Jun 12, 2026
3 checks passed
@cori cori deleted the claude/hermes-webui-skip-onboarding branch June 12, 2026 04:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants