Configure and observe projects

Configure projects

zenifra project info --project <project-id>
zenifra project url --project <project-id>
zenifra project stop --project <project-id>
zenifra project resume --project <project-id>
zenifra project delete --project <project-id> --yes

Environment variables (values masked by default, including in --json):

zenifra project envs --project <project-id>
zenifra project env add --project <project-id> --name NODE_ENV --value production
zenifra project env update --project <project-id> --name NODE_ENV --value staging
zenifra project env remove --project <project-id> --name NODE_ENV

Use --show-values on envs only when necessary and safe.

Exposure, instances, and auto-scaling (HTTP projects):

zenifra project exposure set --project <project-id> --exposure private
zenifra project instances set --project <project-id> --count 3
zenifra project autoscaling set --project <project-id> --min 2 --max 8 --cpu 70 --memory 80
zenifra project autoscaling disable --project <project-id>

private removes the public route, the Zenifra subdomain, and custom domains; public restores them. With auto-scaling enabled, adjust the range through the autoscaling command: manual instance changes are blocked until you disable it.

Health check:

zenifra project healthcheck get --project <project-id>
zenifra project healthcheck set --project <project-id> --path /health
zenifra project healthcheck disable --project <project-id>

Observe projects

zenifra projects --type http --page 1 --limit 15
zenifra project logs --project <project-id> --instance <instance-id>
zenifra project metrics --project <project-id> --instance <instance-id>
zenifra project metrics capabilities --project <project-id>
zenifra project network --project <project-id> --view summary
zenifra project healthcheck failures --project <project-id>
zenifra project autoscaling events --project <project-id> --direction scale_up
zenifra project billing usage --project <project-id> --from 2026-06-01T00:00:00Z --limit 20
  • zenifra projects paginates at 15 items per page; adjust with --page and --limit.
  • project metrics capabilities reports the access level and available metric groups before you fetch a snapshot; missing values appear as indisponivel.
  • project network --view accepts summary, status-codes, routes, user-agents, request-events, and source-ips. request-events and source-ips show visitors' source IP and user agent and require project.network.visitors.read on the project; the other views require project.metrics.read.
  • autoscaling events accepts --direction scale_up|scale_down, --from, and --to; billing usage accepts --from and --to in ISO format.

Last updated on

Deploy from an image and Git

Publish new versions with the Zenifra CLI from an image or a Git source and follow builds and logs.

Deploy and automation (CI/CD)

Use the Zenifra CLI with user login or a global API key to list projects and trigger deploys.

On this page

Configure and observe projectsConfigure projectsObserve projects