Netlify's CLI to manage and deploy sites on Netlify without leaving your terminal.
It uses the OpenAPI definitions to interact with Netlify's API.
Prebuilt binaries are available for Windows, OS X and Linux.
brew tap netlify/netlifyctl
brew install netlifyctlnetlifyctl can be installed from source:
$ go get github.com/tryy3/netlifyctlnetlifyctl --helpor to get details on a subcommand:
netlifyctl site update --help-
Use
netlifyctl loginto create an API token for your personal use. This command requires you to have access to a browser. Your access token will be stored in %HOME%/.config/netlify when you run the command directly. -
Use
netlifyctl sitesto display the list of sites you have access to. -
Use
netlifyctl deployto deploy changes on a site. This command must run from the root directory where you have your site's source code. The interactive guides will take your site ID and deploy path and incorporate them into that config file.
Thereafter, you can run unattended and headless using the flag -y to auto confirm the current settings: netlifyctl -y deploy.
Netlifyctl generates debug logs with all the request and response interations when there is an error running any command. Those logs are stored in a file called netlifyctl-debug.log in the directory where you ran the command. These logs include your access token for the API! Please make sure you don't share them with anyone without masking those first.
You can force the CLI to generate these logs even when there are no errors with the -D flag: netlifyctl -D deploy.
You can get an access token from https://app.netlify.com/applications. Once you've created it, you can store it in your computer. The default location where netlifyctl tries to find this token is within your home directory, inside a file called netlify within a directory called .config. The path in a Unix system looks like ~/.config/netlify. This file uses JSON formatting, you can see an example below:
{
"access_token": "my secret access token"
}You can also set this token with the flag -A in each command call if you don't want to store it in a file: netlifyctl -A "my secret access token" deploy.
Contributions are welcome via Pull Request.
Bug Reports are welcome as Issues filed on this repository, but feel free to chat with support@netlify.com about issues as well - often we'll have faster advice to help you succeed.