# netlify

> Netlify command line tool

Latest version **27.8.0** (published 2026-09-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install netlify
pnpm add netlify
yarn add netlify
bun add netlify
```

Provides the command `npxnetlify`.

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 27.8.0 |
| Published | 2026-09-16 |
| First published | 2014-10-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.13.0 |
| Dependencies | 97 |
| Unpacked size | 1.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | yes |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 1918 |
| Author | Netlify Inc. |
| Maintainers | netlify-bot, mikewen, youvalv, serhalp-netlify, mlgualtieri-gatsby |
| Keywords | api, cli, netlify, static |

## Links

- npm: https://www.npmjs.com/package/netlify
- Repository: https://github.com/netlify/cli
- Issues: https://github.com/netlify/cli/issues
- npm.io page: https://npm.io/package/netlify

## Dependencies (97)

- [pg](https://npm.io/package/pg.md) ^8.20.0
- [ws](https://npm.io/package/ws.md) ^8.19.0
- [etag](https://npm.io/package/etag.md) ^1.8.1
- [open](https://npm.io/package/open.md) ^11.0.0
- [toml](https://npm.io/package/toml.md) ^4.0.0
- [ulid](https://npm.io/package/ulid.md) ^3.0.1
- [boxen](https://npm.io/package/boxen.md) ^8.0.1
- [chalk](https://npm.io/package/chalk.md) ^6.0.0
- [debug](https://npm.io/package/debug.md) ^4.4.3
- [execa](https://npm.io/package/execa.md) ^5.1.1
- [fuzzy](https://npm.io/package/fuzzy.md) ^0.1.3
- [isexe](https://npm.io/package/isexe.md) ^4.0.0
- [p-map](https://npm.io/package/p-map.md) ^7.0.3
- [yauzl](https://npm.io/package/yauzl.md) ^3.3.1
- [cookie](https://npm.io/package/cookie.md) ^2.0.0
- [dotenv](https://npm.io/package/dotenv.md) ^17.3.1
- [is-wsl](https://npm.io/package/is-wsl.md) ^3.1.0
- [semver](https://npm.io/package/semver.md) ^7.7.2
- [backoff](https://npm.io/package/backoff.md) ^2.5.0
- [ci-info](https://npm.io/package/ci-info.md) ^4.4.0
- [decache](https://npm.io/package/decache.md) ^4.6.2
- [envinfo](https://npm.io/package/envinfo.md) ^7.21.0
- [express](https://npm.io/package/express.md) ^5.2.1
- [fastify](https://npm.io/package/fastify.md) ^5.8.5
- [find-up](https://npm.io/package/find-up.md) ^8.0.0
- [chokidar](https://npm.io/package/chokidar.md) ^5.0.0
- [dot-prop](https://npm.io/package/dot-prop.md) ^10.1.0
- [get-port](https://npm.io/package/get-port.md) ^5.1.1
- [inquirer](https://npm.io/package/inquirer.md) ^8.2.7
- [p-filter](https://npm.io/package/p-filter.md) ^4.1.0
- [raw-body](https://npm.io/package/raw-body.md) ^4.0.0
- [readdirp](https://npm.io/package/readdirp.md) ^5.0.0
- [commander](https://npm.io/package/commander.md) ^12.1.0
- [env-paths](https://npm.io/package/env-paths.md) ^4.0.0
- [is-docker](https://npm.io/package/is-docker.md) ^4.0.0
- [is-stream](https://npm.io/package/is-stream.md) ^4.0.1
- [maxstache](https://npm.io/package/maxstache.md) ^1.0.7
- [clean-deep](https://npm.io/package/clean-deep.md) ^3.4.0
- [http-proxy](https://npm.io/package/http-proxy.md) ^1.18.1
- [jwt-decode](https://npm.io/package/jwt-decode.md) ^4.0.0
- [log-update](https://npm.io/package/log-update.md) ^8.0.0
- [modern-tar](https://npm.io/package/modern-tar.md) ^0.8.0
- [multiparty](https://npm.io/package/multiparty.md) ^4.2.3
- [node-fetch](https://npm.io/package/node-fetch.md) ^3.3.2
- [p-wait-for](https://npm.io/package/p-wait-for.md) ^6.0.0
- [prettyjson](https://npm.io/package/prettyjson.md) ^1.2.5
- [@netlify/ai](https://npm.io/package/@netlify/ai.md) ^1.0.1
- [ascii-table](https://npm.io/package/ascii-table.md) ^0.0.9
- [cron-parser](https://npm.io/package/cron-parser.md) ^5.0.0
- [locate-path](https://npm.io/package/locate-path.md) ^8.0.0
- [nanospinner](https://npm.io/package/nanospinner.md) ^1.2.2
- [@netlify/api](https://npm.io/package/@netlify/api.md) ^15.1.2
- [@netlify/dev](https://npm.io/package/@netlify/dev.md) ^5.1.2
- [@pnpm/tabtab](https://npm.io/package/@pnpm/tabtab.md) ^0.5.4
- [ansi-escapes](https://npm.io/package/ansi-escapes.md) ^7.3.0
- [ansi-to-html](https://npm.io/package/ansi-to-html.md) ^0.7.2
- [comment-json](https://npm.io/package/comment-json.md) ^5.0.0
- [content-type](https://npm.io/package/content-type.md) ^1.0.5
- [jsonwebtoken](https://npm.io/package/jsonwebtoken.md) ^9.0.3
- [lambda-local](https://npm.io/package/lambda-local.md) ^2.2.0
- [tomlify-j0.4](https://npm.io/package/tomlify-j0.4.md) ^3.0.0
- [@octokit/rest](https://npm.io/package/@octokit/rest.md) ^22.0.0
- [folder-walker](https://npm.io/package/folder-walker.md) ^3.2.0
- [git-repo-info](https://npm.io/package/git-repo-info.md) ^2.1.1
- [terminal-link](https://npm.io/package/terminal-link.md) ^5.0.0
- [@netlify/blobs](https://npm.io/package/@netlify/blobs.md) ^11.1.0
- [@netlify/build](https://npm.io/package/@netlify/build.md) ^37.0.0
- [gitconfiglocal](https://npm.io/package/gitconfiglocal.md) ^2.1.0
- [parse-duration](https://npm.io/package/parse-duration.md) ^2.1.6
- [@fastify/static](https://npm.io/package/@fastify/static.md) ^10.0.0
- [@netlify/config](https://npm.io/package/@netlify/config.md) ^25.2.5
- [@netlify/images](https://npm.io/package/@netlify/images.md) ^2.0.1
- [express-logging](https://npm.io/package/express-logging.md) ^1.1.1
- [read-package-up](https://npm.io/package/read-package-up.md) ^12.0.0
- [update-notifier](https://npm.io/package/update-notifier.md) ^7.3.1
- [maxstache-stream](https://npm.io/package/maxstache-stream.md) ^1.0.4
- [parse-github-url](https://npm.io/package/parse-github-url.md) ^1.0.3
- [https-proxy-agent](https://npm.io/package/https-proxy-agent.md) ^8.0.0
- [write-file-atomic](https://npm.io/package/write-file-atomic.md) ^5.0.1
- [@netlify/dev-utils](https://npm.io/package/@netlify/dev-utils.md) ^6.0.1
- [@opentelemetry/api](https://npm.io/package/@opentelemetry/api.md) ~1.9.0
- [netlify-redirector](https://npm.io/package/netlify-redirector.md) ^0.5.0
- [parallel-transform](https://npm.io/package/parallel-transform.md) ^1.2.0
- [source-map-support](https://npm.io/package/source-map-support.md) ^0.5.21
- [@netlify/build-info](https://npm.io/package/@netlify/build-info.md) ^11.3.0
- [@netlify/server-dev](https://npm.io/package/@netlify/server-dev.md) ^0.1.1
- [fastest-levenshtein](https://npm.io/package/fastest-levenshtein.md) ^1.0.16
- [@netlify/edge-bundler](https://npm.io/package/@netlify/edge-bundler.md) ^16.0.4
- [http-proxy-middleware](https://npm.io/package/http-proxy-middleware.md) ^3.0.5
- [normalize-package-data](https://npm.io/package/normalize-package-data.md) ^7.0.1
- [@netlify/edge-functions](https://npm.io/package/@netlify/edge-functions.md) ^4.0.0
- [@netlify/headers-parser](https://npm.io/package/@netlify/headers-parser.md) ^10.1.1
- [@netlify/redirect-parser](https://npm.io/package/@netlify/redirect-parser.md) ^16.1.1
- [@netlify/zip-it-and-ship-it](https://npm.io/package/@netlify/zip-it-and-ship-it.md) ^16.0.0
- [inquirer-autocomplete-prompt](https://npm.io/package/inquirer-autocomplete-prompt.md) ^1.4.0
- [@netlify/local-functions-proxy](https://npm.io/package/@netlify/local-functions-proxy.md) ^2.0.3
- [@netlify/edge-functions-bootstrap](https://npm.io/package/@netlify/edge-functions-bootstrap.md) ^3.2.0

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 27.8.0 (latest) — 2026-09-16
- 2.0.1-beta.8 (next) — 2018-09-24
- 27.7.0 — 2026-09-15
- 27.6.0 — 2026-09-14
- 27.5.2 — 2026-09-09
- 27.5.1 — 2026-09-08
- 27.5.0 — 2026-09-04
- 27.4.3 — 2026-09-04
- 27.4.2 — 2026-08-31
- 27.4.1 — 2026-08-28
- 27.4.0 — 2026-08-26
- 27.3.1 — 2026-08-26
- 27.3.0 — 2026-08-24
- 27.1.2 — 2026-08-18
- 27.1.1 — 2026-08-07
- … 288 more at https://npm.io/package/netlify/versions

## README

![Netlify CLI](cli.png)

[![Coverage Status](https://codecov.io/gh/netlify/cli/branch/main/graph/badge.svg)](https://codecov.io/gh/netlify/cli)
[![npm version][npm-img]][npm] [![downloads][dl-img]][dl] [![netlify-status][netlify-img]][netlify]
[![security][snyk-img]][snyk]

Interact with [Netlify](http://netlify.com/) from the comfort of your CLI.

See the [CLI command line reference](https://cli.netlify.com/#commands) to get started and the docs on using
[Netlify Dev](https://github.com/netlify/cli/blob/main/docs/commands/dev.md) to run your site locally.

## Table of Contents

<!-- AUTO-GENERATED-CONTENT:START (TOC:collapse=true&collapseText=Click to expand) -->
<details>
<summary>Click to expand</summary>

- [Installation](#installation)
- [Usage](#usage)
- [Documentation](#documentation)
- [Commands](#commands)
  - [api](#api)
  - [blobs](#blobs)
  - [build](#build)
  - [completion](#completion)
  - [deploy](#deploy)
  - [dev](#dev)
  - [env](#env)
  - [functions](#functions)
  - [init](#init)
  - [integration](#integration)
  - [link](#link)
  - [login](#login)
  - [open](#open)
  - [recipes](#recipes)
  - [serve](#serve)
  - [sites](#sites)
  - [status](#status)
  - [switch](#switch)
  - [unlink](#unlink)
  - [watch](#watch)
- [Contributing](#contributing)
- [Development](#development)
- [License](#license)

</details>
<!-- AUTO-GENERATED-CONTENT:END -->

## Installation

Netlify CLI requires [Node.js](https://nodejs.org) version 22.13.0 or above. To install, run the following command from
any directory in your terminal:

```bash
npm install netlify-cli -g
```

When using the CLI in a CI environment we recommend installing it locally as a development dependency, instead of
globally. To install locally, run the following command from the root directory of your project:

```bash
npm install --save-dev netlify-cli
```

**Important:** Running `npm install netlify-cli -g` in CI means you're always installing the latest version of the CLI,
including **breaking changes**. When you install locally and use a
[lock file](https://docs.npmjs.com/cli/v7/commands/npm-ci) you guarantee reproducible builds. To manage CLI updates we
recommend using an automated tool like [renovate](https://github.com/renovatebot/renovate) or
[dependabot](https://github.com/dependabot).

Alternatively you may also use Homebrew: `brew install netlify-cli` (thanks
[@cglong](https://github.com/netlify/cli/issues/291)).

## Usage

Installing the CLI globally provides access to the `netlify` command.

```sh-session
netlify [command]

# Run `help` for detailed information about CLI commands
netlify [command] help
```

## Documentation

To learn how to log in to Netlify and start deploying projects, visit the
[documentation on Netlify](https://docs.netlify.com/cli/get-started/).

## Commands

For a full command reference visit [cli.netlify.com](https://cli.netlify.com/).

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for more info on how to make contributions to this project.

## Development

You'll need to follow these steps to run Netlify CLI locally:

    uninstall any globally installed versions of netlify-cli
    clone and install deps for https://github.com/netlify/cli
    npm link from inside the cli folder

Now you're both ready to start testing and to contribute to the project!

## License

MIT. See [LICENSE](LICENSE) for more details.

[npm-img]: https://img.shields.io/npm/v/netlify-cli.svg
[npm]: https://npmjs.org/package/netlify-cli
[av-img]: https://ci.appveyor.com/api/projects/status/imk2qjc34ly7x11b/branch/master?svg=true
[av]: https://ci.appveyor.com/project/netlify/cli
[dl-img]: https://img.shields.io/npm/dm/netlify-cli.svg
[dl]: https://npmjs.org/package/netlify-cli
[david-img]: https://david-dm.org/netlify/cli/status.svg
[david]: https://david-dm.org/netlify/cli
[snyk-img]: https://snyk.io/test/npm/netlify-cli/badge.svg
[snyk]: https://snyk.io/test/npm/netlify-cli
[netlify-img]: https://api.netlify.com/api/v1/badges/d3807379-2dcf-4a43-9c00-e7e8d90ecf70/deploy-status
[netlify]: https://app.netlify.com/projects/cli/deploys

---
_Source: https://npm.io/package/netlify · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._