Skip to content

feat(build): ALLOW_LOCAL_NETWORK_ACCESS_IFRAMES env var for plugin local network access - #399

Open
jannefleischer wants to merge 1 commit into
Euro-Office:mainfrom
jannefleischer:feat/local-network-access-opt-in
Open

jannefleischer wants to merge 1 commit into
Euro-Office:mainfrom
jannefleischer:feat/local-network-access-opt-in

Conversation

@jannefleischer

@jannefleischer jannefleischer commented Oct 4, 2026 •

Copy link
Copy Markdown

Context

Companion to Euro-Office/web-apps#276, Euro-Office/sdkjs#95, Euro-Office/server#53 and Euro-Office/documentation#21. Those PRs make delegating the browser's local-network-access/loopback-network permission to plugin iframes an opt-in by the server operator (config key security.allowLocalNetworkAccessIframes, default false). This is needed e.g. for an AI plugin that calls an internal Ollama instance from the browser.

Change

  • New env var ALLOW_LOCAL_NETWORK_ACCESS_IFRAMES (default false), analogous to ALLOW_PRIVATE_IP_ADDRESS:
    • build/scripts/standalone/entrypoint.sh: sets .security.allowLocalNetworkAccessIframes = true via jq_set
    • build/scripts/orchestrated/docker-entrypoint.sh: adds the security block to the exported NODE_CONFIG
  • Documentation is in docs(configuration): document plugin access to the local network documentation#21 (docs/configuration/server.md, docs/configuration/plugins.md) rather than in the README, next to the other env vars.

Caveats

Effective in Chromium-based browsers and Firefox ≥ 153 (which also uses its own network.lna.* prefs); Safari/WebKit is still implementing it (see web-apps#276).

Submodule pointers are not bumped here; that should happen once the server/sdkjs/web-apps PRs are merged. Draft until the maintainers agree on the approach in web-apps#276.

AI-assisted; disclosed per the AI Contribution Policy.

Maps to security.allowLocalNetworkAccessIframes (Euro-Office/server#53)
in the standalone and orchestrated entrypoints. Default false.

AI-assisted; disclosed per the AI Contribution Policy.

Signed-off-by: jannefleischer <janne.fleischer@ils-forschung.de>
@jannefleischer
jannefleischer force-pushed the feat/local-network-access-opt-in branch from 32cc2aa to 755b617 Compare October 7, 2026 13:46
@juliusknorr juliusknorr added this to the 9.4.0 milestone Oct 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: 📄 To do

Development

Successfully merging this pull request may close these issues.

2 participants