ps
ps
List app processes
Usage
convox ps
Flags
| Flag | Short | Description |
|---|---|---|
--release |
Filter by release | |
--service |
-s |
Filter by service |
Examples
$ convox ps
ID SERVICE STATUS RELEASE STARTED COMMAND
62942430327e web running RCRLBREFPBX 1 week ago
When the app's budget cap has been breached (3.24.6+), convox ps adds a
BUDGET column showing the per-process sub-state. Possible values:
| Value | Meaning |
|---|---|
armed-Nm |
Auto-shutdown is armed; N minutes remain in the notify-before window. |
at-cap-keda |
Process belongs to a KEDA-managed Service that has been paused via autoscaling.keda.sh/paused-replicas. |
at-cap-auto |
Process belongs to a deployment-only Service that has been scaled to 0 by auto-shutdown. |
at-cap |
Process belongs to a Service whose deploys have been blocked (cap action block-new-deploys); existing replicas continue to run. |
The column is omitted when the cap is not tripped to keep healthy-state output table-width-stable. See Budget Caps for the full sub-state lifecycle and recovery flow.
ps info
Get information about a process
Usage
convox ps info <pid>
Examples
$ convox ps info 62942430327e
Id 62942430327e
App nodejs
Command
Instance i-0cbaa6d2dd1d094c0
Release RCRLBREFPBX
Service web
Started 1 week ago
Status running
ps stop
Stop a process
Usage
convox ps stop <pid>
Examples
$ convox ps stop 62942430327e
Stopping 62942430327e... OK