How to move or copy storage volumes¶
You can copy or move 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 to another pool.
When copying or moving a volume between storage pools that use different drivers, the volume is automatically converted.
Copy custom storage volumes¶
Use the following command to copy a custom storage volume:
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 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.
Move or rename custom storage volumes¶
Before you can move or rename a custom storage volume, all instances that use it must be stopped.
Use the following command to move or rename a storage volume:
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.
Copy or migrate between cluster members¶
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.
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¶
Add the --target-project
to copy or move a custom storage volume to a different project.
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:
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 for the benefits).
Move instance storage volumes to another pool¶
To move an instance storage volume to another storage pool, stop the instance that contains the storage volume you want to move.
Use the following command to move the instance to a different pool:
lxc move <instance_name> --storage <target_pool_name>
Navigate to the overview page of the selected instance, and click on the Migrate button in the top right corner.

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

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

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