Skip to main content

kernel deploy <file>

Deploy an app to Kernel from the current directory. The entrypoint file and dependency manifest must live in the project root.
FlagDescription
--version <version>Use a specific version label (default: latest).
--forceOverwrite an existing version with the same label.
--env <KEY=VALUE>, -eSet environment variables (repeatable).
--env-file <file>Load environment variables from a file (repeatable).
package.json (JS/TS) or pyproject.toml (Python) must be present next to the entrypoint.

kernel deploy logs <deployment_id>

Stream build and runtime logs for a deployment.
FlagDescription
--follow, -fContinue streaming logs in real time.
--since <duration>, -sFetch logs starting from a relative duration (e.g. 5m, 1h, 1h30m) or timestamp (2006-01-02T15:04).
--with-timestamps, -tPrefix each line with an RFC3339 timestamp.
Log lines longer than 64 KiB are truncated. Emit bulky payloads to external storage and log references.

kernel deploy history [app_name]

Show deployment history for all apps or a specific app.
FlagDescription
--limit <n>Maximum number of deployments to return (default: 100, 0 = all).

kernel invoke <app> <action>

Invoke an app action. By default the CLI returns immediately after the invocation is queued.
FlagDescription
--version <version>, -vTarget a specific app version (default: latest).
--payload <json>, -pProvide a JSON payload (stringified, max 64 KB).
--sync, -sWait for completion (timeout after 60 s).
Press Ctrl+C to cancel an in-flight invocation. The associated browser sessions are cleaned up automatically.

kernel app list

List deployed app versions.
FlagDescription
--name <app_name>Filter by app name.
--version <version>Filter by version label.

kernel app history <app_name>

Show deployment history for a specific app.
FlagDescription
--limit <n>Maximum number of deployments to return (default: 100, 0 = all).

kernel logs <app_name>

Tail app logs.
FlagDescription
--version <version>Select an app version (default: latest).
--follow, -fStream logs continuously.
--since <duration>, -sFetch logs from a duration or timestamp (same formats as kernel deploy logs).
--with-timestampsInclude timestamps in each line.
Log lines longer than 64 KiB are truncated.