App Platform

The App Platform is Uncloud’s PaaS layer — deploy applications from container images or git repositories with automatic SSL, custom domains, scaling, and rollback support.

How Apps Work

When you deploy an app, Uncloud creates the following Kubernetes resources:

Deployment — Manages your application pods
Service — Internal networking and load balancing
Ingress — External access with TLS termination
ConfigMap — Environment variables
Secret — Sensitive environment variables

Source Types

Source	Description
`image`	Deploy from a Docker image (e.g., `nginx:latest`)
`git`	Build and deploy from a git repository
`upload`	Upload a tarball of your source code

App Lifecycle

Deployment Flow

Image-Based Deployment

POST /api/v1/apps
{
  "name": "my-api",
  "source_type": "image",
  "image_url": "myregistry.com/my-api:v1.2",
  "port": 3000,
  "replicas": 2
}

Uncloud creates a Kubernetes Deployment with the specified image
A Service and Ingress are created for routing
The app becomes accessible at my-api.yourdomain.com

Git-Based Deployment

POST /api/v1/apps
{
  "name": "my-frontend",
  "source_type": "git",
  "repo_url": "https://github.com/user/repo.git",
  "repo_branch": "main",
  "build_command": "npm run build",
  "port": 3000
}

Features

Custom Domains

Attach one or more custom domains to any app. Uncloud configures Ingress rules and can provision TLS certificates via cert-manager.

Environment Variables & Secrets

Env vars — Stored in ConfigMaps, visible in the dashboard
Secrets — Stored in Kubernetes Secrets, masked in the UI

Scaling

Set the number of replicas for horizontal scaling:

PATCH /api/v1/apps/{id}
{ "replicas": 5 }

Deployment History & Rollback

Every deployment is recorded. Roll back to any previous deployment:

POST /api/v1/apps/{id}/deployments/{deploymentId}/revert

Build Logs & App Logs

Build logs — Output from the build process (git/upload sources)
App logs — Live tail of application stdout/stderr from running pods

Metrics

Monitor CPU, memory, disk, and network usage per app via the metrics API.

Audit Log

Every action (deploy, config change, domain add) is recorded in the audit log for compliance and debugging.

Marketplace Templates

Deploy pre-configured applications with one click:

Template	Category	Description
WordPress	CMS	Full WordPress with MySQL
Ghost	CMS	Modern publishing platform
Strapi	CMS	Headless CMS
Grafana	Monitoring	Metrics visualization
Redis	Cache	In-memory data store
RabbitMQ	Queue	Message broker

Kubernetes Mapping

App Concept	Kubernetes Resource
App	`Deployment`
Networking	`Service` + `Ingress`
Env vars	`ConfigMap`
Secrets	`Secret`
Custom domain	`Ingress` rule + TLS cert
Build	`Job` (build pod)

Getting Started

Core Concepts

How Apps Work

Source Types

App Lifecycle

Deployment Flow

Image-Based Deployment

Git-Based Deployment

Features

Custom Domains

Environment Variables & Secrets

Scaling

Deployment History & Rollback

Build Logs & App Logs

Metrics

Audit Log

Marketplace Templates

Kubernetes Mapping

​How Apps Work

​Source Types

​App Lifecycle

​Deployment Flow

​Image-Based Deployment

​Git-Based Deployment

​Features

​Custom Domains

​Environment Variables & Secrets

​Scaling

​Deployment History & Rollback

​Build Logs & App Logs

​Metrics

​Audit Log

​Marketplace Templates

​Kubernetes Mapping

How Apps Work

Source Types

App Lifecycle

Deployment Flow

Image-Based Deployment

Git-Based Deployment

Features

Custom Domains

Environment Variables & Secrets

Scaling

Deployment History & Rollback

Build Logs & App Logs

Metrics

Audit Log

Marketplace Templates

Kubernetes Mapping