New — Iris AI drafts your firewall, routing & rate-limit rules. Explore AI features →
Changelog
CLI & MCPApps

From the CLI: deploy hooks, variables per environment and Git settings

Create and rotate deploy hooks, set variables for production or previews, change a Git app's push settings and cancel a build, all from the ngris CLI.

From the CLI: deploy hooks, variables per environment and Git settings

Deploy hooks, a Git app's push settings and per-environment variables already worked in the dashboard. Scripts and terminals had to go there for them.

Now the CLI does them too. Above, Maya gives the docs site a deploy hook for the team's CMS. Its URL is shown once, so she stores it in the CMS's secret settings right away.

ngris env list: NODE_ENV for all, LOG_LEVEL info for production and debug for preview, and two secrets
The shop API's variables: LOG_LEVEL is info in production and debug in previews. Secret values are never shown, and DATABASE_URL comes from the database connected to the app.
ngris apps git: production branch main, auto-deploy on, build only on changes to docs/** and mkdocs.yml, previews on
The docs site builds only when the docs change, and skips drafts.

What changed

  • Deploy hooks. ngris apps hooks lists an app's hooks with their last call and result. apps hooks add creates one and shows its URL once, apps hooks rotate gives it a new URL, and apps hooks rm deletes it. For a Git app, --branch picks the branch a hook builds.
  • Variables per environment. ngris env set, env rm, env pull and env list take --env production|preview|all. env list shows each variable's environment and source, with secret values hidden. env pull shows what a production deploy gets.
  • Git push settings. ngris apps git shows a Git app's production branch, auto-deploy, path filters, commit statuses and pull request previews. Change them with --include-paths, --ignore-paths, --commit-status on|off and --pr-previews on|off.
  • Cancel a build. ngris apps cancel <deploy id> cancels a queued or building deploy. What's live doesn't change.
  • Skipped pushes. ngris apps deploys lists canceled deploys, and the pushes that built nothing.
  • Build settings. ngris apps create and apps settings take --install-command, --build-command, --output-dir and --start-command.
  • Client certificates for your devices. ngris client-cert request makes a device's key on the device and gets its certificate; client-cert list and client-cert revoke manage them.

Get started

  1. Update ngris to 0.5.0, and save your API key once with ngris auth --api-key.
  2. Run ngris apps hooks add --name <name> --app <uuid> and store the URL it shows.
  3. Run ngris env list --app <uuid> and ngris apps git --app <uuid> to see what an app has.
  4. Read the docs: App commands and Applications.

Read the docs

Ask an AI to summarise this page
Deploy
App hosting Edge functions Domains & certificates
Connect
Secure tunnels API gateway Multi-region edge
Protect
Bot protection & challenge WAF & firewall Edge login
Observe & AI
Monitoring Inspector & replay Iris AI MCP server AI Gateway
Developers
Developer tools Docs ngrok policy converter Blog Changelog
Compare
Ngris vs ngrok Ngris vs Cloudflare Tunnel Ngris vs Vercel Ngris vs Netlify Expose localhost guide
More
Solutions Pricing Enterprise Sign in Get Started Free