Skip to content

Add UGREEN NAS platform preset#17

Open
decriptor wants to merge 1 commit intomainfrom
shaw/add-ugreen-platform
Open

Add UGREEN NAS platform preset#17
decriptor wants to merge 1 commit intomainfrom
shaw/add-ugreen-platform

Conversation

@decriptor
Copy link
Copy Markdown
Collaborator

Summary

Adds UGREEN (UGOS Pro / Container Manager) to the configurator's platform dropdown with researched, community-validated defaults.

Closes #16.

Defaults

Field Value Why
roon /volume1/docker/roon Matches the Marius Hosting / community Docker convention used across UGREEN guides — UGOS Pro ships Container Manager with /volume1/docker/<app> as the de facto layout
music /volume1/Music UGOS Pro auto-creates a Music shared folder (capital M) on initial setup. Linux underneath is case-sensitive, so capitalization matters
backup /volume1/roon-backups UGREEN community has no standard convention; mirrors the Synology default
prefix /volume1/ Synology-style volume namespace
rootPattern ^/volume Broader than Synology's ^/volume\d+/ so /volumeUSB1/usbshare/... external-drive paths don't false-positive a warning
userOverride (not set) UGREEN Container Manager honors the image's default user — no 0:0 workaround needed

Hint copy

Paths set for UGREEN UGOS Pro (Container Manager). The default Music share is /volume1/Music (capital M). Use Docker network mode 'host' — bridged breaks Roon discovery.

The network_mode: host callout is deliberate: it's the single most common UGREEN-specific support topic in the Roon Community for Docker setups (bridged mode silently breaks mDNS/SSDP).

Position in dropdown

index.json order: qnap, synology, unraid, truenas, ugreen, linux, custom — appended between truenas and the linux/custom tail so existing platform ordering is preserved.

Sources backing the choices

Test plan

  • npm run typecheck clean
  • npm test — 121/121 (platforms tests auto-discover the new JSON and validate it against schema.json)
  • npm run test:e2e — 23/23 (dropdown-order test updated to include ugreen)
  • CI: build + tests + Pages deploy on merge

Copilot AI review requested due to automatic review settings April 25, 2026 08:36
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new “UGREEN” platform preset (UGOS Pro / Container Manager) to the configurator so users get sensible default mount paths and guidance when generating configs.

Changes:

  • Added ugreen.json platform preset with UGREEN-specific default paths, hint text, and a /volume root pattern.
  • Inserted ugreen into the platform manifest ordering (index.json) between truenas and linux.
  • Updated the E2E dropdown-order assertion to include the new platform.

Reviewed changes

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

File Description
configurator/public/platforms/ugreen.json Introduces the UGREEN preset defaults (paths, hint, rootPattern).
configurator/public/platforms/index.json Adds ugreen to the platform dropdown ordering/manifest.
configurator/e2e/configurator.spec.ts Updates the expected platform dropdown options list to include ugreen.

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

@decriptor decriptor force-pushed the shaw/add-ugreen-platform branch from d8e8ab4 to 3e245a6 Compare April 30, 2026 02:49
Adds UGREEN (UGOS Pro / Container Manager) to the platform dropdown
with Synology-style /volume1/... defaults.

Defaults:
- roon:   /volume1/docker/roon (matches the Marius Hosting / community
          Docker convention used across UGREEN guides)
- music:  /volume1/Music (capital M — the auto-created share UGOS Pro
          ships with by default; paths are case-sensitive)
- backup: /volume1/roon-backups (mirrors the Synology default; UGREEN
          community has no standard backup convention)

rootPattern is `^/volume` (rather than `^/volume\d+/`) so /volumeUSB1/...
external-drive paths don't trigger a false-positive warning. Hint calls
out the network_mode: host requirement since bridged mode breaks Roon's
mDNS/SSDP discovery — the most common UGREEN-specific support topic in
the Roon Community.

No userOverride: UGREEN Container Manager honors the image's default
user, unlike TrueNAS Apps' UID 568 default.

Position in index.json: between truenas and linux, so existing platform
ordering is preserved.

Closes #16.
@decriptor decriptor force-pushed the shaw/add-ugreen-platform branch from 3e245a6 to 6d646e3 Compare April 30, 2026 02:49
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.

U-Green Nas

2 participants