Skip to main content
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]
FlagDescriptionDefault
--repoRepository URL (required)
--branchBranch to deploy frommain
--auth-tokenAuth token for private reposNone
--build-cmdCustom build commandAuto-detected
--deployTrigger first deploy immediatelyfalse
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]
FlagDescription
-fSkip 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]
FlagDescriptionDefault
-w, --waitWait for deploy to finishfalse
--timeoutMax wait duration300s
# 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]
FlagDescriptionDefault
-nNumber of deployments to show10
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]
FlagDescription
-fSkip confirmation prompt
-w, --waitWait 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