Kamui Platform Kamui Platform Docs
EN JA

Applications

Applications are the deployable units running on Kamui Platform.

Application Types

Dynamic App

Server-side applications.

Supported Language Examples
Node.js Express, Next.js, Fastify, etc.
Go Echo, Gin, standard net/http, etc.
Python Flask, FastAPI, Django, etc.

Static App

Sites consisting only of static files (HTML, CSS, JavaScript).

  • SPA (Single Page Application)
  • Static site generator output (Hugo, Gatsby, Astro, etc.)
  • Simple HTML sites

Creating an Application

Dynamic App

  1. In the project detail screen, click "New App" → "Dynamic App"
  2. Enter basic settings:
Field Description Example
App Name Name of the application api-server
Language Programming language to use Node.js / Go / Python
  1. Select deploy source:

From GitHub Repository

Field Description Example
Repository Source repository myorg/my-api
Branch Branch to deploy main
Directory Subdirectory for monorepos apps/api (empty for root)
  1. Build settings:
Field Description Example
Start Command App startup command npm start
Setup Command Install dependencies npm install
Pre-deploy Command Build command npm run build
  1. Runtime settings:
Field Description Default
Health Check Endpoint Path for health checks /health
Replicas Number of instances 1
  1. Optional settings:
  2. Environment variables

  3. Database connection

  4. Click "Create"

Static App (GitHub)

  1. Click "New App" → "Static App" → "GitHub"
  2. Enter settings:
Field Description Example
App Name Name of the application my-website
Repository Source repository myorg/website
Branch Branch to deploy main
Directory Public directory dist, build
Spec Resource size Nano / Small / Medium / Large
Replicas Number of instances 1
  1. Click "Create"

Static App (Upload)

Deploy by uploading local files directly.

  1. Click "New App" → "Static App" → "Upload"
  2. Select a directory or ZIP file
  3. Click "Create"

Note: An index.html file must exist at the root.

Deployment Flow

git push → Build starts → Image created → Deploy → Health check → Complete
  1. Pushing to GitHub automatically starts the build
  2. Setup command and pre-deploy command run in sequence
  3. Docker image is created and deployed to Kubernetes
  4. Traffic switches over after health check succeeds

Viewing Deploy Logs

  1. Open the app detail screen
  2. Click the "Deploy History" tab
  3. Select the deployment to inspect
  4. View build logs and deploy logs

Viewing Application Logs

  1. Open the app detail screen
  2. Click the "Logs" tab
  3. View real-time or historical logs

Redeploying

To manually redeploy without pushing to GitHub:

  1. Open the app detail screen
  2. Click the "Redeploy" button
  3. Rebuild and deploy with the latest commit

Setting Environment Variables

  1. Click the "Settings" tab in the app detail screen
  2. Add or edit in the "Environment Variables" section
  3. Click "Save"

Note: Changing environment variables will restart the app.

Editing an Application

  1. Click the "Settings" tab in the app detail screen
  2. Editable fields:
  3. App name
  4. Spec
  5. Replicas
  6. Environment variables
  7. Database connection
  8. Click "Save"

Deleting an Application

  1. Click the "Settings" tab in the app detail screen
  2. Click "Delete App"
  3. Enter the app name in the confirmation dialog
  4. Click "Delete"

⚠️ Warning: This action cannot be undone.

CLI Commands

# List apps
kamui apps list --project <project-name-or-id>

# Create an app (interactive)
kamui apps create

# Create an app in a specific project
kamui apps create --project my-project

# Delete an app
kamui apps delete <app-name-or-id>

# Delete without confirmation
kamui apps delete <app-name-or-id> --yes

Next Steps