> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# vessl configure

### **Setup a** VESSL **environment** 

```
vessl configure [OPTIONS]
```

| Option                     | Description                                                                |
| -------------------------- | -------------------------------------------------------------------------- |
| `-t`, `--access-token`     | Access token used for authorization                                        |
| `-o`, `--organization`     | Default organization                                                       |
| `-p`, `--project`          | Default project                                                            |
| `-f`, `--credentials-file` | Path to file containing configuration data                                 |
| `--renew-token`            | Renew access token                                                         |
| `--reset`                  | Reset the CLI connection and prompt for organization and project selection |

### **Change the default organization**

Set the default organization so that you do not enter the organization every time you execute the `vessl` command.

```
vessl configure organization [ORGANIZATION]
```

| Argument       | Description              |
| -------------- | ------------------------ |
| `ORGANIZATION` | New default organization |

### **Change the default project**

Set the default organization so that you do not enter the project every time you execute the `vessl` command.

```
vessl configure project [PROJECT]
```

| Argument  | Description         |
| --------- | ------------------- |
| `PROJECT` | New default project |

### **View the current configuration**

```
vessl configure list
```

### Configuration Precedence

You can configure your VESSL environment in multiple ways. Here is a list of ways, in order of precedence.

1. Command line arguments / options: `-o` , `-p` options and `ORGANIZATION` , `PROJECT` arguments.
2. Credentials file option: `-f` , a path to a file containing configuration data.
3. Environment variables: `VESSL_ACCESS_TOKEN`, `VESSL_DEFAULT_ORGANIZATION` .
4. Credentials file environment variable: `VESSL_CREDENTIALS_FILE` .
5. Default credentials file: a configuration file maintained by VESSL located at `~/.vessl/config` .

<Note>The `--renew-token` flag for `vessl configure` will take precedence over other methods and renew your access token.</Note>