Installation

CAPA can be installed on macOS, Linux, and Windows using our automated installation scripts.

macOS and Linux

curl -LsSf https://capa.infragate.ai/install.sh | sh

This will:

  • Download the latest CAPA binary
  • Install it to /usr/local/bin/capa (or ~/.local/bin/capa if you don't have sudo access)
  • Make it available in your PATH

Windows

powershell -ExecutionPolicy ByPass -c "irm https://capa.infragate.ai/install.ps1 | iex"

This will:

  • Download the latest CAPA binary
  • Install it to %USERPROFILE%\.capa\bin\capa.exe
  • Add it to your PATH

Verify Installation

After installation, verify that CAPA is installed correctly:

capa --version

You should see the version number of the installed CAPA binary.

System Requirements

  • Operating System: macOS 10.15+, Linux (Ubuntu 20.04+, Debian 10+, etc.), Windows 10+
  • Node.js: Required if you plan to use MCP servers from npm (most common use case)
  • Disk Space: ~50MB for CAPA itself, plus space for MCP servers and tools

Troubleshooting

Command Not Found

If you get "command not found" after installation, you may need to restart your terminal or add the installation directory to your PATH manually.

macOS/Linux:

export PATH="$HOME/.local/bin:$PATH"

Windows: The installer should add it automatically, but if not, add %USERPROFILE%\.capa\bin to your PATH environment variable.

Permission Denied

On macOS/Linux, if you get permission errors, try running the install script with sudo or install to a user directory instead:

curl -LsSf https://capa.infragate.ai/install.sh | sh -s -- --user

Next Steps

Now that you have CAPA installed, head over to the Quick Start guide to initialize your first project.