KamuiDash KamuiDash Docs
EN JA

Applications

Applications are the deployable units running on KamuiDash.

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 — see each language page for specific values:
  1. Runtime settings:
Field Description Default
Health Check Endpoint Path for health checks (optional). If not set, health checks are disabled. None
Replicas Number of instances 1
  1. Optional settings:
  2. Environment variables

  3. Database connection

  4. Click "Create"

Static App

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