> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/zenlayer-cli/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/zenlayer-cli/configure.md).

# Configure the CLI

This guide will help you configure Zenlayer Cloud CLI (`zeno`) to securely access and manage your Zenlayer Cloud resources.

## Configuration Overview

Zenlayer Cloud CLI uses configuration files and environment variables to store and manage access credentials and other settings. Configuration files are stored in the `.zenlayer` folder under the user's home directory, containing the following files:

* `config.json` - Stores general settings such as language preferences and output format
* `credentials.json` - Stores access credentials with strict file permission protection

## Configuration Methods

You can configure Zenlayer Cloud CLI in the following ways:

1. **Interactive Configuration** - Use the `zeno configure` command for interactive configuration
2. **Manual File Editing** - Directly edit the configuration files
3. **Environment Variables** - Set environment variables to override settings in configuration files

## Configuration Precedence

Zenlayer Cloud CLI applies configuration in the following precedence order (from highest to lowest):

1. Command-line parameters (e.g., `--profile`, `--output`, etc.)
2. Environment variables (e.g., `ZENLAYER_PROFILE`, `ZENLAYER_ACCESS_KEY_ID`, etc.)
3. Settings in configuration files

## Configuration Topics

The configuration guide is divided into the following sections:

* **Configuration Files** - Detailed introduction to the structure, location, and content of configuration files
* **Environment Variables** - Introduction to supported environment variables and usage
* **Command Line Options** - Introduction to supported command-line options and usage
* **Command Completion** - Introduction to configuring and using command completion

## Quick Configuration

To quickly configure Zenlayer Cloud CLI, run the following command:

```bash
zeno configure
```

This will guide you through the interactive configuration process, including entering access credentials, selecting a default region, setting output format, etc.

## Next Steps

* Read [Configuration Files](/zenlayer-cli/configure/files.md) to learn about the detailed structure of configuration files
* Read [Environment Variables](/zenlayer-cli/configure/envvars.md) to learn about supported environment variables
* Read [Command Line Options](/zenlayer-cli/configure/options.md) to learn about supported command-line options
* Read [Command Completion](/zenlayer-cli/configure/completion.md) to learn about configuring command completion


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.console.zenlayer.com/zenlayer-cli/configure.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.