Camel K CLI (kamel)

The Camel K command line interface, kamel, is the main entry point for running integrations on a Kubernetes cluster.

Releases of the Camel K CLI are available on:

Running on macOS

Before running the CLI on macOS, it may be necessary to give adequate permissions for it to run.

It can either be done on the "Privacy & Security" panel in the System Settings or via command-line:

xattr -d /path/to/kamel

Available Commands

Some of the most used commands are:

Table 1. Useful Commands
Name Description Example


Obtain the full list of available commands

kamel help


Run an integration on Kubernetes

kamel run


Debug a remote integration using a local debugger

kamel debug my-integration


Get integrations deployed on Kubernetes

kamel get


Get detailed information on a resource

kamel describe integration routes


Print the logs of a running integration

kamel log routes


Delete integrations deployed on Kubernetes

kamel delete routes


Bind Kubernetes resources, such as Kamelets, in an integration flow.

kamel bind timer-source -p "source.message=hello world" channel:mychannel


Install Camel K on a Kubernetes cluster

kamel install


Clear the state of integrations to rebuild them.

kamel rebuild --all


Reset the Camel K installation

kamel reset


Uninstall Camel K from a Kubernetes cluster

kamel uninstall


Display client version

kamel version

The list above is not the full list of available commands. You can run kamel help to obtain the full list. Each command also takes the --help as option to output more information, e.g.:

$ kamel run --help

Global Flags

While each command has a dedicated set of flags, there are global flags that are available to every command:

Table 2. Global Flags
Flag Description Example

--kube-config PATH

Path to the config file to use for CLI requests

kamel install --kube-config ~/.kube/config

-h or --help

Help for kamel, or the command

kamel run --help

-n or --namespace NAME

Namespace to use for all operations

kamel get --namespace NAME

For command-specific flags, run --help with the command to obtain the full list, e.g.:

$ kamel <command> --help


Some command options in the CLI can be also specified as modeline in the source file, take a look at the Modeline section for more information.

Image Registry

The CLI can be used to upload Maven dependencies and user data to the Image Registry. To do so, the CLI and the Operator have to be configured correctly.

For the Operator part, have a look at the installation documentation.

For the CLI, in most cases, executing docker login REGISTRY_URL successfully will suffice. If the Image Registry uses a custom certificate authority then it needs to be trusted, see SSL_CERT_FILE.