Get started with the Algolia CLI

Manage your Algolia resources directly from the command line.

The Algolia CLI (command-line interface) lets you work with Algolia’s APIs from the comfort of your terminal. It’s great for interactive commands, scripts, and continuous integration workflows.

Before you begin

To interact with your Algolia resources, you’ll need a (free) Algolia account.

Install the Algolia CLI

You can install the CLI with your favorite package manager, or download binaries from the Releases page in the GitHub repository.

The CLI runs on macOS, Linux, and Windows, on both AMD64 and ARM64 platforms.

macOS

The Algolia CLI is available on Homebrew. To install it, run:

Command line

brew install algolia/algolia-cli/algolia

Or go to the Releases page and download the latest archive for your Mac: algolia_*_macOS_*.tar.gz. Unpack it by running tar xf algolia_*_macOS_*.tar.gz.

Linux

The Algolia CLI is available as DEB and RPM package. Go to the Releases page and download the appropriate *.deb and *.rpm file for your platform. To install it, run:

Command line

# DEB-based distributions
sudo dpkg -i /path/to/algolia_*.deb
# RPM-based distributions
sudo rpm -i /path/to/algolia_*.rpm

Or go to the Releases page and download the latest archive for Linux: algolia_*_linux_*.tar.gz. Unpack it by running tar xf algolia_*_linux_*.tar.gz.

Windows

The Algolia CLI is available for the Chocolatey package manager. To install it, run:

choco install algolia

Or go to the Releases page and download the latest archive: algolia_*_windows_*.zip and unpack it. If you’re using the Windows Subsystem for Linux (WSL), follow the instructions for Linux.

Run your first command

Explore the CLI by typing algolia. This lists the available commands. Add --help to any command to get more information about the command and its available options.

For example, to list all indices in your Algolia application, run:

Command line

algolia indices list \
  --application-id ALGOLIA_APPLICATION_ID \
  --api-key ALGOLIA_API_KEY

Since this command makes a request to the Algolia Search API, you need to provide your Algolia credentials. You can find your application ID and API key in the Algolia dashboard.

To avoid entering your credentials every time, you can add profiles for each of your Algolia applications. For more information, see Authentication.

Next steps

• Set up command completion. Enable shell completion for Bash, Zsh, Fish, or PowerShell.
• Authenticate CLI commands. Use environment variables, command-line flags, or profiles for your credentials.
• Use the CLI in automation. Tips for running the CLI in scripts, CI, and agent workflows with structured output, exit codes, and dry runs.
• Opt out of telemetry collection. Learn what the CLI reports and how to turn off telemetry and update checks.
• Usage examples for the Algolia CLI. Follow recipes for importing, exporting, comparing, and copying Algolia data.