<a id="howto-storage-move-volume"></a>

# How to move or copy storage volumes

You can [copy](#storage-copy-volume) or [move](#storage-move-volume) custom storage volumes from one storage pool to another, or copy or rename them within the same storage pool.

To move instance storage volumes from one storage pool to another, [move the corresponding instance](#storage-move-instance) to another pool.

When copying or moving a volume between storage pools that use different drivers, the volume is automatically converted.

<a id="storage-copy-volume"></a>

## Copy custom storage volumes

CLI

Use the following command to copy a custom storage volume:

```none
lxc storage volume copy <source_pool_name>/<source_volume_name> <target_pool_name>/<target_volume_name>
```

Add the `--volume-only` flag to copy only the volume and skip any snapshots that the volume might have.
If the volume already exists in the target location, use the `--refresh` flag to update the copy (see [Optimized volume transfer](https://canonical.com/lxd/docs/default/reference/storage_drivers/index.html.md#storage-optimized-volume-transfer) for the benefits).

Specify the same pool as the source and target pool to copy the volume within the same storage pool.
You must specify different volume names for source and target in this case.

When copying from one storage pool to another, you can either use the same name for both volumes or rename the new volume.

UI

To copy a custom storage volume, navigate to the Overview page of the storage volume you wish to copy, and click Copy.

![LXD Custom Storage Volume overview page](images/storage/storage_volumes_overview.png)

In the Copy volume modal, you can define a new name for the copied volume as well as a number of other attributes.

![LXD Custom Storage Volume copy volume modal](images/storage/storage_volumes_copy_modal.png)

<a id="storage-move-volume"></a>

## Move or rename custom storage volumes

CLI

Before you can move or rename a custom storage volume, all instances that use it must be [stopped](https://canonical.com/lxd/docs/default/howto/instances_manage/index.html.md#instances-manage-stop).

Use the following command to move or rename a storage volume:

```none
lxc storage volume move <source_pool_name>/<source_volume_name> <target_pool_name>/<target_volume_name>
```

Specify the same pool as the source and target pool to rename the volume while keeping it in the same storage pool.
You must specify different volume names for source and target in this case.

When moving from one storage pool to another, you can either use the same name for both volumes or rename the new volume.

UI

To rename a custom storage volume, navigate to its Overview page and select its name in the header to edit it.

![LXD Rename Custom Storage Volume](images/storage/storage_volumes_rename.png)

## Copy or migrate between cluster members

CLI

For most storage drivers (except for `ceph` and `ceph-fs`), storage volumes exist only on the cluster member for which they were created.

To copy or migrate a custom storage volume from one cluster member to another, add the `--target` and `--destination-target` flags to specify the source cluster member and the target cluster member, respectively.

UI

You can use the LXD UI to copy storage volumes between cluster members, but not to migrate them.

To copy a storage volume, navigate to the Overview page of the storage volume within a clustered environment, then click Copy.

In the Copy volume modal, select the target cluster member from the Cluster member dropdown.

## Copy or move between projects

CLI

Add the `--target-project` to copy or move a custom storage volume to a different project.

UI

To copy a storage volume between projects, navigate to the Overview page of the storage volume, then click Copy.

In the Copy volume modal, select the target from the Target project dropdown.

## Copy or migrate between LXD servers

You can copy a custom volume from one LXD server to another, or migrate it (move it between servers), by specifying the remote for each pool:

```none
lxc storage volume copy <source_remote>:<source_pool_name>/<source_volume_name> <target_remote>:<target_pool_name>/<target_volume_name>
lxc storage volume move <source_remote>:<source_pool_name>/<source_volume_name> <target_remote>:<target_pool_name>/<target_volume_name>
```

You can add the `--mode` flag to choose a transfer mode, depending on your network setup:

`pull` (default)
: Instruct the target server to pull the respective storage volume.

`push`
: Push the storage volume from the source server to the target server.

`relay`
: Pull the storage volume from the source server to the local client, and then push it to the target server.

If the volume already exists in the target location, use the `--refresh` flag to update the copy (see [Optimized volume transfer](https://canonical.com/lxd/docs/default/reference/storage_drivers/index.html.md#storage-optimized-volume-transfer) for the benefits).

<a id="storage-move-instance"></a>

## Move instance storage volumes to another pool

To move an instance storage volume to another storage pool, [stop the instance](https://canonical.com/lxd/docs/default/howto/instances_manage/index.html.md#instances-manage-stop) that contains the storage volume you want to move.

CLI

Use the following command to move the instance to a different pool:

```none
lxc move <instance_name> --storage <target_pool_name>
```

UI

Navigate to the overview page of the selected instance, and click on the Migrate button in the top right corner.

![LXD Instance overview page](images/instances/instance_overview_page.png)

Within the move modal, click Move instance root storage to a different pool to view available storage pools to move to.

![LXD Instance root storage move method modal](images/instances/move_instance_modal.png)

Click Select in the row of the target storage pool for the move.

![LXD Instance root storage move pool selection modal](images/instances/move_instance_modal_2.png)

On the resulting confirmation modal, click Move to finalize the process.

![LXD Instance root storage confirmation modal](images/instances/move_confirmation_modal.png)
