Your First Deployment

This guide walks you through deploying an application from the portal, end to end.

Prerequisites

• A NextEpoch Cloud workspace
• At least one app in the catalog (pushed via Docker or available from the Store)

Step 1: Open the App Catalog

1. Click Apps in the sidebar
2. Switch to the Catalog tab
3. Use the filters to find your app:
   • All — Every app visible to your organization
   • My Apps — Apps owned by your organization
   • Store — Curated apps from the NextEpoch Store
   • Docker Images — Container images you can deploy
   • Executables — Downloadable binaries

You can also search by name, description, or tags.

Step 2: Select an App

Click an app card to open its detail page. Here you'll see:

• Name, description, and tags
• Available versions with size and creation date
• Source and category badges

Select the version you want to deploy from the versions list on the right.

Step 3: Configure the Deployment

Click Deploy to open the deployment dialog. Fill in the following:

Basics

• Name — A display name for this deployment
• Slug — A URL-friendly identifier used in the hostname (e.g., my-app becomes my-app.your-org.apps.nextepoch.cloud)
• Port — The port your container listens on (default: 8080)
• Replicas — Number of instances to run (default: 1, max: 10)

Resources

Choose a resource preset or define custom values:

Preset	CPU Request	Memory Request	CPU Limit	Memory Limit
Starter	100m	128Mi	250m	256Mi
Standard	500m	512Mi	1000m	1Gi
Performance	1000m	1Gi	2000m	2Gi
Heavy	2000m	4Gi	4000m	8Gi

Select Custom to specify exact CPU and memory values.

WARNING

If total resources across all replicas exceed node capacity (4000m CPU or 8Gi memory), the deployment will not be created.

Persistent Storage

Set the storage size (e.g., 1Gi, 10Gi). Storage is mounted at /data inside your container. The size is set at creation and cannot be changed later.

Access Control

• Public — Anyone can access the deployment
• Browser (SSO) — Users authenticate via SSO with a session cookie
• Token (Bearer) — API clients must provide a Bearer token

When using SSO or Token mode, you can optionally set a minimum role requirement (Viewer, User, Contributor, Admin, or Owner).

Environment Variables

Add key-value pairs for environment variables your app needs. Click Add for each variable.

Step 4: Deploy

Click Deploy. The portal provisions your application and shows it in the Deployed tab.

Step 5: Verify

Check the deployment status in the Deployed tab:

• Running — Your app is live and healthy
• Deploying — The app is starting up
• Pending — Waiting for resources
• Stopped — Manually stopped
• Failed — Something went wrong (check logs)

Click the external link icon next to your deployment to open it in a new tab.

Next Steps

• Manage your deployment — Update config, view logs, scale replicas
• Send telemetry from your app to see data in Insights
• Explore Insights to monitor your application