Git - InstaPods

The git commands let you connect a repository, trigger deploys, view build logs, and roll back — all without leaving the terminal.

Connect a Repository

instapods git connect NAME --repo URL [flags]

Flag	Description	Default
`--repo`	Repository URL (required)	—
`--branch`	Branch to deploy from	`main`
`--auth-token`	Auth token for private repos	None
`--build-cmd`	Custom build command	Auto-detected
`--deploy`	Trigger first deploy immediately	`false`

Examples:

# Public GitHub repo
instapods git connect my-app --repo https://github.com/you/repo --deploy

# Private repo with token, custom branch
instapods git connect my-app \
  --repo https://github.com/you/private-repo \
  --auth-token ghp_abc123 \
  --branch develop

# Custom build command
instapods git connect my-app \
  --repo https://github.com/you/repo \
  --build-cmd "npm ci && npm run build" \
  --deploy

Disconnect

instapods git disconnect NAME [-f]

Flag	Description
`-f`	Skip confirmation prompt

Removes the git connection and webhook. Deployed code stays in the pod.

Status

instapods git status NAME

Shows the connected repository, branch, auto-deploy setting, and latest deployment status.

Trigger a Deploy

instapods git deploy NAME [-w] [--timeout DURATION]

Flag	Description	Default
`-w, --wait`	Wait for deploy to finish	`false`
`--timeout`	Max wait duration	`300s`

# Fire and forget
instapods git deploy my-app

# Wait for completion
instapods git deploy my-app -w

# Wait with custom timeout
instapods git deploy my-app -w --timeout 600s

Deployment History

instapods git deployments NAME [-n COUNT]

Flag	Description	Default
`-n`	Number of deployments to show	`10`

instapods git deployments my-app
instapods git deployments my-app -n 25

Build Logs

instapods git logs NAME [DEPLOY_ID]

Without a deployment ID, shows logs from the most recent deployment.

# Latest deployment logs
instapods git logs my-app

# Specific deployment
instapods git logs my-app deploy_abc123

Rollback

instapods git rollback NAME [DEPLOY_ID] [-f] [-w]

Flag	Description
`-f`	Skip confirmation prompt
`-w, --wait`	Wait for rollback to finish

Without a deployment ID, rolls back to the previous deployment.

# Rollback to previous
instapods git rollback my-app

# Rollback to specific deployment, no prompt, wait
instapods git rollback my-app deploy_abc123 -f -w

​Connect a Repository

​Disconnect

​Status

​Trigger a Deploy

​Deployment History

​Build Logs

​Rollback