Deploying an App
This guide walks you through deploying an application from the portal.
Prerequisites
- A NextEpoch Cloud workspace
- An application in the catalog (pushed via Docker or from the Store)
Step 1: Open the App Detail
- Navigate to Apps > Catalog
- Click the app you want to deploy
- Select a version from the versions list on the right
Step 2: Open the Deploy Dialog
Click the Deploy button. This opens a dialog with several configuration sections.
Step 3: Configure Basics
- Name — A display name for this deployment
- Slug — A URL-friendly identifier. Must match
[a-z0-9][a-z0-9-]*[a-z0-9]. This becomes part of the hostname:{slug}.{org}.apps.nextepoch.cloud - Port — The port your container listens on (default:
8080, range: 1–65535) - Replicas — Number of container instances (default:
1, max:10)
Step 4: Choose Resources
Select 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 set exact CPU and memory requests and limits.
WARNING
If total resources across all replicas exceed node capacity (4000m CPU or 8192Mi memory), the deployment cannot be created. A warning appears if total resources exceed 2000m CPU or 4096Mi memory with multiple replicas.
Step 5: Persistent Storage
Set a storage size (e.g., 1Gi, 10Gi, 100Gi). Storage is mounted at /data inside your container.
WARNING
Storage size is set at creation and cannot be changed later.
Step 6: Access Control
Choose an auth mode:
| Mode | Description |
|---|---|
| Public | Anyone can access the deployment |
| Browser (SSO) | Users authenticate via SSO. A session cookie is set automatically. |
| Token (Bearer) | API clients must provide a Bearer token. Returns 401 on failure. |
When using Browser or Token mode, you can set a minimum role to restrict access:
- Any authenticated user (default)
- Viewer
- User
- Contributor
- Admin
- Owner
Step 7: Environment Variables
Add key-value pairs for environment variables your app needs. Click Add for each variable and fill in the key and value.
Step 8: Deploy
Click Deploy to create the deployment. Your app will appear in the Deployed tab.
TIP
You can also deploy programmatically via the Identity API using POST /api/v1/deployments.
Next Steps
- Manage your deployment — Scale, update, and monitor
- Send telemetry from your app to see data in Insights