Deploying

​

Deploy the app

​

From local directory

kernel deploy <entrypoint_file_name>

​

Notes

• The entrypoint_file_name is the file name where you defined your app.
• Include a .gitignore file to exclude dependency folders like node_modules and .venv.

​

From GitHub

kernel deploy github \
  --url https://github.com/<owner>/<repo> \
  --ref <branch|tag|commit> \
  --entrypoint <path/to/entrypoint> \
  [--path <optional/subdir>] \
  [--github-token <token>] \
  [--env KEY=value ...] \
  [--env-file .env] \
  [--version latest] \
  [--force]

​

Notes

• --path vs --entrypoint: Use --path to specify a subdirectory within the repo (useful for monorepos), and --entrypoint for the path to your app’s entry file relative to that directory (or repo root if no --path is specified).
• The CLI automatically downloads and extracts the GitHub source code and uploads your app for deployment.
• For private repositories, provide a --github-token or set the GITHUB_TOKEN environment variable.

​

Environment variables

kernel deploy my_app.ts --env MY_ENV_VAR=my_value # Can add multiple env vars delimited by space

kernel deploy my_app.ts --env-file .env

kernel deploy my_app.py --env MY_ENV_VAR=my_value # Can add multiple env vars delimited by space

kernel deploy my_app.py --env-file .env

​

Deployment notes

• The dependency manifest (package.json for JS/TS, pyproject.toml for Python) must be present in the root directory of your project.
• For JS/TS apps, set "type": "module" in your package.json.
• View deployment logs using: kernel deploy logs <deployment_id> --follow
• If you encounter a 500 error during deployment, verify that your entrypoint file name and extension are correct (e.g., app.py not app or app.js).
• Kernel assumes the root directory contains at least this file structure:

project-root/
  ├─ .gitignore # Exclude dependency folders like node_modules
  ├─ my_app.ts # Entrypoint file (can be located in a subdirectory, e.g. src/my_app.ts)
  ├─ package.json
  ├─ tsconfig.json # If using TypeScript
  └─ bun.lock | package-lock.json | pnpm-lock.yaml # One of these lockfiles

project-root/
  ├─ .gitignore # Exclude dependency folders like .venv
  ├─ my_app.py # Entrypoint file
  └─ pyproject.toml

# Successful deployment CLI output
SUCCESS  Compressed files
SUCCESS  Deployment successful
SUCCESS  App "my_app.ts" deployed with action(s): [my-action]
INFO  Invoke with: kernel invoke my-app my-action --payload '{...}'
SUCCESS  Total deployment time: 2.78s