{"id":29973952,"url":"https://github.com/cloudflare/wrangler","last_synced_at":"2025-08-04T07:05:47.522Z","repository":{"id":37490671,"uuid":"175043545","full_name":"cloudflare/wrangler-legacy","owner":"cloudflare","description":"🤠  Home to Wrangler v1 (deprecated)","archived":true,"fork":false,"pushed_at":"2023-08-03T18:15:03.000Z","size":6566,"stargazers_count":3200,"open_issues_count":0,"forks_count":335,"subscribers_count":57,"default_branch":"master","last_synced_at":"2025-08-03T19:08:58.493Z","etag":null,"topics":["cli","cloudflare-workers","rust","serverless"],"latest_commit_sha":null,"homepage":"https://workers.cloudflare.com","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudflare.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null}},"created_at":"2019-03-11T16:45:52.000Z","updated_at":"2025-08-02T16:31:16.000Z","dependencies_parsed_at":"2022-07-14T04:30:35.719Z","dependency_job_id":"ee589a0a-45da-4eb0-a473-8bfb01ffa959","html_url":"https://github.com/cloudflare/wrangler-legacy","commit_stats":{"total_commits":1673,"total_committers":122,"mean_commits":13.71311475409836,"dds":0.7698744769874477,"last_synced_commit":"0cd971caf2290bf1aa80810ef237df2ce1f065f0"},"previous_names":["cloudflare/wrangler"],"tags_count":84,"template":false,"template_full_name":null,"purl":"pkg:github/cloudflare/wrangler-legacy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudflare%2Fwrangler-legacy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudflare%2Fwrangler-legacy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudflare%2Fwrangler-legacy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudflare%2Fwrangler-legacy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudflare","download_url":"https://codeload.github.com/cloudflare/wrangler-legacy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudflare%2Fwrangler-legacy/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268660065,"owners_count":24286011,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-04T02:00:09.867Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","cloudflare-workers","rust","serverless"],"created_at":"2025-08-04T07:01:25.742Z","updated_at":"2025-08-04T07:05:47.513Z","avatar_url":"https://github.com/cloudflare.png","language":"Rust","readme":"# 🤠 wrangler\n\n:stop_sign: This repository is for Wrangler version 1, which is deprecated and no longer updated. This repository is now archived.\n\nNew versions of Wrangler are maintained in the [Workers SDK repository](https://github.com/cloudflare/workers-sdk).\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003eLegacy Documentation\u003c/summary\u003e\n\n![Banner](/banner.png)\n\n[![crates.io](https://img.shields.io/crates/v/wrangler.svg)](https://crates.io/crates/wrangler) \u0026nbsp;\n[![npm](https://img.shields.io/npm/v/@cloudflare/wrangler.svg)](https://www.npmjs.com/package/@cloudflare/wrangler) \u0026nbsp;\n[![GitHub Actions - Test Status](https://github.com/cloudflare/wrangler-legacy/workflows/Tests/badge.svg)](https://github.com/cloudflare/wrangler-legacy/actions) \u0026nbsp;\n[![GitHub Actions - Linter Status](https://github.com/cloudflare/wrangler-legacy/workflows/Linters/badge.svg)](https://github.com/cloudflare/wrangler-legacy/actions) \u0026nbsp;\n\n`wrangler` is a CLI tool designed for folks who are interested in using [Cloudflare Workers](https://workers.cloudflare.com/).\n\n![Wrangler Demo](/wrangler-demo.gif)\n\n## Installation\n\nYou have many options to install wrangler! \n\nFor the latest version, see https://github.com/cloudflare/workers-sdk\n\n### Install with `npm`\n\nWe strongly recommend you install `npm` with a Node version manager like [`nvm`](https://github.com/nvm-sh/nvm#installing-and-updating), which puts the global `node_modules` in your home directory to eliminate permissions issues with `npm install -g`. Distribution-packaged `npm` installs often use `/usr/lib/node_modules` (which is root) for globally installed `npm` packages, and running `npm install -g` as `root` prevents `wrangler` from installing properly.\n\nOnce you've installed `nvm` and configured your system to use the `nvm` managed node install, run:\n\n```bash\nnpm i @cloudflare/wrangler -g\n```\n\nIf you are running an ARM based system (eg Raspberry Pi, Pinebook) you'll need to use the `cargo` installation method listed below to build wrangler from source.\n\n#### Specify binary location\n\nIn case you need `wrangler`'s npm installer to place the binary in a non-default location (such as when using `wrangler` in CI), you can use the following configuration options to specify an install location:\n\n- Environment variable: `WRANGLER_INSTALL_PATH`\n- NPM configuration: `wrangler_install_path`\n\n#### Specify binary site URL\n\nIn case you need to store/mirror binaries on premise you will need to specify where wrangler should search for them by providing any of the following:\n\n- Environment variable: `WRANGLER_BINARY_HOST`\n- NPM configuration: `wrangler_binary_host`\n\n### Install with `cargo`\n\n```bash\ncargo install wrangler\n```\n\nIf you don't have `cargo` or `npm` installed, you will need to follow these [additional instructions](https://developers.cloudflare.com/workers/cli-wrangler/install-update/#manual-install).\n\n### Install on Windows\n\n[perl is an external dependency of crate openssl-sys](https://github.com/sfackler/rust-openssl/blob/b027f1603189919d5f63c6aff483243aaa188568/openssl/src/lib.rs#L11-L15). If installing wrangler with cargo, you will need to have perl installed. We've tested with [Strawberry Perl](https://www.perl.org/get.html). If you instead install perl via scoop, you may need to also run `scoop install openssl` in order to get the necessary openssl dlls. Installing wrangler with `npm` instead of cargo is another option if you don't want to install perl.\n\n## Updating\n\nFor information regarding updating Wrangler, click [here](https://developers.cloudflare.com/workers/cli-wrangler/install-update#update).\n\n## Getting Started\n\nOnce you have installed Wrangler, spinning up and deploying your first Worker is easy!\n\n```console\n$ wrangler generate my-worker\n$ cd my-worker\n# update your wrangler.toml with your Cloudflare Account ID\n$ wrangler config\n$ wrangler publish\n```\n\n## 🎙️ Top Level Commands\n\n### 👯 `generate`\n\nScaffold a project, including boilerplate code for a Rust library and a Cloudflare Worker.\n\n```bash\nwrangler generate \u003cname\u003e \u003ctemplate\u003e --type=[\"webpack\", \"javascript\", \"rust\"]\n```\n\nAll of the arguments and flags to this command are optional:\n\n- `name`: defaults to `worker`\n- `template`: defaults to the [`https://github.com/cloudflare/worker-template`](https://github.com/cloudflare/worker-template)\n- `type`: defaults to `javascript` based on the [\"worker-template\"](https://github.com/cloudflare/worker-template/blob/master/wrangler.toml)\n\n### 📥 `init`\n\nCreates a skeleton `wrangler.toml` in an existing directory. This can be used as an alternative to `generate` if you prefer to clone a repository yourself.\n\n```bash\nwrangler init \u003cname\u003e --type=[\"webpack\", \"javascript\", \"rust\"]\n```\n\nAll of the arguments and flags to this command are optional:\n\n- `name`: defaults to the name of your working directory\n- `type`: defaults to [\"webpack\"](https://developers.cloudflare.com/workers/tooling/wrangler/webpack).\n\n### 🦀⚙️ `build`\n\nBuild your project. This command looks at your `wrangler.toml` file and runs the build steps associated\nwith the `\"type\"` declared there.\n\nAdditionally, you can configure different [environments](https://developers.cloudflare.com/workers/tooling/wrangler/configuration/environments).\n\n### 🔓 `login`\n\nAuthorize Wrangler with your Cloudflare login. This will prompt you with a Cloudflare account login page and a permissions consent page.\nThis command is the alternative to `wrangler config` and it uses OAuth tokens.\n\n```bash\nwrangler login --scopes-list --scopes \u003cscopes\u003e\n```\n\nAll of the arguments and flags to this command are optional:\n\n- `scopes-list`: list all the available OAuth scopes with descriptions.\n- `scopes`: allows to choose your set of OAuth scopes.\n\nRead more about this command in [Wrangler Login Documentation](https://developers.cloudflare.com/workers/cli-wrangler/commands#login).\n\n### 🔧 `config`\n\nAuthenticate Wrangler with a Cloudflare API Token. This is an interactive command that will prompt you for your API token:\n\n```bash\nwrangler config\nEnter API token:\nsuperlongapitoken\n```\n\nYou can also provide your email and global API key (this is not recommended for security reasons):\n\n```bash\nwrangler config --api-key\nEnter email:\ntestuser@example.com\nEnter global API key:\nsuperlongapikey\n```\n\nYou can also [use environment variables](https://developers.cloudflare.com/workers/tooling/wrangler/configuration/) to configure these values.\n\n### ☁️ 🆙 `publish`\n\nPublish your Worker to Cloudflare. Several keys in your `wrangler.toml` determine whether you are publishing to a workers.dev subdomain or your own registered domain, proxied through Cloudflare.\n\nAdditionally, you can configure different [environments](https://developers.cloudflare.com/workers/tooling/wrangler/configuration/environments).\n\nYou can also use environment variables to handle authentication when you publish a Worker.\n\n```bash\n# e.g.\nCF_API_TOKEN=superlongtoken wrangler publish\n# where\n# $CF_API_TOKEN -\u003e your Cloudflare API token\n\nCF_API_KEY=superlongapikey CF_EMAIL=testuser@example.com wrangler publish\n# where\n# $CF_API_KEY -\u003e your Cloudflare API key\n# $CF_EMAIL -\u003e your Cloudflare account email\n```\n\n### 🗂 `kv`\n\nInteract with your Workers KV store. This is actually a whole suite of subcommands. Read more about in [Wrangler KV Documentation](https://developers.cloudflare.com/workers/cli-wrangler/commands#kv).\n\n### 👂 `dev`\n\n`wrangler dev` works very similarly to `wrangler preview` except that instead of opening your browser to preview your worker, it will start a server on localhost that will execute your worker on incoming HTTP requests. From there you can use cURL, Postman, your browser, or any other HTTP client to test the behavior of your worker before publishing it.\n\nYou should run wrangler dev from your worker directory, and if your worker makes any requests to a backend, you should specify the host with `--host example.com`.\n\nFrom here you should be able to send HTTP requests to `localhost:8787` along with any headers and paths, and your worker should execute as expected. Additionally, you should see console.log messages and exceptions appearing in your terminal.\n\n```bash\n👂 Listening on http://localhost:8787\n[2020-02-18 19:37:08] GET example.com/ HTTP/1.1 200 OK\n```\n\nAll of the arguments and flags to this command are optional:\n\n- `env`: environment to build\n- `host`: domain to test behind your worker. defaults to example.com\n- `ip`: ip to listen on. defaults to localhost\n- `port`: port to listen on. defaults to 8787\n\n## Additional Documentation\n\nAll information regarding wrangler or Cloudflare Workers is located in the [Cloudflare Workers Developer Docs](https://developers.cloudflare.com/workers/). This includes:\n\n- Using wrangler [commands](https://developers.cloudflare.com/workers/wrangler/commands/)\n- Wrangler [configuration](https://developers.cloudflare.com/workers/wrangler/configuration)\n- General documentation surrounding Workers development\n- All wrangler features such as Workers Sites and KV\n\n## ✨Workers Sites\n\nTo learn about deploying static assets using `wrangler`, see the [Workers Sites Quickstart](https://developers.cloudflare.com/workers/sites/).\n\n\u003c/details\u003e","funding_links":[],"categories":["Miscellaneous","Rust","Workers","Official"],"sub_categories":["Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudflare%2Fwrangler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudflare%2Fwrangler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudflare%2Fwrangler/lists"}