Skip to content

Managing Deployments

Once your app is deployed, you can manage it from the Apps > Deployed tab.

The Deployed Tab

The deployed tab shows all active deployments with:

  • Status indicator — Color-coded dot showing current state
  • Name and app ID
  • Image tag — The container image version
  • Replicas — Ready/total instance count
  • Hostname — The public URL
  • Created date

Status Indicators

StatusDescription
RunningApp is live and healthy
DeployingStarting up (animated indicator)
UpdatingRolling update in progress (animated)
PendingWaiting for resources (animated)
StoppedManually stopped
FailedError occurred
DeletingBeing removed (animated)

The page auto-refreshes every 5 seconds when deployments are in a transient state (deploying, updating, pending, deleting).

Deployment Detail

Click a deployment to open its detail page. From here you can:

Update the Image

Enter a new image tag and click Update to trigger a rolling update.

Edit Configuration

Modify these settings and click Save Changes:

  • Port and replicas
  • Resource preset (Starter, Standard, Performance, Heavy, Custom)
  • Access control — Auth mode and minimum role
  • Allowed/denied users — Restrict access to specific members
  • Environment variables — Add, edit, or remove variables

View Container Logs

Toggle the logs panel to see real-time container output. Choose the number of tail lines (100, 200, 500, or 1000) and click refresh to get the latest logs.

TIP

Container logs show real-time output from the running container.

Run Diagnostics

Open the Diagnostics tab on a deployment to inspect runtime health and recent platform events. Diagnostics are useful when a deployment is stuck in Failed, Pending, or Deploying, or when the app is live but not behaving as expected.

See Diagnostics for the full workflow.

Deployment Lifecycle

ActionEffect
StartResumes a stopped deployment
StopGracefully stops all replicas
RedeployRestarts with the current configuration
DeletePermanently removes the deployment (requires confirmation)

Troubleshooting

SymptomWhat to check
Deployment stays PendingCheck resource requests, quotas, and whether the selected image can be pulled.
Deployment enters FailedOpen logs first, then run diagnostics for platform-level context.
App URL returns 401Review access control and confirm the caller has the required role or token.
App URL returns 502/503Confirm the container listens on the configured port and has at least one ready replica.
Update does not appearVerify the image tag changed, then use Redeploy if the same tag was reused.

Next Steps

NextEpoch Cloud Documentation