---
title: "blockhost create"
slug: "blockhost-create"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/blockhost-create"
---

> ## 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.

# blockhost create

This command adds a block client host to VMS, enabling the host to be identified and associated with block storage volumes created on the cluster. The host must first be configured as an NVMe-over-TCP client.

## Usage

```plaintext
blockhost create --tenant-id ID
                 --name NAME
                 --nqn NQN
                [--tags TAGS]
```

## Required Parameters

| `--tenant-id ID` | Specifies on which tenant to create the host definition. Specify `ID` as an integer. |
| --- | --- |
| `--name NAME` | Specifies the host name. |
| `--nqn NQN` | Specifies the host's NVM Express Qualified Name (NQN). The NQN is a unique identifier string that you can retrieve from the host. > [!NOTE] > Notice > > Host NQN must be unique on the tenant. > > On newly installed clusters, host NQN must be unique on the cluster, across all tenants. > > In multi-tenant clusters, it is possible to leverage unique host NQN enforcement to resolve the target tenant of client requests according to the requested host NQN. For details of this feature, see [Overview of Block Storage on VAST Cluster](/docs-5-5/docs/overview-of-block-storage-on-vast-cluster). |

## Options

| `--tags TAGS` | Adds specified key-value pairs to tag the host, for the purpose of categorizing and organizing block hosts. Specify `TAGS` as a comma separated list of pairs of strings in the format `KEY=VALUE`. For example: `--tags owner=John,department=research` |
| --- | --- |

## Example

```plaintext
vcli: admin> blockhost create --tenant-id 1 --name h11 --nqn nqn.2015-18.org.nvmexpress:uuid:3c4c4545-004e-3210-804d-c6c04f4b3234
```