---
title: Localhost-based development for shopify app dev - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/localhost-based-development-for-shopify-app-dev
  md: https://shopify.dev/changelog/localhost-based-development-for-shopify-app-dev.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

May 21, 2025

Tags:

* Tools

# Localhost-based development for `shopify app dev`

Now, you can serve your app using `localhost` (`127.0.0.1`) with a self-signed HTTPS certificate, which Shopify CLI generates for you. This allows you to develop some Shopify app features without the use of network tunnels.

To serve your app using localhost, run the following command using Shopify CLI 3.80 or higher: `shopify app dev --use-localhost`.

Newly added since developer preview:

* `--use-localhost` will now use a static port by default, which you can override with `--localhost-port`.
* Detection of Windows Subsystem for Linux and documentation on additional required steps for its setup.

**Note**: Localhost-based development isn't compatible with the Shopify features that directly invoke your app, such as Webhooks, App proxy, and Flow actions, and features that require you to test your app from another device, such as POS.

For more information, you can read about [networking options for local development](https://shopify.dev/docs/apps/build/cli-for-apps/networking-options).

Please report any issues and provide your feedback about this feature [on the Shopify Developer Community](https://community.shopify.dev/new-topic?category=shopify-cli-libraries\&tags=app-dev-on-localhost).