Getting Started

Getting Started with Acquia Pipelines CLI

Use when:

• Installing the Pipelines CLI for the first time
• Configuring API credentials
• Verifying your connection to Acquia Cloud
• Updating the CLI to the latest version

Tool Overview

Two separate CLIs exist for Acquia Cloud operations:

| Tool | Purpose | |---|---| | pipelines-cli | CI/CD pipeline operations: trigger builds, check job status, stream logs | | acli | General Cloud management: applications, environments, IDEs, SSH keys, code/DB sync |

Use pipelines-cli for pipeline jobs. Use acli for everything else.

---

Installation

Download the binary

wget https://cloud.acquia.com/pipelines-client/download -O pipelines
chmod +x pipelines
sudo mv pipelines /usr/local/bin

Verify installation

pipelines --version
pipelines help

---

Authentication

Configure credentials interactively

pipelines configure

You will be prompted for your Acquia Cloud API key and API secret:

Please enter your Acquia Cloud API key: 
Please enter your Acquia Cloud API secret: 
Configuration successful.

Configure credentials non-interactively

Useful for CI/CD environments where interactive prompts are not available:

pipelines configure --key=YOUR_KEY --secret=YOUR_SECRET

Configure with a custom endpoint

Only needed if you are not using the default Acquia Cloud endpoint:

pipelines configure --key=YOUR_KEY --secret=YOUR_SECRET --endpoint=https://your-custom-endpoint.com

Reset credentials

If your credentials change or you need to reconfigure:

pipelines reset-credentials

Then run pipelines configure again.

---

Verify Your Connection

After configuring, confirm your environment is set up correctly:

pipelines show-connection 

Output confirms whether the connection and application access are working.

To find your application ID first:

pipelines list-applications

---

Common First Steps

Step 1: Install

wget https://cloud.acquia.com/pipelines-client/download -O pipelines
chmod +x pipelines
sudo mv pipelines /usr/local/bin

Step 2: Configure credentials

pipelines configure

Step 3: Find your application

pipelines list-applications

Step 4: Verify connection

pipelines show-connection 

Step 5: Start your first pipeline

pipelines start --application-id=

---

Keeping the CLI Updated

pipelines self-update

Run this periodically to get bug fixes and new features.

---

Getting Help

# List all available commands
pipelines

# Help for a specific command
pipelines help start
pipelines help configure

# Version (include in bug reports)
pipelines --version

---

Troubleshooting

"command not found: pipelines"

The binary is not in your PATH. Ensure you moved it to /usr/local/bin or another directory on your PATH:

which pipelines
export PATH="/usr/local/bin:$PATH"

"Configuration failed. Please check your credentials and try again."

Your API key or secret is incorrect. Verify them in the Acquia Cloud UI under API Keys, then re-run:

pipelines configure

"Non-interactive mode can only be used when key and secret are provided as cli options."

When using --no-interaction, you must pass both --key and --secret:

pipelines configure --no-interaction --key=YOUR_KEY --secret=YOUR_SECRET

---

Next Steps

• [Manage applications](../application-management/SKILL.md) — Find application IDs, link repos
• [Run pipeline jobs](../pipeline-operations/SKILL.md) — Start, monitor, and manage builds

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: acquia
• Source: acquia/acquia-skills-private
• License: MIT

Install and usage instructions live in the source repository linked above.