InfraPilot CLI

Deploy and manage services on your InfraPilot instance from the command line.

Installation

# npm
npm install -g @infrapilot/cli

# pnpm
pnpm add -g @infrapilot/cli

# Homebrew
brew tap infrapilothq/tap
brew install infrapilot

Quick start

# Connect to your InfraPilot instance
infrapilot connect --url https://infra.example.com --api-key ip_live_xxx

# List running services
infrapilot ps

# Deploy a service (prebuilt image)
infrapilot deploy my-app --image myrepo/my-app --tag v1.2.3 --env prod --wait

# Push-to-deploy: build straight from a git repo (no CI, no Dockerfile required)
infrapilot deploy my-app --git-repo https://github.com/me/my-app --git-branch main --wait

# Deploy a Docker Compose stack
cd my-project   # directory with docker-compose.yml
infrapilot stack deploy --env prod --wait

# Stream logs
infrapilot logs my-app --follow

# Roll back
infrapilot rollback my-app --env prod --wait

Commands

| Command | Description | |---|---| | connect | Connect CLI to an InfraPilot instance | | ps | List all services | | deploy <service> | Deploy a single service | | rollback <service> | Roll back to previous deployment | | logs <service> | View container logs | | stack deploy | Deploy a Docker Compose stack | | stack ls | List deployed stacks | | stack rm <id> | Remove a stack | | install | Bootstrap InfraPilot CE/EE on a server via SSH | | import | Generate a migration plan from a Heroku app (Procfile + app.json) | | ui | Full-screen interactive terminal UI (k9s-style) for your fleet |

CI/CD

# GitHub Actions example
- name: Deploy
  run: |
    npx @infrapilot/cli deploy ${{ env.SERVICE }} \
      --tag ${{ github.sha }} \
      --git-commit ${{ github.sha }} \
      --git-branch ${{ github.ref_name }} \
      --env prod \
      --wait
  env:
    INFRAPILOT_URL: ${{ secrets.INFRAPILOT_URL }}
    INFRAPILOT_API_KEY: ${{ secrets.INFRAPILOT_API_KEY }}

License

AGPL-3.0