---
layout: docs
page_title: 'Commands: volume detach'
sidebar_title: detach
description: |
  Detach volumes with CSI plugins.
---

# Command: volume detach

The `volume detach` command detaches external storage volumes with Nomad's
[Container Storage Interface (CSI)][csi] support.

## Usage

```plaintext
nomad volume detach [options] [volume] [node]
```

The `volume detach` command requires two arguments, specifying the ID of the
volume to be detached and the node to detach it from. Detaching will fail if
the volume is still in use by an allocation.

Note that you can use a node ID prefix just as you can with other Nomad
commands, but if the node has been garbage collected, you may need to pass the
full node ID.

When ACLs are enabled, this command requires a token with the
`csi-write-volume` and `csi-read-volume` capabilities for the volume's
namespace.

## General Options

@include 'general_options.mdx'

[csi]: https://github.com/container-storage-interface/spec