---
title: "Creating Active Directory Configuration and Joining Active Directory in VAST CLI"
slug: "creating-active-directory-configuration-and-joining-active-directory-in-vast-cli"
tags: ["5.4"]
updated: 2026-10-28T01:54:03Z
published: 2026-10-28T01:54:03Z
canonical: "docs.vastdata.com/creating-active-directory-configuration-and-joining-active-directory-in-vast-cli"
---

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

# Creating Active Directory Configuration and Joining Active Directory in VAST CLI

## Creating the Active Directory Configuration

To create the Active Directory configuration, use the `activedirectory create` command. For example:

```plaintext
vcli: admin> activedirectory create --machine-account-name co-vcluster --port 389 --binddn cn=admin,ou=users,dc=mycompanyad,dc=com --bindpw **** --method simple --use-tls --domain-name co-ad.com
```

An Active Directory configuration record is created.

When this step is completed well, no computer account is created in Active Directory. The next step ([join operation](/docs-5-4/docs/en/creating-active-directory-configuration-and-joining-active-directory-in-vast-cli#joining-active-directory)) creates a new computer account in the Active Directory.

## Joining Active Directory

1. After creating the Active Directory configuration, run `activedirectory list` to get the ID of the Active Directory configuration record. In this example, the ID is 3.
2. Run `activedirectory modifyactivedirectory modify` with the Active Directory configuration record ID specified on the `--id` parameter. Add the `--join` option to join the Active Directory domain. Specify `--admin-username` and provide a user name of an Active Directory admin user with permission to join the Active Directory domain:

```plaintext
vcli admin> activedirectory modify --id 3 --join --admin-username USER
```
3. Confirm that you wish to proceed:

```plaintext
Are you sure you want to modify the Active directory? [y/N] y
```
4. Enter the password for the Active Directory admin user when prompted:

```plaintext
Enter admin password:
Password:

Waiting ...

[2022-03-31 10:18:39] waiting for active directory My_AD enabled state to change to True ... /

Completed
vcli: admin>
```
5. Run `activedirectory listactivedirectory list` again and verify that the Active Directory configuration state is now `JOINED`.