Skip to content
Create account or Sign in
The Stripe Docs logo
/
Ask AI
Create accountSign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
APIs & SDKsHelp
Overview
Versioning
Changelog
Upgrade your API version
Upgrade your SDK version
Essentials
SDKs
API
Testing
Stripe CLI
Sample projects
Tools
Stripe Dashboard
Workbench
Developers Dashboard
Stripe Shell
Stripe for Visual Studio Code
Features
Workflows
Event Destinations
Stripe health alertsFile uploads
AI solutions
Agent toolkit
Model Context ProtocolBuild agentic AI SaaS Billing workflows
Security and privacy
Security
Stripebot web crawler
Privacy
Extend Stripe
Build Stripe apps
    Overview
    Get started
    Create an app
    How Stripe Apps work
    Sample apps
    Build an app
    Store secrets
    API authentication methods
    Authorisation flows
    Server-side logic
    Listen to events
    Handle different modes
    Enable sandbox support
    Enable local network access
    App settings page
    Build a UI
    Onboarding
    Distribute your app
    Distribution options
    Upload your app
    Versions and releases
    Test your app
    Publish your app
    Promote your app
    Add deep links
    Create install links
    Assign roles in UI extensions
    Post-install actions
    App analytics
    Embedded components
    Embed third-party Stripe Apps
    Migrating to Stripe Apps
    Migrate or build an extension
    Migrate a plugin to Stripe Apps or Stripe Connect
    Reference
    App manifest
    CLI
    Extension SDK
    Permissions
    Viewports
    Design patterns
    Components
Use apps from Stripe
Partners
Partner ecosystem
Partner certification
United States
English (United Kingdom)
HomeDeveloper resourcesBuild Stripe apps

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.

An example of a prompt that requests local network access on the Enable Preview mode page.

Troubleshooting

If you blocked access to a local network, you can update your permission settings by following these steps:

  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. The icon differs between different browsers.
  3. Select Site settings.
  4. Find Local network access.
  5. Click Allow.
  6. Refresh the Stripe Dashboard page.

Alternatively, you can also use the chrome://settings/content/localNetworkAccess page to inspect and adjust current local network access settings.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc