Skip to content

Update Stratum V2 UI to v0.6.0 - #5933

Merged
nmfretz merged 2 commits into
getumbrel:masterfrom
GitGab19:update-sv2-ui
Jul 30, 2026
Merged

Update Stratum V2 UI to v0.6.0#5933
nmfretz merged 2 commits into
getumbrel:masterfrom
GitGab19:update-sv2-ui

Conversation

@GitGab19

Copy link
Copy Markdown
Contributor

Type

App update

App

App ID: sv2-ui
Upstream project: https://github.com/stratum-mining/sv2-ui
Version: 0.6.0

Summary

In sv2-ui v0.6.0 we added NexusPool and CK Pool (solo mining), simplified node setup, unified pool configuration flows, and a streamlined dashboard with per-worker best difficulty and more accurate hashrate reporting based on new miner telemetry data. Now coinbase verification and minimum individual worker hashrate can be configured from the UI, custom pools in Job Declaration mode can specify a JDS port, and logs feature smart color coding for easier reading. More details in the release notes at https://github.com/stratum-mining/sv2-ui/releases/tag/v0.6.0.

Verification

Umbrel testing performed:
Tested on my Umbrel VM and everything works properly.

Environment tested:

  • Umbrel device
  • Local umbrelOS test environment
  • Not runtime tested

Architecture tested:

  • amd64
  • arm64

@lucasbalieiro lucasbalieiro left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

confirmed that the sha256:05cb175c3bb470f9c356410aaadbe5a4e7b606d511cee30647350ffd300d65d4

is from known multi-arch image.

Image

I've sent this update to my Umbrel and checked that it is working. Including the ASIC telemetry

@nmfretz

nmfretz commented Jul 29, 2026

Copy link
Copy Markdown
Member

Hey @GitGab19 and @lucasbalieiro, thanks for this! I hit a snag when updating an app (fresh install works fine) that we need to fix before going live.

It’s a fairly narrow case and easy to miss with a fresh setup.

The outer app updated correctly, but the mining services would not remain running. The nested sv2-jdc v0.7.0 container exits immediately because the existing jdc.toml is missing the required version field under [template_provider_type.BitcoinCoreIpc]:

Job Declarator Client config error: missing field `version`

The Translator starts afterward, but because JDC has already exited, it cannot resolve sv2-jdc and also shuts down.

Codex helped me confirm that this configuration was generated by sv2-ui rather than edited manually. The same legacy format was shipped with the earlier Umbrel 0.1.0 and 0.4.0 packages. The v0.5.0 generator includes the new field, but app updates do not regenerate persisted TOML files, so users carrying an older JD configuration forward can still hit this when v0.6.0 upgrades the nested JDC image to v0.7.0.

Can you guys look into this and see if you can add an update-safe migration that patches or regenerates legacy JD configs before auto-starting the mining services? That way, existing users don’t end up with a broken mining setup after updating.


I also pushed a small release notes change to make them easier to scan:wording-only follow-up to make the release notes easier to scan:

image

@nmfretz nmfretz added the awaiting changes Waiting for contributor to make requested changes label Jul 29, 2026
@GitGab19

Copy link
Copy Markdown
Contributor Author

Hey @nmfretz, thanks for reporting the issue you faced, and for adjusting release notes.

We just merged stratum-mining/sv2-ui#234 which introduced safe mechanisms for updates, and overwritten the 0.6.0 release.

I just updated the PR here with the new digest.

@nmfretz

nmfretz commented Jul 30, 2026

Copy link
Copy Markdown
Member

Awesome, thanks for fixing so quickly @GitGab19! I retested the update on the same Umbrel with the legacy JD configuration that originally failed. Totally resolved. We’re good to go 🚀

@nmfretz
nmfretz merged commit 6066973 into getumbrel:master Jul 30, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting changes Waiting for contributor to make requested changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants