Install / Update

Last updated Apr 23, 2026 Caution

This page is for Wrangler v1, which has been deprecated. Learn how to update to the latest version of Wrangler.

Install

Install with npm

npm i @cloudflare/wrangler -g

EACCESS error

You may have already installed npm. It is possible that an EACCES error may be thrown while installing Wrangler. This is related to how many systems install the npm binary. It is recommended that you reinstall npm using a Node version manager like nvm ↗︎ or Volta ↗︎.

Install with cargo

Assuming you have Rust’s package manager, Cargo ↗︎, installed, run:

cargo install wrangler

Otherwise, to install Cargo, you must first install rustup. On Linux and macOS systems, rustup can be installed as follows:

curl https://sh.rustup.rs -sSf | sh

Additional installation methods are available on the Rust site ↗︎.

Windows users will need to install Perl as a dependency for openssl-sys — Strawberry Perl ↗︎ is recommended.

After Cargo is installed, you may now install Wrangler:

cargo install wrangler

Customize OpenSSL

By default, a copy of OpenSSL is included to make things easier during installation, but this can make the binary size larger. If you want to use your system's OpenSSL installation, provide the feature flag sys-openssl when running install:

cargo install wrangler --features sys-openssl

Manual install

  1. Download the binary tarball for your platform from the releases page ↗︎. You do not need the wranglerjs-*.tar.gz download – Wrangler will install that for you.
  2. Unpack the tarball and place the Wrangler binary somewhere on your PATH, preferably /usr/local/bin for Linux/macOS or Program Files for Windows.

Update

To update Wrangler ↗︎, run one of the following:

Update with npm

npm update -g @cloudflare/wrangler

Update with cargo

cargo install wrangler --force

Was this helpful?

YesNo

On this page

Install / Update - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/wrangler/#page","headline":"Install / Update","description":"Install or update Wrangler v1 using npm or Cargo. Now deprecated in favor of the latest Wrangler release.","url":"https://developers.cloudflare.com/workers/wrangler/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/wrangler/migration/v1-to-v2/wrangler-legacy/install-update/og.png?v=1e1d3ae0f48926f6","dateModified":"2026-04-23","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Learn how to migrate from Wrangler v1 to v2 using webpack. This guide covers configuration, custom builds, and compatibility for Cloudflare Workers. title: Webpack image: https://developers.cloudflare.com/workers/wrangler/migration/v1-to-v2/wrangler-legacy/webpack/og.png?v=2e70fa1294828b9b

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.