Docs

Installing PipeLogic CLI on Windows (via WSL)

PipeLogic CLI (ppl) requires a Linux-based environment. Since Windows doesn't natively support Bash scripts, you’ll need to use WSL (Windows Subsystem for Linux) to run the installer successfully.

This guide walks you through setting up WSL and installing the CLI on a Windows machine.

Important Notes Before Proceeding

🔹 Disable VPN Temporarily

If you're using a VPN, turn it off before installing PipeLogic CLI.
Active VPNs can block WSL's internet access, which may cause download failures during the CLI installation.
You can re-enable the VPN after installation is complete.

🔹 Ensure Virtualization is Enabled (Required for WSL2)

To check virtualization status:

  1. Open Task Manager → Go to the Performance tab → Click CPU.
  2. Look for Virtualization at the bottom-right.
    • If it says Enabled → You’re good to go.
    • If it says Disabled → Follow the BIOS steps below.

To enable virtualization in BIOS:

  1. Restart your PC.
  2. During startup, press the BIOS/Setup key:
    • Note: The BIOS key depends on your laptop brand/model. For example:
    • Lenovo → F1 or F2 , Some models might use Fn + F2
    • Dell → F2
    • ASUS → DEL or F2
  3. In the BIOS menu, find Virtualization Technology, VT-x, or AMD-V and set it to Enabled.
  4. Save changes and exit BIOS.
  5. After reboot, confirm it’s enabled in Task Manager.

📺 Need help? Here's a video tutorial showing how to enable virtualization in BIOS:
🔗 Watch Video – How to Enable Virtualization in Lenovo BIOS

If you're using a different brand, BIOS layout may vary but the overall process is similar.

✅ Step-by-Step Instructions

1. Install WSL with Ubuntu

  1. Open PowerShell as Administrator.

  2. Run the following command to install WSL and Ubuntu:

    wsl --install

  3. Restart your computer when prompted.

  4. After reboot, Ubuntu will finish installing. Choose a username and password when prompted.

2. Open Ubuntu and Update System Packages

  1. Launch the Ubuntu app from the Start menu.

  2. Update system packages by running:

    sudo apt update && sudo apt upgrade -y

3. Install the PipeLogic CLI

  1. In the same Ubuntu terminal, run the installation script:

    curl -fsSL https://app.pipelogic.ai/api/v1/install | bash

  2. After installation, add the CLI binary to your PATH:

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

  3. (Optional) To make the path permanent, run:

    echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

4. Verify the Installation

Check that the CLI is installed by running:

ppl

If installed correctly, you’ll see a welcome message along with a list of available commands. Example output:

Pipelogic CLI helps you build, deploy, and manage real-time data pipelines and AI components.

Usage:
  ppl [command]

Common Commands:
  release     Create a new component release
  init        Initialize a component codebase
  capsules    List all available capsules
  compile     Compile component code without releasing

5. Start Using the CLI

Now you can use the PipeLogic CLI normally:

ppl login
ppl capsules
ppl init

💡 Notes

  • The install command does not work in Windows CMD or PowerShell — it must be run inside Ubuntu (or any WSL-based Linux terminal).
  • If you see a command not found: ppl error, ensure your $HOME/bin directory is included in your PATH.

Was this page helpful?