!Netlify CLI

[![npm version][npm-img]][npm] [![downloads][dl-img]][dl] [![netlify-status][netlify-img]][netlify]
[![security][snyk-img]][snyk]

Interact with Netlify from the comfort of your CLI.

See the CLI command line reference to get started and the docs on using
Netlify Dev to run your site locally.

Table of Contents

Click to expand

- Installation
- Usage
- Documentation
- Commands
- api
- blobs
- build
- completion
- deploy
- dev
- env
- functions
- init
- integration
- link
- login
- open
- recipes
- serve
- sites
- status
- switch
- unlink
- watch
- Contributing
- Development
- License

Installation

Netlify CLI requires Node.js version 20.12.2 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 you guarantee reproducible builds. To manage CLI updates we
recommend using an automated tool like renovate or
dependabot.

Alternatively you may also use Homebrew: brew install netlify-cli (thanks
@cglong).

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.

Commands

For a full command reference visit cli.netlify.com.

Contributing

See 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 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