About Netlify CLI
Netlify CLI enables developers to manage deployments, environment variables, and site configuration from the terminal. Running netlify dev starts a local development server that mimics Netlify's environment, netlify deploy --prod pushes to production, and developers can manage environment variables and site addons.
Key features
- 01Start a local development server that simulates Netlify's environment
- 02Generate preview deployments for testing and feedback
- 03Configure and manage environment variables, functions, and addons
Use cases
- 01Develop websites locally with Netlify features like functions and redirects
- 02Create preview deployments to share with teams for feedback
- 03Manage environment variables and deployment configuration
Install
Pick your OS or package manager and run the command in a terminal.
Once installed, runnetlify --versionto confirm it works.
Example commands
Common commands in the order you’d use them.
Details
From the project README
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
Netlify CLI requires Node.js version 22.13.0 or above. To install, run the following command from any directory in your terminal:
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:
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.
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.