Enable local network access

Enable local network access (LNA) for app preview.

Local network access permission

Newer versions of some internet browsers implement LNA restrictions. This security feature protects you from obscure tracking methods and attacks that target devices on your home or work network (for example, printers or routers).

For example, Chrome (starting with version 142) adds a new permission prompt for all local network access. This means you must explicitly grant the permission for sites that make connections to a user’s local network, as described in the specification.

LNA permission requirements for Stripe Apps

When previewing your app, the browser requires LNA permission for the browser to download static assets (such as JavaScript bundles) from a local HTTP server started by the stripe apps start CLI command. This allows you to preview your app changes in the Dashboard.

Allow local network access for Stripe Apps

To allow LNA for Stripe Apps:

1. Open terminal and run stripe apps start .
2. You’ll see a prompt on the enable preview page asking you to grant LNA to the Stripe Dashboard. See Getting started with Stripe Apps to learn more.

After you grant permission, you can make requests to the local HTTP server to download Stripe App JavaScript bundles.

Troubleshooting

If you blocked access to a local network, you can update your permission settings.

Chrome

To update your Chrome LNA permission settings:

1. Open the Stripe Dashboard in Chrome.
2. Click the site settings in the address bar. The site settings are behind what Google refers to as the “tune icon” in Chrome, next to the first letter of the URL.
3. Select Site settings .
4. Find Local network .
5. Click Allow .
6. Refresh the Stripe Dashboard page.

Alternatively, use the chrome://the relevant part of the product page to inspect and adjust current local network access settings.

If Chrome still can’t access the local network after granting permission, there might be a macOS bug where local network requests are blocked even though the permission appears granted. See Browser local network access in the Terminal network requirements for steps to fix this.

Firefox

To update your Firefox LNA permission settings, see Control personal device and local network permissions in Firefox in Mozilla’s documentation.

macOS

On macOS, apps must be explicitly permitted to access the local network. To verify that Chrome or Firefox has local network access:

1. Open System Settings .
2. Click Privacy & Security .
3. Click Local Network .
4. Confirm that Chrome or Firefox is listed with the toggle enabled.

Browser extensions

Browser extensions can interfere with local network requests. To rule out extensions as a cause, try connecting to your reader in a private or incognito window, which disables most extensions by default.