u/Friendly_Potential69

Hi all — running TrueNAS SCALE 25.10.3 and trying to install a custom app via a combined Docker Compose YAML, but I can’t find the Install via YAML option anywhere in the Apps UI.

Edit: it is explained in the doc, and there are 3 docs next to "Discovery", so it's me who was blind, apologies for the waste of time!

Custom App on the Discover screen opens the Install iX App guided installation wizard. more_vert > Install via YAML opens the Add Custom App screen with an advanced YAML editor for deploying apps using Docker Compose.

source:

https://www.truenas.com/docs/scale/25.10/scaleuireference/apps/installcustomappscreens/index.html

Original post:

I checked the official docs (the only relevant doc I found):
https://www.truenas.com/docs/scale/25.10/scaleuireference/apps/installcustomappscreens/index.html

I also inspected the Apps UI form I do have, it shows the per‑container fields (Application Name, Version, Image, Ports, Storage, Environment, Security Context, Network, etc.) but there’s no YAML editor, no “Install via YAML” button, and no three‑dot menu that I read somewhere.

Here’s the UI text I see (copied from the form):

Code

Application name
Application Name*
Version*
1.4.3
General
Notes
...
Image Configuration
Repository* Tag Pull Policy*
Container Configuration
Hostname Entrypoint Command Timezone* Environment Variables Restart Policy* TTY Stdin Devices
Security Context Configuration Privileged Capabilities Custom User
Network Configuration Host Network Ports Networks Custom DNS Setup
Storage Configuration Storage
Labels Configuration
Resources Configuration Enable Resource Limits GPU Configuration

Questions for the community:

• Is Install via YAML hidden behind a setting or a specific Apps catalog version in 25.10.3?
• Do I need to enable something (Apps feature, a catalog, or a specific permission) to see the YAML option?
• Has the UI changed in 25.10.3 so the YAML install moved somewhere else?
• If the YAML option is gone, what’s the recommended workflow to deploy a combined compose file via the UI (or best GUI alternative)?

What I’ve tried:

• Looked through Apps → Discover / Custom App and the Apps page (no YAML option).
• Verified I’m using an admin account.
• Read the linked docs page above (only doc I could find about the feature).

Any pointers appreciated, if someone can point to the exact clicks or a screenshot of where the YAML editor lives in 25.10.3, that would be perfect.

Thanks.

PS: Truenas UI sucks with hiding components, I keep running into UI decisions that waste time. Case in point: I wanted to update my ZFS pool after a minor version upgrade. I spent ages hunting for an “Update pool” button only to discover it only appears if an update is actually available. No greyed‑out button, no tooltip, no explanation: it simply isn’t there until the system decides to show it.

That’s terrible UX. If a control is conditional, at least show it disabled with a short explanation like “No update available” or “Pool already up to date” so users don’t waste time looking for something that isn’t visible. Hiding controls entirely makes routine maintenance confusing and leads to wasted time and frustration.

I read afterwards that it's only visible after major version update but still!!