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.

Deployment Lifecycle ​

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

Networking ​

  • Public: one HTTPS endpoint per deployment (https://{slug}.{org}.nextepoch.cloud and any custom domains), routed to the configured container port. HTTP/1.1, WebSockets and gRPC-Web work; plain gRPC through the public endpoint does not.
  • Inside the environment: sibling deployments reach each other by slug. HTTP services on http://{slug} (port 80) or the container port; anything else — Redis, Postgres, MQTT — on its natural port, e.g. redis://{slug}:6379. {slug}:80 also forwards to the container port (kept for compatibility with older setups).
  • Not offered: public TCP/UDP endpoints, TLS passthrough, more than one port per deployment. Use a second deployment of the same app for a second listener. Public non-HTTP access is a platform request.

Troubleshooting ​

SymptomWhat to check
Deployment stays PendingCheck resource requests, quotas, and whether the selected image can be pulled.
Deployment enters FailedOpen the deployment logs — the failure reason is almost always in the last lines.
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 ​

Shaep Documentation