Skip to contentSkip to navigationSkip to topbar
Twilio Docs
Rate this page:
On this page

Install the Twilio CLI

The Twilio CLI is supported on macOS, Windows, Linux, and even as a Docker 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 the releases list(link takes you to an external page) on GitHub.

(warning)

Warning

Currently, only Node.js 18 is supported. Please upgrade if you are using an older version of Node.js.

(error)

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 your PATH(link takes you to an external page) that may result in unexpected behavior from commands and/or difficulty updating.

Homebrew

homebrew page anchor

The suggested way to install the Twilio CLI on macOS is to use Homebrew(link takes you to an external page). If you don't already have it installed, visit the Homebrew site(link takes you to an external page) for installation instructions and then return here.

Once you have installed Homebrew, run the following command to install the CLI:


_10
brew tap twilio/brew && brew install twilio

Scoop

scoop page anchor

The suggested way to install the Twilio CLI on Windows is by using Scoop(link takes you to an external page). If you don't already have it installed, visit the Scoop site(link takes you to an external page) for installation instructions and then return here.

(information)

Info

PowerShell will need to be run as an administrator(link takes you to an external page) to avoid possible permission issues when installing via Scoop

Once you have verified your Scoop installation, do the following:

  1. Add the twilio-cli Bucket(link takes you to an external page):


    _10
    scoop bucket add twilio-scoop https://github.com/twilio/scoop-twilio-cli

  2. Install the app:


    _10
    scoop install twilio

Linux

linux page anchor

apt

apt page anchor

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:


_10
wget -qO- https://twilio-cli-prod.s3.amazonaws.com/twilio_pub.asc \
_10
| sudo apt-key add -
_10
sudo touch /etc/apt/sources.list.d/twilio.list
_10
echo 'deb https://twilio-cli-prod.s3.amazonaws.com/apt/ /' \
_10
| sudo tee /etc/apt/sources.list.d/twilio.list
_10
sudo apt update
_10
sudo apt install -y twilio

deb file

deb-file page anchor

As an alternative, you may also install the Twilio CLI using apt and a local .deb file:

  1. In your browser, download the latest .deb file(link takes you to an external page) .

  2. Install the downloaded package using apt:


    _10
    apt install /path/to/file.deb

rpm file

rpm-file page anchor

The Twilio CLI can also be installed using package managers for Red Hat-based Linux distributions, primarily yum and dnf(link takes you to an external page)

  1. In your browser, download the latest RPM package(link takes you to an external page) .

  2. Install the downloaded package using the package manager of your choice, for example:


    _10
    yum install /path/to/package.rpm
    _10
    # or
    _10
    dnf install /path/to/package.rpm

macOS

macos page anchor

Another way to install the Twilio CLI is by using the standard macOS user interface and your browser:

  1. In your browser, download the latest macOS installation file(link takes you to an external page) .
  2. Run the downloaded file and follow the on-screen instructions.
(warning)

Warning

If macOS prevents the installation of the .pkg file, follow these steps(link takes you to an external page) to successfully open the file and install.

Windows

windows page anchor

Another way to install the Twilio CLI is by using the standard Windows user interface and your browser:

  1. In your browser, download the latest Windows installation file(link takes you to an external page) .
  2. Run the downloaded file and follow the on-screen instructions.

npm

npm page anchor
(error)

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 that Node.js(link takes you to an external page) 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:


_10
npm install -g twilio-cli

Verify your installation

verify-your-installation page anchor

To verify your Twilio CLI installation, open a command prompt window and use:


_10
twilio version

The output will be similar to the following:


_10
twilio-cli/5.0.0 darwin-x64 node-v14.19.0

You should see twilio-cli/x.y.z in the output where x.y.z is a version number, such as 5.0.0. If you don't, but you have installed the CLI, you may need to restart the command prompt window.

(information)

Info

You may also use the following, which are equivalent to twilio version:


_10
twilio --version


_10
twilio -v

Next steps

next-steps page anchor

Now that you've installed the Twilio CLI, you should set up autocomplete, then log in with your Twilio account and create a CLI 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!

Rate this page: