assetProtocol is not documented enough / missing requireLiteralLeadingDot example

[Richienb]

Describe the bug

My tauri config includes:

		"security": {
			"assetProtocol": {
				"enable": true,
				"scope": ["*/**"]
			},
			"csp": null
		}

This doesn't work on Linux.

On Linux, it seems that there is an invisible barrier that prevents globs from passing into home directories

When the scope is /home/richie/.cache/myapp/**, the image loaded
When the scope is /home/richie/.cache/**, the image loaded
When the scope is /home/richie/**, I get asset protocol not configured to allow the path:

Reproduction

No response

Expected behavior

No response

Full tauri info output

[?] Environment
    - OS: Fedora 43.0.0 x86_64 (X64) (gnome on wayland)
    ? webkit2gtk-4.1: 2.52.1
    ? rsvg2: 2.61.0
    ? rustc: 1.95.0 (59807616e 2026-04-14)
    ? cargo: 1.95.0 (f2d3ce0bd 2026-03-21)
    ? rustup: 1.29.0
    ? Rust toolchain: stable-x86_64-unknown-linux-gnu (default)
    - node: 24.15.0
    - npm: 11.12.1

[-] Packages
    - tauri ?: 2.10.3
    - tauri-build ?: 2.5.6
    - wry ?: 0.54.2, (outdated, latest: 0.55.0)
    - tao ?: 0.34.5, (outdated, latest: 0.35.0)
    - @tauri-apps/api  ??: 2.10.1
    - @tauri-apps/cli  ??: 2.10.1
        
[-] Plugins
    - tauri-plugin-opener ?: 2.5.3
    - @tauri-apps/plugin-opener  ??: not installed!
    - tauri-plugin-log ?: 2.8.0
    - @tauri-apps/plugin-log  ??: 2.8.0
    - tauri-plugin-dialog ?: 2.6.0, (outdated, latest: 2.7.0)
    - @tauri-apps/plugin-dialog  ??: not installed!
    - tauri-plugin-fs ?: 2.4.5, (outdated, latest: 2.5.0)
    - @tauri-apps/plugin-fs  ??: not installed!
    - tauri-plugin-os ?: 2.3.2
    - @tauri-apps/plugin-os  ??: 2.3.2

[-] App
    - build-type: bundle
    - CSP: unset
    - frontendDist: ../dist
    - devUrl: http://localhost:1420/
    - framework: React
    - bundler: Vite

Stack trace

Additional context

No response

[FabianLars]

seems like you're hitting the requireLiteralLeadingDot config. try this: tauri-apps/tauri#13788 (comment)

[Richienb]

seems like you're hitting the requireLiteralLeadingDot config. try this: tauri-apps/tauri#13788 (comment)

This worked!

Could we add a "tip" somewhere in the documentation?

Further, the documentation for requireLiteralLeadingDot is within a plaintext markdown block in FsScope. Is this already reported elsewhere?

[FabianLars]

it should be reported somewhere, it's at least known to us that the config page is a bit broken.