Repository navigation
The Plex appliance moves to Ubuntu 26.04 and asks for its folders over virtiofs - #24
Merged
Merged
Conversation
…r virtiofs The image is Canonical's 26.04 cloud image, release-20260927, with the sha256 from that release's SHA256SUMS. Its stock kernel lists directories quickly over virtiofs, so the guest needs no newer kernel installed at first boot. firstBoot.shareTransport: "virtiofs" asks the box to share the folders straight into the guest. A platform that cannot (or predates the field) ignores it and mounts over SMB, so the blueprint requires no new capability. The contract refuses the field without a share list, virtiofs on a profile that cannot take it, and more than seven shares over virtiofs. The vendored schema was synced from the platform branch that adds the field; re-vendor from staging once that lands.
…ing, which now has the vm-virtiofs gate (eshtek/hexos-platform#2043)
4 of 5 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Not for catalog
produntil a platform prod release carries eshtek/hexos-platform#2043. Staging is fine now: #2043 is merged there.Summary
eshtek/hexos-platform#2043 adds a second way for the Plex appliance to read its folders. With virtiofs, the box hands each folder straight into the guest, with no network, shim or SMB password in the path. A blueprint asks for it with
firstBoot.shareTransport: "virtiofs".The platform chooses virtiofs only when all of these hold:
vm-virtiofsfeature is open for that server;plex-appliancetoday).Otherwise it mounts over SMB as before. The capability the box reports,
firstBootVirtiofs, is never required, so a platform that predates the field ignores it and installs over SMB.Changes:
plex-server.json:release-20260927, sha256 from that release's SHA256SUMS). Its stock 7.0 kernel lists large directories quickly over FUSE, which 24.04's 6.8 kernel does not, so the guest needs no newer kernel.shareTransport: "virtiofs"._lib/contract.ts(tests incontract.test.ts): refusesshareTransportin three cases:staging@5af11a0d0withbun run sync-schema. This also brings staging's app widget grammar (widgetsSchema 3, eshtek/hexos-platform#2058) into_lib/surface-grammar.ts, which nothing in this PR uses.plex_setup.tscomments: updated for the new field.What changes for users once this syncs: every new Plex install runs Ubuntu 26.04. Installs keep using SMB until
vm-virtiofsis granted, and existing Plex VMs are not touched.Test plan
bun run validate: 29 blueprints and 32 apps, 0 errors.bun run test-hooks): 81 pass.bun run typecheck: the same 5 errors in the vendoredvm-surfaces.tsas onstaging, none from this PR.15-vms/26-vm-virtiofspassed 9/9, including a host reboot, on TrueNAS 26.0.0-BETA.3, 25.10.7 and 25.04.2.6. It covers the virtiofs install of this blueprint, the guest mounting every folder, guest reboot, restart, folder guards, and the reboot-then-unlock path.