Appearance
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 deployment hostname. - 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 your available quota, the deployment cannot be created. A warning appears when the requested resources are likely to exceed the active quota.
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.
Next Steps
- Manage your deployment — Scale, update, and monitor
- Configure access control for your deployment