Local development

Run your Pages application locally with our Wrangler Command Line Interface (CLI).

Install Wrangler

To get started with Wrangler, refer to the Install/Update Wrangler.

Run your Pages project locally

The main command for local development on Pages is wrangler pages dev. This will let you run your Pages application locally, which includes serving static assets and running your Functions.

With your folder of static assets set up, run the following command to start local development:

npx wrangler pages dev <DIRECTORY-OF-ASSETS>

This will then start serving your Pages project. You can press b to open the browser on your local site, (available, by default, on http://localhost:8788 ↗).

Note

If you have a wrangler.toml file configured for your Pages project, you can run wrangler pages dev without specifying a directory.

HTTPS support

To serve your local development server over HTTPS with a self-signed certificate, you can set local_protocol via wrangler.toml or you can pass the --local-protocol=https argument to wrangler pages dev:

npx wrangler pages dev --local-protocol=https <DIRECTORY-OF-ASSETS>

Attach bindings to local development

To attach a binding to local development, refer to Bindings and find the Cloudflare Developer Platform resource you would like to work with.

Additional configuration via wrangler.toml

If you are using a wrangler.toml configuration file in your project, you can set up dev server values like: port, local protocol, ip, and port. For more information, read about configuring local development settings.

Was this helpful?

What did you like?

Accurate

Easy to understand

Solved my problem

Helped me decide to use the product

Other

What went wrong?

Hard to understand

Incorrect information

Missing the information

Other

Thank you for helping improve Cloudflare's documentation!