Install the Twilio CLI
The Twilio CLI is supported on macOS, Windows, Linux, and even as aDocker image. Follow the directions for your respective operating system to install the CLI and enhance your developer experience with Twilio.
For information on the latest releases of the CLI, refer to thereleases list on GitHub.
Info
Starting with Twilio CLI version 6.0.0, only Node.js version 20 or later is supported. If you are using an older version of Node.js, please upgrade to Node.js version 20 or later.For more information, seeTwilio CLI Node.js 18 version deprecation.
Danger
We strongly discourage installing the Twilio CLI using a combination of methods. For example, installing the CLI using both Homebrew and npm can cause conflicts in yourPATH that may result in unexpected behavior from commands and/or difficulty updating.
The suggested way to install the Twilio CLI on macOS is to useHomebrew. If you don't already have it installed,visit the Homebrew site for installation instructions and then return here.
Once you have installed Homebrew, run the following command to install the CLI:
brewtap twilio/brew&&brewinstall twilio
The suggested way to install the Twilio CLI on Windows is by usingScoop. If you don't already have it installed,visit the Scoop site for installation instructions and then return here.
Info
PowerShell will need to berun as an administrator to avoid possible permission issues when installing via Scoop
Once you have verified your Scoop installation, do the following:
Add the
twilio-cli
Bucket:scoopbucket add twilio-scoop https://github.com/twilio/scoop-twilio-cliInstall the app:
scoopinstall twilio
The Twilio CLI can be installed using the Advanced Package Tool (apt) on most distributions such as Debian, Ubuntu, Linux Mint, and more.
To install with apt, run the following commands in your terminal:
1wget-qO-https://twilio-cli-prod.s3.amazonaws.com/twilio_pub.asc\2|sudoapt-key add -3sudotouch /etc/apt/sources.list.d/twilio.list4echo'deb https://twilio-cli-prod.s3.amazonaws.com/apt/ /'\5|sudotee /etc/apt/sources.list.d/twilio.list6sudoapt update7sudoapt install-ytwilio
As an alternative, you may also install the Twilio CLI using apt and a local .deb file:
In your browser, download thelatest .deb file.
Install the downloaded package using apt:
aptinstall /path/to/file.deb
The Twilio CLI can also be installed using package managers for Red Hat-based Linux distributions, primarilyyum and dnf
In your browser, download thelatest RPM package.
Install the downloaded package using the package manager of your choice, for example:
1yuminstall /path/to/package.rpm2# or3dnfinstall /path/to/package.rpm4
Another way to install the Twilio CLI is by using the standard macOS user interface and your browser:
- In your browser, download thelatest macOS installation file.
- Run the downloaded file and follow the on-screen instructions.
Warning
If macOS prevents the installation of the .pkg file, followthese steps to successfully open the file and install.
Another way to install the Twilio CLI is by using the standard Windows user interface and your browser:
- In your browser, download thelatest Windows installation file.
- Run the downloaded file and follow the on-screen instructions.
Danger
It's strongly recommended to use one of the other installation methods if possible.
This installation method does not auto-update, and it uses your system's version of Node.js, which may be older than the version Twilio develops the CLI against.
The Twilio CLI is also installable via npm. This is a manual install method that can be used in environments where auto-updating is not ideal, or where we do not offer a prebuilt binary, and requires thatNode.js and npm be installed already on your machine. (npm is installed along with Node.js)
To globally install the CLI so that it can be used from any directory, use:
npminstall-gtwilio-cli
To verify your Twilio CLI installation, open a command prompt window and use:
twilioversion
The output will be similar to the following:
twilio-cli/6.0.1linux-x64 node-v20.19.3
You should seetwilio-cli/x.y.z
in the output wherex.y.z
is a version number, such as5.0.0
. If you don't, but you have installed the CLI, you may need to restart the command prompt window.
You may also use the following, which are equivalent totwilio version
:
twilio--version
twilio-v
Now that you've installed the Twilio CLI, you should set upautocomplete, then log in with your Twilio account and create aCLI Profile.
Once you're logged in, you're ready to learn more about how to use the Twilio CLI, and you can begin exploring CLI commands!