Configuring the CLI client

The CDE CLI client uses a configuration file, ~/.cde/config.yaml, to define the default CDE virtual cluster to interact with, as well as other configuration parameters.

Make sure that you have downloaded the CDE CLI client.

Determine the virtual cluster endpoint URL.
1. Navigate to the Cloudera Data Engineering Overview page.
2. In the Environments column, select the environment containing the virtual cluster you want to access using the CLI.
3. In the Virtual Clusters column on the right, click the Cluster Details icon for the virtual cluster you want to access.
4. Click JOBS API URL to copy the URL to your clipboard.
On the host with the CLI client, create or edit the configuration file at ~/.cde/config.yaml. You can create multiple profiles in the ~/.cde/config.yaml file and can be used while running commands. For more information, see Creating and using multiple profiles.

note
You can use a custom file location by setting the CDE_CONFIG environment variable. If you include “user: ” in your config.yaml, the CLI tool will not use the access token and will instead keep prompting for a password. If you want to use a credential file, then you must remove the specified user from the profile.
In the configuration file, specify the CDP user and virtual cluster endpoint as follows:
```
user: <CDP_user>
vcluster-endpoint: <CDE_virtual_cluster_endpoint>
```
The CDP user is your workload username.
Save the configuration file.
If you have not done so already, make sure that the cde file is executable by running chmod +x /path/to/cde.
Run cde job list to verify your configuration. Enter your workload password when prompted.

note
If the directory containing the cde file is not part of your PATH environment variable, you can either add it to your PATH environment variable or use the full path when running the command.
You can also configure the CLI to use an access token so that you do not need to enter your password each time. For more information, see Cloudera Data Engineering CLI authentication .

See for other configuration options.