Your IP : 216.73.217.95

Current Path : /proc/thread-self/root/snap/lxd/current/share/lxd-documentation/howto/storage_volumes/
Upload File :
Current File : //proc/thread-self/root/snap/lxd/current/share/lxd-documentation/howto/storage_volumes/index.html

<!doctype html>
<html class="no-js" lang="en" data-content_root="../../">
  <head><meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
<meta property="og:title" content="How to manage storage volumes" />
<meta property="og:type" content="website" />
<meta property="og:url" content="/howto/storage_volumes/" />
<meta property="og:site_name" content="LXD documentation" />
<meta property="og:description" content="See the following sections for instructions on how to create, configure, view and resize Storage volumes. View storage volumes: You can display a list of all available storage volumes and check the..." />
<meta property="og:image" content="https://documentation.ubuntu.com/lxd/latest/_static/lxd_tag.png" />
<meta property="og:image:alt" content="LXD documentation" />
<meta name="description" content="See the following sections for instructions on how to create, configure, view and resize Storage volumes. View storage volumes: You can display a list of all available storage volumes and check the..." />

    <meta property="article:modified_time" content="2026-02-13T21:24:04+00:00" /><link rel="index" title="Index" href="../../genindex/"><link rel="search" title="Search" href="../../search/"><link rel="next" title="How to manage storage buckets" href="../storage_buckets/"><link rel="prev" title="How to manage storage pools" href="../storage_pools/">
        <link rel="canonical" href="/howto/storage_volumes/">

    <link rel="shortcut icon" href="../../_static/favicon.ico"><!-- Generated with Sphinx 7.4.7 and Furo 2025.12.19 -->
        <title>How to manage storage volumes - LXD documentation</title>
      <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=d111a655" />
    <link rel="stylesheet" type="text/css" href="../../_static/styles/furo.css?v=7bdb33bb" />
    <link rel="stylesheet" type="text/css" href="../../_static/copybutton.css?v=76b2166b" />
    <link rel="stylesheet" type="text/css" href="../../_static/config-options.css" />
    <link rel="stylesheet" type="text/css" href="../../_static/related-links.css" />
    <link rel="stylesheet" type="text/css" href="../../_static/terminal.css" />
    <link rel="stylesheet" type="text/css" href="../../_static/youtube.css" />
    <link rel="stylesheet" type="text/css" href="../../_static/sphinx-design.min.css?v=95c83b7e" />
    <link rel="stylesheet" type="text/css" href="../../_static/tabs.css?v=a5c4661c" />
    <link rel="stylesheet" type="text/css" href="../../_static/styles/furo-extensions.css?v=8dab3a3b" />
    <link rel="stylesheet" type="text/css" href="../../_static/lxd_custom.css?v=bfbf4da2" />
    <link rel="stylesheet" type="text/css" href="../../_static/cookie-banner.css?v=b74831ab" />
    <link rel="stylesheet" type="text/css" href="../../_static/custom.css?v=e189117a" />
    <link rel="stylesheet" type="text/css" href="../../_static/header.css?v=a8078839" />
    <link rel="stylesheet" type="text/css" href="../../_static/github_issue_links.css?v=3d761185" />
    <link rel="stylesheet" type="text/css" href="../../_static/furo_colors.css?v=825fec6f" />
    
</head>
  <body>
    <header id="header" class="p-navigation">
  <!-- Google Tag Manager -->
  <script>
    (function(w, d, s, l, i) {
      w[l] = w[l] || [];
      w[l].push({
        'gtm.start': new Date().getTime(),
        event: 'gtm.js'
      });
      var f = d.getElementsByTagName(s)[0];
      var j = d.createElement(s);
      var dl = '';
      if (l != 'dataLayer') {
          dl = '&l=' + l;
      }
      j.async = true;
      j.src = 'https://www.googletagmanager.com/gtm.js?id=' + i + dl;
      f.parentNode.insertBefore(j, f);
    })(window, document, 'script', 'dataLayer', 'GTM-KNX3CJC');
  </script>
  
  <div class="p-navigation__nav" role="menubar">

    <ul class="p-navigation__links" role="menu">

      <li>
        
        <a class="p-logo" href="https://canonical.com/lxd" aria-current="page">
          <img src="../../_static/lxd_tag.png" alt="Logo" class="p-logo-image">
          <div class="p-logo-text p-heading--4">LXD
          </div>
        </a>
        
      </li>

      <li class="nav-ubuntu-com">
        
        <a href="https://canonical.com/lxd" class="p-navigation__link">canonical.com/lxd</a>
        
      </li>

      <li class="nav-dropdown">
        <a href="#" class="p-navigation__link nav-more-links"
           id="more-resources-toggle"
           aria-haspopup="true"
           aria-expanded="false">
          More resources
        </a>
        <ul class="more-links-dropdown" aria-labelledby="more-resources-toggle">
          
          <li>
            <a href="https://discourse.ubuntu.com/c/lxd/" class="p-navigation__sub-link p-dropdown__link">Discourse</a>
          </li>
          
      
          
      
          
          <li>
            <a href="https://matrix.to/#/#documentation:ubuntu.com" class="p-navigation__sub-link p-dropdown__link">Matrix</a>
          </li>
          
      
          
          <li>
            <a href="https://github.com/canonical/lxd" class="p-navigation__sub-link p-dropdown__link">GitHub</a>
          </li>
          

        </ul>
      </li>

    </ul>
  </div>
</header>
   
    <script>
      document.body.dataset.theme = localStorage.getItem("theme") || "auto";
    </script>
    

<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
  <symbol id="svg-toc" viewBox="0 0 24 24">
    <title>Contents</title>
    <svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 1024 1024">
      <path d="M408 442h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8zm-8 204c0 4.4 3.6 8 8 8h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56zm504-486H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zm0 632H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zM115.4 518.9L271.7 642c5.8 4.6 14.4.5 14.4-6.9V388.9c0-7.4-8.5-11.5-14.4-6.9L115.4 505.1a8.74 8.74 0 0 0 0 13.8z"/>
    </svg>
  </symbol>
  <symbol id="svg-menu" viewBox="0 0 24 24">
    <title>Menu</title>
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
      stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-menu">
      <line x1="3" y1="12" x2="21" y2="12"></line>
      <line x1="3" y1="6" x2="21" y2="6"></line>
      <line x1="3" y1="18" x2="21" y2="18"></line>
    </svg>
  </symbol>
  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
    <title>Expand</title>
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
      stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-chevron-right">
      <polyline points="9 18 15 12 9 6"></polyline>
    </svg>
  </symbol>
  <symbol id="svg-sun" viewBox="0 0 24 24">
    <title>Light mode</title>
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
      <circle cx="12" cy="12" r="5"></circle>
      <line x1="12" y1="1" x2="12" y2="3"></line>
      <line x1="12" y1="21" x2="12" y2="23"></line>
      <line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
      <line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
      <line x1="1" y1="12" x2="3" y2="12"></line>
      <line x1="21" y1="12" x2="23" y2="12"></line>
      <line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
      <line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
    </svg>
  </symbol>
  <symbol id="svg-moon" viewBox="0 0 24 24">
    <title>Dark mode</title>
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
      <path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
    </svg>
  </symbol>
  <symbol id="svg-sun-with-moon" viewBox="0 0 24 24">
    <title>Auto light/dark, in light mode</title>
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
      stroke-width="1" stroke-linecap="round" stroke-linejoin="round"
      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
      <path style="opacity: 50%" d="M 5.411 14.504 C 5.471 14.504 5.532 14.504 5.591 14.504 C 3.639 16.319 4.383 19.569 6.931 20.352 C 7.693 20.586 8.512 20.551 9.25 20.252 C 8.023 23.207 4.056 23.725 2.11 21.184 C 0.166 18.642 1.702 14.949 4.874 14.536 C 5.051 14.512 5.231 14.5 5.411 14.5 L 5.411 14.504 Z"/>
      <line x1="14.5" y1="3.25" x2="14.5" y2="1.25"/>
      <line x1="14.5" y1="15.85" x2="14.5" y2="17.85"/>
      <line x1="10.044" y1="5.094" x2="8.63" y2="3.68"/>
      <line x1="19" y1="14.05" x2="20.414" y2="15.464"/>
      <line x1="8.2" y1="9.55" x2="6.2" y2="9.55"/>
      <line x1="20.8" y1="9.55" x2="22.8" y2="9.55"/>
      <line x1="10.044" y1="14.006" x2="8.63" y2="15.42"/>
      <line x1="19" y1="5.05" x2="20.414" y2="3.636"/>
      <circle cx="14.5" cy="9.55" r="3.6"/>
    </svg>
  </symbol>
  <symbol id="svg-moon-with-sun" viewBox="0 0 24 24">
    <title>Auto light/dark, in dark mode</title>
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
      stroke-width="1" stroke-linecap="round" stroke-linejoin="round"
      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
      <path d="M 8.282 7.007 C 8.385 7.007 8.494 7.007 8.595 7.007 C 5.18 10.184 6.481 15.869 10.942 17.24 C 12.275 17.648 13.706 17.589 15 17.066 C 12.851 22.236 5.91 23.143 2.505 18.696 C -0.897 14.249 1.791 7.786 7.342 7.063 C 7.652 7.021 7.965 7 8.282 7 L 8.282 7.007 Z"/>
      <line style="opacity: 50%" x1="18" y1="3.705" x2="18" y2="2.5"/>
      <line style="opacity: 50%" x1="18" y1="11.295" x2="18" y2="12.5"/>
      <line style="opacity: 50%" x1="15.316" y1="4.816" x2="14.464" y2="3.964"/>
      <line style="opacity: 50%" x1="20.711" y1="10.212" x2="21.563" y2="11.063"/>
      <line style="opacity: 50%" x1="14.205" y1="7.5" x2="13.001" y2="7.5"/>
      <line style="opacity: 50%" x1="21.795" y1="7.5" x2="23" y2="7.5"/>
      <line style="opacity: 50%" x1="15.316" y1="10.184" x2="14.464" y2="11.036"/>
      <line style="opacity: 50%" x1="20.711" y1="4.789" x2="21.563" y2="3.937"/>
      <circle style="opacity: 50%" cx="18" cy="7.5" r="2.169"/>
    </svg>
  </symbol>
  <symbol id="svg-pencil" viewBox="0 0 24 24">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-pencil-code">
      <path d="M4 20h4l10.5 -10.5a2.828 2.828 0 1 0 -4 -4l-10.5 10.5v4" />
      <path d="M13.5 6.5l4 4" />
      <path d="M20 21l2 -2l-2 -2" />
      <path d="M17 17l-2 2l2 2" />
    </svg>
  </symbol>
  <symbol id="svg-eye" viewBox="0 0 24 24">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-eye-code">
      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
      <path d="M10 12a2 2 0 1 0 4 0a2 2 0 0 0 -4 0" />
      <path
        d="M11.11 17.958c-3.209 -.307 -5.91 -2.293 -8.11 -5.958c2.4 -4 5.4 -6 9 -6c3.6 0 6.6 2 9 6c-.21 .352 -.427 .688 -.647 1.008" />
      <path d="M20 21l2 -2l-2 -2" />
      <path d="M17 17l-2 2l2 2" />
    </svg>
  </symbol>
</svg>

<input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation" aria-label="Toggle site navigation sidebar">
<input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc" aria-label="Toggle table of contents sidebar">
<label class="overlay sidebar-overlay" for="__navigation"></label>
<label class="overlay toc-overlay" for="__toc"></label>

<a class="skip-to-content muted-link" href="#furo-main-content">Skip to content</a>



<div class="page">
  <header class="mobile-header">
    <div class="header-left">
      <label class="nav-overlay-icon" for="__navigation">
        <span class="icon"><svg><use href="#svg-menu"></use></svg></span>
      </label>
    </div>
    <div class="header-center">
      <a href="../../"><div class="brand">LXD documentation</div></a>
    </div>
    <div class="header-right">
      <div class="theme-toggle-container theme-toggle-header">
        <button class="theme-toggle" aria-label="Toggle Light / Dark / Auto color theme">
          <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
          <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
          <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
          <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
        </button>
      </div>
      <label class="toc-overlay-icon toc-header-icon" for="__toc">
        <span class="icon"><svg><use href="#svg-toc"></use></svg></span>
      </label>
    </div>
  </header>
  <aside class="sidebar-drawer">
    <div class="sidebar-container">
      
      <div class="sidebar-sticky"><a class="sidebar-brand" href="../../">
  
  <span class="sidebar-brand-text">LXD documentation</span>
  
</a><form class="sidebar-search-container" method="get" action="../../search/" role="search">
    <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
    <input type="submit" value="Go">
    <input type="hidden" name="check_keywords" value="yes">
    <input type="hidden" name="area" value="default">
  </form>
  <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
  <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../">LXD</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../tutorial/first_steps/">Tutorial</a></li>
<li class="toctree-l1 current has-children"><a class="reference internal" href="../">How-to guides</a><input aria-label="Toggle navigation of How-to guides" checked="" class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul class="current">
<li class="toctree-l2 has-children"><a class="reference internal" href="../../getting_started/">Getting started</a><input aria-label="Toggle navigation of Getting started" class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" role="switch" type="checkbox"/><label for="toctree-checkbox-2"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../../installing/">Install LXD</a></li>
<li class="toctree-l3"><a class="reference internal" href="../initialize/">Initialize LXD</a></li>
<li class="toctree-l3"><a class="reference internal" href="../access_ui/">Access the UI</a></li>
<li class="toctree-l3"><a class="reference internal" href="../access_documentation/">Access documentation locally</a></li>
</ul>
</li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../operation/">LXD server and client</a><input aria-label="Toggle navigation of LXD server and client" class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" role="switch" type="checkbox"/><label for="toctree-checkbox-3"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../server_expose/">Expose LXD to the network</a></li>
<li class="toctree-l3"><a class="reference internal" href="../server_configure/">Configure the LXD server</a></li>
<li class="toctree-l3 has-children"><a class="reference internal" href="../oidc/">Configure single sign-on with OIDC</a><input aria-label="Toggle navigation of Configure single sign-on with OIDC" class="toctree-checkbox" id="toctree-checkbox-4" name="toctree-checkbox-4" role="switch" type="checkbox"/><label for="toctree-checkbox-4"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l4"><a class="reference internal" href="../oidc_auth0/">How to configure Auth0</a></li>
<li class="toctree-l4"><a class="reference internal" href="../oidc_ory/">How to configure Ory Hydra</a></li>
<li class="toctree-l4"><a class="reference internal" href="../oidc_keycloak/">How to configure Keycloak</a></li>
<li class="toctree-l4"><a class="reference internal" href="../oidc_entra_id/">How to configure Entra ID</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../remotes/">Add remote servers</a></li>
<li class="toctree-l3"><a class="reference internal" href="../lxc_alias/">Add command aliases</a></li>
</ul>
</li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../instances/">Instances</a><input aria-label="Toggle navigation of Instances" class="toctree-checkbox" id="toctree-checkbox-5" name="toctree-checkbox-5" role="switch" type="checkbox"/><label for="toctree-checkbox-5"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../instances_create/">Create instances</a></li>
<li class="toctree-l3"><a class="reference internal" href="../instances_configure/">Configure instances</a></li>
<li class="toctree-l3"><a class="reference internal" href="../instances_manage/">Manage instances</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../profiles/">Use profiles</a></li>
<li class="toctree-l3"><a class="reference internal" href="../instances_troubleshoot/">Troubleshoot errors</a></li>
<li class="toctree-l3"><a class="reference internal" href="../instances_ubuntu_pro_attach/">Auto attach Ubuntu Pro</a></li>
<li class="toctree-l3"><a class="reference internal" href="../instances_access_files/">Access files</a></li>
<li class="toctree-l3"><a class="reference internal" href="../instances_console/">Access the console</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../instance-exec/">Run commands</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../cloud-init/">Use cloud-init</a></li>
<li class="toctree-l3"><a class="reference internal" href="../instances_routed_nic_vm/">Add a routed NIC to a VM</a></li>
<li class="toctree-l3"><a class="reference internal" href="../instances_backup/">Back up instances</a></li>
<li class="toctree-l3"><a class="reference internal" href="../instances_migrate/">Migrate instances</a></li>
<li class="toctree-l3"><a class="reference internal" href="../import_machines_to_instances/">Import existing machines</a></li>
<li class="toctree-l3"><a class="reference internal" href="../container_gpu_passthrough_with_docker/">Pass NVIDIA GPUs</a></li>
</ul>
</li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../images/">Images</a><input aria-label="Toggle navigation of Images" class="toctree-checkbox" id="toctree-checkbox-6" name="toctree-checkbox-6" role="switch" type="checkbox"/><label for="toctree-checkbox-6"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../images_remote/">Use remote images</a></li>
<li class="toctree-l3"><a class="reference internal" href="../images_manage/">Manage images</a></li>
<li class="toctree-l3"><a class="reference internal" href="../images_profiles/">Associate profiles</a></li>
<li class="toctree-l3"><a class="reference internal" href="../images_copy/">Copy and import images</a></li>
<li class="toctree-l3"><a class="reference internal" href="../images_create/">Create images</a></li>
</ul>
</li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../projects/">Projects</a><input aria-label="Toggle navigation of Projects" class="toctree-checkbox" id="toctree-checkbox-7" name="toctree-checkbox-7" role="switch" type="checkbox"/><label for="toctree-checkbox-7"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../projects_create/">Create and configure</a></li>
<li class="toctree-l3"><a class="reference internal" href="../projects_work/">Work with projects</a></li>
<li class="toctree-l3"><a class="reference internal" href="../projects_confine/">Confine users to projects</a></li>
</ul>
</li>
<li class="toctree-l2 current has-children"><a class="reference internal" href="../../storage/">Storage</a><input aria-label="Toggle navigation of Storage" checked="" class="toctree-checkbox" id="toctree-checkbox-8" name="toctree-checkbox-8" role="switch" type="checkbox"/><label for="toctree-checkbox-8"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="../storage_pools/">Manage pools</a></li>
<li class="toctree-l3 current current-page"><a class="current reference internal" href="#">Manage volumes</a></li>
<li class="toctree-l3"><a class="reference internal" href="../storage_buckets/">Manage buckets</a></li>
<li class="toctree-l3"><a class="reference internal" href="../storage_create_instance/">Create an instance in a pool</a></li>
<li class="toctree-l3"><a class="reference internal" href="../storage_backup_volume/">Back up a volume</a></li>
<li class="toctree-l3"><a class="reference internal" href="../storage_move_volume/">Move or copy a volume</a></li>
<li class="toctree-l3"><a class="reference internal" href="../storage_csi/">Use the LXD CSI driver with Kubernetes</a></li>
</ul>
</li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../networks/">Networking</a><input aria-label="Toggle navigation of Networking" class="toctree-checkbox" id="toctree-checkbox-9" name="toctree-checkbox-9" role="switch" type="checkbox"/><label for="toctree-checkbox-9"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../network_create/">Create a network</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_configure/">Configure a network</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_bgp/">Configure as BGP server</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_acls/">Configure network ACLs</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_forwards/">Configure forwards</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_zones/">Configure network zones</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_bridge_firewalld/">Configure your firewall</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_bridge_resolved/">Integrate with resolved</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_ovn_setup/">Set up OVN</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_load_balancers/">Configure load balancers</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_ovn_peers/">Configure peer routing</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_ipam/">Display IPAM information</a></li>
</ul>
</li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../clustering/">Clustering</a><input aria-label="Toggle navigation of Clustering" class="toctree-checkbox" id="toctree-checkbox-10" name="toctree-checkbox-10" role="switch" type="checkbox"/><label for="toctree-checkbox-10"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../cluster_form/">Form a cluster</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cluster_manage/">Manage a cluster</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cluster_config_networks/">Configure networks</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cluster_config_storage/">Configure storage</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cluster_manage_instance/">Manage instances</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cluster_groups/">Set up cluster groups</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cluster_placement_groups/">Use placement groups</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cluster_recover/">Recover a cluster</a></li>
<li class="toctree-l3"><a class="reference internal" href="../cluster_vip/">Set up a highly available virtual IP</a></li>
</ul>
</li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../production-setup/">Production setup</a><input aria-label="Toggle navigation of Production setup" class="toctree-checkbox" id="toctree-checkbox-11" name="toctree-checkbox-11" role="switch" type="checkbox"/><label for="toctree-checkbox-11"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../benchmark_performance/">Benchmark performance</a></li>
<li class="toctree-l3"><a class="reference internal" href="../network_increase_bandwidth/">Increase bandwidth</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../metrics/">Monitor metrics</a></li>
<li class="toctree-l3"><a class="reference internal" href="../logs_loki/">Send logs to Loki</a></li>
<li class="toctree-l3"><a class="reference internal" href="../grafana/">Set up Grafana</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../backup/">Back up a server</a></li>
<li class="toctree-l3"><a class="reference internal" href="../disaster_recovery/">Recover instances</a></li>
<li class="toctree-l3"><a class="reference internal" href="../disaster_recovery_replication/">Disaster recovery with storage replication</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../snap/">Manage the snap</a></li>
<li class="toctree-l2"><a class="reference internal" href="../security_harden/">Harden security</a></li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../troubleshoot/">Troubleshooting</a><input aria-label="Toggle navigation of Troubleshooting" class="toctree-checkbox" id="toctree-checkbox-12" name="toctree-checkbox-12" role="switch" type="checkbox"/><label for="toctree-checkbox-12"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../network_bridge_firewalld/">Configure your firewall</a></li>
<li class="toctree-l3"><a class="reference internal" href="../instances_troubleshoot/">Troubleshoot instances</a></li>
<li class="toctree-l3"><a class="reference internal" href="../dqlite_troubleshoot/">Troubleshoot Dqlite</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../debugging/">Debug LXD</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../faq/">Frequently asked</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../support/">Get support</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../contributing/">Contribute to LXD</a></li>
<li class="toctree-l2"><a class="reference internal" href="../auth_bearer/">How to authenticate to the LXD API using bearer tokens</a></li>
<li class="toctree-l2"><a class="reference internal" href="../devlxd_authenticate/">How to authenticate to the DevLXD API</a></li>
</ul>
</li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../../explanation/">Explanation</a><input aria-label="Toggle navigation of Explanation" class="toctree-checkbox" id="toctree-checkbox-13" name="toctree-checkbox-13" role="switch" type="checkbox"/><label for="toctree-checkbox-13"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/lxd_lxc/"><code class="docutils literal notranslate"><span class="pre">lxd</span></code> and <code class="docutils literal notranslate"><span class="pre">lxc</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/instances/">Containers and VMs</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../image-handling/">Local and remote images</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/storage/">Storage pools, volumes, and buckets</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/networks/">Networking setups</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../database/">The LXD Dqlite database</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/lxc_show_info/"><code class="docutils literal notranslate"><span class="pre">lxc</span></code> <code class="docutils literal notranslate"><span class="pre">show</span></code> and <code class="docutils literal notranslate"><span class="pre">info</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="../../authentication/">Remote API authentication</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/authorization/">Remote API authorization</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/projects/">Instances grouping with projects</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/clusters/">Clusters</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/performance_tuning/">Performance tuning</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/security/">Security</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/bpf/">Privilege delegation using BPF Token</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../explanation/csi/">The LXD CSI driver</a></li>
</ul>
</li>
<li class="toctree-l1 has-children"><a class="reference internal" href="../../reference/">Reference</a><input aria-label="Toggle navigation of Reference" class="toctree-checkbox" id="toctree-checkbox-14" name="toctree-checkbox-14" role="switch" type="checkbox"/><label for="toctree-checkbox-14"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l2"><a class="reference internal" href="../../requirements/">Requirements</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../architectures/">Architectures</a></li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../reference/release-notes/">Release notes</a><input aria-label="Toggle navigation of Release notes" class="toctree-checkbox" id="toctree-checkbox-15" name="toctree-checkbox-15" role="switch" type="checkbox"/><label for="toctree-checkbox-15"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../../reference/release-notes/release-notes-6.7/">LXD 6.7</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/release-notes/release-notes-6.6/">LXD 6.6</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/releases-snap/">Releases and snap</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/remote_image_servers/">Remote image servers</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/image_format/">Image format</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../guest-os-compatibility/">Guest OS compatibility</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../container-environment/">Container environment</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../config-options/">Configuration option index</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../server/">Server configuration</a></li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../explanation/instance_config/">Instance configuration</a><input aria-label="Toggle navigation of Instance configuration" class="toctree-checkbox" id="toctree-checkbox-16" name="toctree-checkbox-16" role="switch" type="checkbox"/><label for="toctree-checkbox-16"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../../reference/instance_properties/">Instance properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/instance_options/">Instance options</a></li>
<li class="toctree-l3 has-children"><a class="reference internal" href="../../reference/devices/">Devices</a><input aria-label="Toggle navigation of Devices" class="toctree-checkbox" id="toctree-checkbox-17" name="toctree-checkbox-17" role="switch" type="checkbox"/><label for="toctree-checkbox-17"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l4"><a class="reference internal" href="../../reference/standard_devices/">Standard devices</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_none/">Type: <code class="docutils literal notranslate"><span class="pre">none</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_nic/">Type: <code class="docutils literal notranslate"><span class="pre">nic</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_disk/">Type: <code class="docutils literal notranslate"><span class="pre">disk</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_unix_char/">Type: <code class="docutils literal notranslate"><span class="pre">unix-char</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_unix_block/">Type: <code class="docutils literal notranslate"><span class="pre">unix-block</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_usb/">Type: <code class="docutils literal notranslate"><span class="pre">usb</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_gpu/">Type: <code class="docutils literal notranslate"><span class="pre">gpu</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_infiniband/">Type: <code class="docutils literal notranslate"><span class="pre">infiniband</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_proxy/">Type: <code class="docutils literal notranslate"><span class="pre">proxy</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_unix_hotplug/">Type: <code class="docutils literal notranslate"><span class="pre">unix-hotplug</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_tpm/">Type: <code class="docutils literal notranslate"><span class="pre">tpm</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/devices_pci/">Type: <code class="docutils literal notranslate"><span class="pre">pci</span></code></a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/instance_units/">Units for storage and network limits</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/preseed_yaml_fields/">Preseed YAML file fields</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/projects/">Project configuration</a></li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../reference/storage_drivers/">Storage drivers</a><input aria-label="Toggle navigation of Storage drivers" class="toctree-checkbox" id="toctree-checkbox-18" name="toctree-checkbox-18" role="switch" type="checkbox"/><label for="toctree-checkbox-18"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../../reference/storage_dir/">Directory - <code class="docutils literal notranslate"><span class="pre">dir</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/storage_btrfs/">Btrfs - <code class="docutils literal notranslate"><span class="pre">btrfs</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/storage_lvm/">LVM - <code class="docutils literal notranslate"><span class="pre">lvm</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/storage_zfs/">ZFS - <code class="docutils literal notranslate"><span class="pre">zfs</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/storage_ceph/">Ceph RBD - <code class="docutils literal notranslate"><span class="pre">ceph</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/storage_powerflex/">Dell PowerFlex - <code class="docutils literal notranslate"><span class="pre">powerflex</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/storage_pure/">Pure Storage - <code class="docutils literal notranslate"><span class="pre">pure</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/storage_alletra/">HPE Alletra - <code class="docutils literal notranslate"><span class="pre">alletra</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/storage_cephfs/">CephFS - <code class="docutils literal notranslate"><span class="pre">cephfs</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/storage_cephobject/">Ceph Object - <code class="docutils literal notranslate"><span class="pre">cephobject</span></code></a></li>
</ul>
</li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../reference/networks/">Networks</a><input aria-label="Toggle navigation of Networks" class="toctree-checkbox" id="toctree-checkbox-19" name="toctree-checkbox-19" role="switch" type="checkbox"/><label for="toctree-checkbox-19"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../../reference/network_bridge/">Bridge network</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/network_ovn/">OVN network</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/network_macvlan/">Macvlan network</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/network_physical/">Physical network</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/network_sriov/">SR-IOV network</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/cluster_member_config/">Cluster configuration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/placement_groups/">Placement group configuration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/server_settings/">Production server settings</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/provided_metrics/">Provided metrics</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/permissions/">Permissions</a></li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../restapi_landing/">REST API</a><input aria-label="Toggle navigation of REST API" class="toctree-checkbox" id="toctree-checkbox-20" name="toctree-checkbox-20" role="switch" type="checkbox"/><label for="toctree-checkbox-20"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../../rest-api/">Main API documentation</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../api/">Main API specification</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../api-extensions/">Main API extensions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../events/">Events API documentation</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../dev-lxd/">Instance API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../reference/driver_csi/">LXD CSI driver reference</a></li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../reference/manpages/">Man pages</a><input aria-label="Toggle navigation of Man pages" class="toctree-checkbox" id="toctree-checkbox-21" name="toctree-checkbox-21" role="switch" type="checkbox"/><label for="toctree-checkbox-21"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../../reference/manpages/lxc/"><code class="docutils literal notranslate"><span class="pre">lxc</span></code></a></li>
</ul>
</li>
<li class="toctree-l2 has-children"><a class="reference internal" href="../../internals/">Internals</a><input aria-label="Toggle navigation of Internals" class="toctree-checkbox" id="toctree-checkbox-22" name="toctree-checkbox-22" role="switch" type="checkbox"/><label for="toctree-checkbox-22"><span class="icon"><svg><use href="#svg-arrow-right"></use></svg></span></label><ul>
<li class="toctree-l3"><a class="reference internal" href="../../environment/">Environment variables</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/uefi_variables/">UEFI variables for VMs</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../daemon-behavior/">Daemon behavior</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../syscall-interception/">System call interception</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../userns-idmap/">User namespace setup</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/ovn-internals/">OVN implementation</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/vm_live_migration_internals/">VM live migration implementation</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../reference/dqlite-internals/">Dqlite</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference external" href="https://github.com/canonical/lxd">Project repository</a></li>
<li class="toctree-l2"><a class="reference external" href="https://images.lxd.canonical.com">Image server</a></li>
</ul>
</li>
</ul>

</div>
</div>

      </div>
      
    </div>
  </aside>
  <div class="main">
    <div class="content">
      <div class="article-container">
        <a href="#" class="back-to-top muted-link">
          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
            <path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
          </svg>
          <span>Back to top</span>
        </a>
        <div class="content-icon-container">
          <div class="edit-this-page">
  <a class="muted-link" href="https://github.com/canonical/lxd/edit/main/doc/howto/storage_volumes.md" title="Contribute to this page">
    <svg><use href="#svg-pencil"></use></svg>
    <span class="visually-hidden">Contribute to this page</span>
  </a>
</div><div class="theme-toggle-container theme-toggle-content">
            <button class="theme-toggle" aria-label="Toggle Light / Dark / Auto color theme">
              <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
              <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
              <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
              <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
            </button>
          </div>
          <label class="toc-overlay-icon toc-content-icon" for="__toc">
            <span class="icon"><svg><use href="#svg-toc"></use></svg></span>
          </label>
        </div>
        <article role="main" id="furo-main-content">
          <section id="how-to-manage-storage-volumes">
<span id="howto-storage-volumes"></span><h1>How to manage storage volumes<a class="headerlink" href="#how-to-manage-storage-volumes" title="Link to this heading">¶</a></h1>

            <p class="youtube_link">
              <a href="https://www.youtube.com/watch?v=dvQ111pbqtk" target="_blank">
                <span title="Custom storage volumes in LXD" class="play_icon">▶</span>
                <span title="Custom storage volumes in LXD">Watch on YouTube</span>
              </a>
            </p>
        <p>See the following sections for instructions on how to create, configure, view and resize <a class="reference internal" href="../../explanation/storage/#storage-volumes"><span class="std std-ref">Storage volumes</span></a>.</p>
<section id="view-storage-volumes">
<h2>View storage volumes<a class="headerlink" href="#view-storage-volumes" title="Link to this heading">¶</a></h2>
<p>You can display a list of all available storage volumes and check their configuration.</p>
<div class="sphinx-tabs docutils container">
<div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-0-Q0xJ" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-0-Q0xJ" name="Q0xJ" role="tab" tabindex="0">CLI</button><button aria-controls="panel-0-VUk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-0-VUk=" name="VUk=" role="tab" tabindex="-1">UI</button></div><div aria-labelledby="tab-0-Q0xJ" class="sphinx-tabs-panel group-tab" id="panel-0-Q0xJ" name="Q0xJ" role="tabpanel" tabindex="0"><p>To list all available storage volumes, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume list
</pre></div>
</div>
<p>To display the storage volumes for all projects (not only the default project), add the <code class="docutils literal notranslate"><span class="pre">--all-projects</span></code> flag.</p>
<p>You can also display the storage volumes in a specific storage pool:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume list my-pool
</pre></div>
</div>
<p>The resulting table contains, among other information, the <a class="reference internal" href="../../explanation/storage/#storage-volume-types"><span class="std std-ref">storage volume type</span></a> and the <a class="reference internal" href="../../explanation/storage/#storage-content-types"><span class="std std-ref">content type</span></a> for each storage volume.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Custom storage volumes can use the same name as instance volumes. For example, you might have a container named <code class="docutils literal notranslate"><span class="pre">c1</span></code> with a container storage volume named <code class="docutils literal notranslate"><span class="pre">c1</span></code> and a custom storage volume named <code class="docutils literal notranslate"><span class="pre">c1</span></code>.
Therefore, to distinguish between instance storage volumes and custom storage volumes, all instance storage volumes must be referred to as <code class="docutils literal notranslate"><span class="pre">&lt;volume_type&gt;/&lt;volume_name&gt;</span></code> (for example, <code class="docutils literal notranslate"><span class="pre">container/c1</span></code> or <code class="docutils literal notranslate"><span class="pre">virtual-machine/vm</span></code>) in commands.</p>
</div>
<p>To show detailed configuration information about a specific volume, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume show my-pool custom/my-volume
</pre></div>
</div>
<p>To show state information about a specific volume, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume info my-pool virtual-machine/my-vm
</pre></div>
</div>
<p>In both commands, the default <a class="reference internal" href="../../explanation/storage/#storage-volume-types"><span class="std std-ref">storage volume type</span></a> is <code class="docutils literal notranslate"><span class="pre">custom</span></code>, so you can leave out the <code class="docutils literal notranslate"><span class="pre">custom/</span></code> when displaying information about a custom storage volume.</p>
</div><div aria-labelledby="tab-0-VUk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-0-VUk=" name="VUk=" role="tabpanel" tabindex="0"><p>From the main navigation, select <span class="guilabel">Storage</span> &gt; <span class="guilabel">Volumes</span>.
The resulting page displays a table of available volumes. You can sort volumes by their pool by clicking the <span class="guilabel">Pool</span> column header of the table.</p>
</div></div>
</section>
<section id="create-a-custom-storage-volume">
<h2>Create a custom storage volume<a class="headerlink" href="#create-a-custom-storage-volume" title="Link to this heading">¶</a></h2>
<p>When you create an instance, LXD automatically creates a storage volume that is used as the root disk for the instance.</p>
<p>You can add custom storage volumes to your instances.
Such custom storage volumes are independent of the instance, which means that they can be backed up separately and are retained until you delete them.
Custom storage volumes with content type <code class="docutils literal notranslate"><span class="pre">filesystem</span></code> can also be shared between different instances.</p>
<p>See <a class="reference internal" href="../../explanation/storage/#storage-volumes"><span class="std std-ref">Storage volumes</span></a> for detailed information.</p>
<section id="create-the-volume">
<h3>Create the volume<a class="headerlink" href="#create-the-volume" title="Link to this heading">¶</a></h3>
<div class="sphinx-tabs docutils container">
<div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-1-Q0xJ" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-1-Q0xJ" name="Q0xJ" role="tab" tabindex="0">CLI</button><button aria-controls="panel-1-VUk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-1-VUk=" name="VUk=" role="tab" tabindex="-1">UI</button></div><div aria-labelledby="tab-1-Q0xJ" class="sphinx-tabs-panel group-tab" id="panel-1-Q0xJ" name="Q0xJ" role="tabpanel" tabindex="0"><p>Use the following command to create a custom storage volume <code class="docutils literal notranslate"><span class="pre">vol1</span></code> of type <code class="docutils literal notranslate"><span class="pre">filesystem</span></code> in storage pool <code class="docutils literal notranslate"><span class="pre">my-pool</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume create my-pool vol1
</pre></div>
</div>
<p>By default, custom storage volumes use the <code class="docutils literal notranslate"><span class="pre">filesystem</span></code> <a class="reference internal" href="../../explanation/storage/#storage-content-types"><span class="std std-ref">content type</span></a>.
To create a custom volume with content type <code class="docutils literal notranslate"><span class="pre">block</span></code>, add the <code class="docutils literal notranslate"><span class="pre">--type</span></code> flag:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume create my-pool vol2 --type=block
</pre></div>
</div>
</div><div aria-labelledby="tab-1-VUk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-1-VUk=" name="VUk=" role="tabpanel" tabindex="0"><p>From the main navigation, select <span class="guilabel">Storage</span> &gt; <span class="guilabel">Volumes</span>.</p>
<p>On the resulting page, click <span class="guilabel">Create volume</span> in the upper-right corner.</p>
<p>You can then configure the name and size of your storage volume.</p>
<p>You can select a content type from the <span class="guilabel">Content type</span> dropdown. Additional settings might appear, depending on the content type selected.</p>
<p>Click <span class="guilabel">Create</span> to create the storage pool.</p>
<figure class="align-default">
<a class="reference internal image-reference" href="../../_images/storage_volumes_create.png"><img alt="Create a storage volume in LXD" src="../../_images/storage_volumes_create.png" style="width: 80%;" />
</a>
</figure>
</div></div>
</section>
<section id="attach-the-volume-to-an-instance">
<span id="storage-attach-volume"></span><h3>Attach the volume to an instance<a class="headerlink" href="#attach-the-volume-to-an-instance" title="Link to this heading">¶</a></h3>
<p>After creating a custom storage volume, you can add it to one or more instances as a <a class="reference internal" href="../../reference/devices_disk/#devices-disk"><span class="std std-ref">disk device</span></a>.</p>
<p>The following restrictions apply:</p>
<ul class="simple">
<li><p>Storage volumes of <a class="reference internal" href="../../explanation/storage/#storage-content-types"><span class="std std-ref">content type</span></a> <code class="docutils literal notranslate"><span class="pre">block</span></code> or <code class="docutils literal notranslate"><span class="pre">iso</span></code> cannot be attached to containers, only to virtual machines.</p></li>
<li><p>Storage volumes of <a class="reference internal" href="../../explanation/storage/#storage-content-types"><span class="std std-ref">content type</span></a> <code class="docutils literal notranslate"><span class="pre">block</span></code> that don’t have <code class="docutils literal notranslate"><span class="pre">security.shared</span></code> enabled cannot be attached to more than one instance at the same time.
Attaching a <code class="docutils literal notranslate"><span class="pre">block</span></code> volume to more than one instance at a time risks data corruption.</p></li>
<li><p>Storage volumes of <a class="reference internal" href="../../explanation/storage/#storage-content-types"><span class="std std-ref">content type</span></a> <code class="docutils literal notranslate"><span class="pre">iso</span></code> are always read-only, and can therefore be attached to more than one virtual machine at a time without corrupting data.</p></li>
<li><p>Storage volumes of <a class="reference internal" href="../../explanation/storage/#storage-content-types"><span class="std std-ref">content type</span></a> <code class="docutils literal notranslate"><span class="pre">filesystem</span></code> can’t be attached to virtual machines while they’re running.</p></li>
<li><p>You cannot attach a storage volume from a local storage pool (a pool that uses the <a class="reference internal" href="../../reference/storage_dir/#storage-dir"><span class="std std-ref">Directory</span></a>, <a class="reference internal" href="../../reference/storage_btrfs/#storage-btrfs"><span class="std std-ref">Btrfs</span></a>, <a class="reference internal" href="../../reference/storage_zfs/#storage-zfs"><span class="std std-ref">ZFS</span></a>, or <a class="reference internal" href="../../reference/storage_lvm/#storage-lvm"><span class="std std-ref">LVM</span></a> driver) to an instance that has <a class="configref reference internal" href="../../reference/instance_options/#instance-migration:migration.stateful"><code class="docutils literal notranslate"><span class="pre">migration.stateful</span></code></a> set to <code class="docutils literal notranslate"><span class="pre">true</span></code>. You must set <a class="configref reference internal" href="../../reference/instance_options/#instance-migration:migration.stateful"><code class="docutils literal notranslate"><span class="pre">migration.stateful</span></code></a> to <code class="docutils literal notranslate"><span class="pre">false</span></code> on the instance. Note that doing so makes the instance ineligible for <a class="reference internal" href="../instances_migrate/#live-migration"><span class="std std-ref">live migration</span></a>.</p></li>
</ul>
<div class="sphinx-tabs docutils container">
<div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-2-Q0xJ" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-2-Q0xJ" name="Q0xJ" role="tab" tabindex="0">CLI</button><button aria-controls="panel-2-VUk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-2-VUk=" name="VUk=" role="tab" tabindex="-1">UI</button></div><div aria-labelledby="tab-2-Q0xJ" class="sphinx-tabs-panel group-tab" id="panel-2-Q0xJ" name="Q0xJ" role="tabpanel" tabindex="0"><p>Use the following command to attach a custom storage volume <code class="docutils literal notranslate"><span class="pre">fs-vol</span></code> with content type <code class="docutils literal notranslate"><span class="pre">filesystem</span></code> to instance <code class="docutils literal notranslate"><span class="pre">c1</span></code>.
<code class="docutils literal notranslate"><span class="pre">/data</span></code> is the mount point for the storage volume inside the instance:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume attach my-pool fs-vol c1 /data
</pre></div>
</div>
<p>Custom storage volumes with the content type <code class="docutils literal notranslate"><span class="pre">block</span></code> do not take a mount point:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume attach my-pool bl-vol vm1
</pre></div>
</div>
<p>By default, custom storage volumes are added to the instance with the volume name as the <a class="reference internal" href="../../reference/devices/#devices"><span class="std std-ref">device</span></a> name.
If you want to use a different device name, you can add it to the command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume attach my-pool fs-vol c1 filesystem-volume /data
lxc storage volume attach my-pool bl-vol vm1 block-volume
</pre></div>
</div>
<p class="rubric" id="attach-the-volume-as-a-device">Attach the volume as a device</p>
<p>The <a class="reference internal" href="../../reference/manpages/lxc/storage/volume/attach/#lxc-storage-volume-attach-md"><span class="std std-ref"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">volume</span> <span class="pre">attach</span></code></span></a> command is a shortcut for adding a disk device to an instance.
The following commands have the same effect as the corresponding commands above:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc config device add c1 filesystem-volume disk pool=my-pool source=fs-vol path=/data
lxc config device add vm1 block-volume disk pool=my-pool source=bl-vol
</pre></div>
</div>
<p>This allows adding further configuration for the device.
See <a class="reference internal" href="../../reference/devices_disk/#devices-disk"><span class="std std-ref">disk device</span></a> for all available device options.</p>
<p class="rubric" id="configure-i-o-options"><span id="storage-configure-io"></span>Configure I/O options</p>
<p>When you attach a storage volume to an instance as a <a class="reference internal" href="../../reference/devices_disk/#devices-disk"><span class="std std-ref">disk device</span></a>, you can configure I/O limits for it.
To do so, set the <a class="configref reference internal" href="../../reference/devices_disk/#device-disk-device-conf:limits.read"><code class="docutils literal notranslate"><span class="pre">limits.read</span></code></a>, <a class="configref reference internal" href="../../reference/devices_disk/#device-disk-device-conf:limits.write"><code class="docutils literal notranslate"><span class="pre">limits.write</span></code></a> or <a class="configref reference internal" href="../../reference/devices_disk/#device-disk-device-conf:limits.max"><code class="docutils literal notranslate"><span class="pre">limits.max</span></code></a> options to the corresponding limits.
See the <a class="reference internal" href="../../reference/devices_disk/#devices-disk"><span class="std std-ref">Type: disk</span></a> reference for more information.</p>
<p>The limits are applied through the Linux <code class="docutils literal notranslate"><span class="pre">blkio</span></code> cgroup controller, which makes it possible to restrict I/O at the disk level (but nothing finer grained than that).</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Because the limits apply to a whole physical disk rather than a partition or path, the following restrictions apply:</p>
<ul class="simple">
<li><p>Limits will not apply to file systems that are backed by virtual devices (for example, device mapper).</p></li>
<li><p>If a file system is backed by multiple block devices, each device will get the same limit.</p></li>
<li><p>If two disk devices that are backed by the same disk are attached to the same instance, the limits of the two devices will be averaged.</p></li>
</ul>
</div>
<p>All I/O limits only apply to actual block device access.
Therefore, consider the file system’s own overhead when setting limits.
Access to cached data is not affected by the limit.</p>
<p>For VMs the way the disk is exposed to the guest and its behavior can be configured.
To do so, set the <a class="configref reference internal" href="../../reference/devices_disk/#device-disk-device-conf:io.bus"><code class="docutils literal notranslate"><span class="pre">io.bus</span></code></a>, <a class="configref reference internal" href="../../reference/devices_disk/#device-disk-device-conf:io.cache"><code class="docutils literal notranslate"><span class="pre">io.cache</span></code></a> or <a class="configref reference internal" href="../../reference/devices_disk/#device-disk-device-conf:io.threads"><code class="docutils literal notranslate"><span class="pre">io.threads</span></code></a> options.
See the <a class="reference internal" href="../../reference/devices_disk/#devices-disk"><span class="std std-ref">Type: disk</span></a> reference for more information.</p>
</div><div aria-labelledby="tab-2-VUk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-2-VUk=" name="VUk=" role="tabpanel" tabindex="0"><p>You can attach a storage volume to an existing instance, or when creating a new instance:</p>
<ul class="simple">
<li><p>For an existing instance, select <span class="guilabel">Instances</span> from the main navigation, then select the target instance to view its details page. Open its <span class="guilabel">Configuration</span> tab.</p></li>
<li><p>For a new instance, you must first select a base image during the instance creation process.</p></li>
</ul>
<p>In either scenario, then select <span class="guilabel">Disk</span> from the <span class="guilabel">Devices</span> section of the secondary menu.</p>
<p>Click <span class="guilabel">Attach disk device</span>.</p>
<figure class="align-default">
<a class="reference internal image-reference" href="../../_images/storage_volumes_attach_to_instance_1.png"><img alt="Attach a storage volume to an instance - Disk configuration page" src="../../_images/storage_volumes_attach_to_instance_1.png" style="width: 80%;" />
</a>
</figure>
<p>The resulting modal allows you to choose your disk type. Select <span class="guilabel">Attach custom volume</span>:</p>
<figure class="align-default">
<a class="reference internal image-reference" href="../../_images/storage_volumes_attach_to_instance_2.png"><img alt="Attach a storage volume to an instance - Attach disk device modal" src="../../_images/storage_volumes_attach_to_instance_2.png" style="width: 80%;" />
</a>
</figure>
<p>Next, you can either select a pre-existing volume to attach to the instance by clicking its corresponding <span class="guilabel">Select</span> button, or create a new custom volume by clicking <span class="guilabel">Create volume</span>:</p>
<figure class="align-default">
<a class="reference internal image-reference" href="../../_images/storage_volumes_attach_to_instance_3.png"><img alt="Attach a storage volume to an instance - Attach custom volume modal" src="../../_images/storage_volumes_attach_to_instance_3.png" style="width: 80%;" />
</a>
</figure>
<p>Once the modal closes, you might be required to add a mount point file path in the <span class="guilabel">Mount point</span> field.
Finally, you can save your instance changes. If you are in the instance creation process, create your instance by clicking <span class="guilabel">Create</span>.</p>
</div></div>
</section>
<section id="use-the-volume-for-backups-or-images">
<span id="storage-volume-special"></span><h3>Use the volume for backups or images<a class="headerlink" href="#use-the-volume-for-backups-or-images" title="Link to this heading">¶</a></h3>
<p>Instead of attaching a custom volume to an instance as a disk device, you can also use it as a special kind of volume to store <a class="reference internal" href="../../backup/#backups"><span class="std std-ref">backups</span></a> or <a class="reference internal" href="../../image-handling/#about-images"><span class="std std-ref">images</span></a>.</p>
<div class="sphinx-tabs docutils container">
<div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-3-Q0xJ" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-3-Q0xJ" name="Q0xJ" role="tab" tabindex="0">CLI</button><button aria-controls="panel-3-VUk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-3-VUk=" name="VUk=" role="tab" tabindex="-1">UI</button></div><div aria-labelledby="tab-3-Q0xJ" class="sphinx-tabs-panel group-tab" id="panel-3-Q0xJ" name="Q0xJ" role="tabpanel" tabindex="0"><p>To do so, you must set the corresponding <a class="reference internal" href="../../server/#server-options-misc"><span class="std std-ref">server configuration</span></a>:</p>
<ul>
<li><p>To use a custom volume <code class="docutils literal notranslate"><span class="pre">my-backups-volume</span></code> to store the backup tarballs:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc config set storage.backups_volume=my-pool/my-backups-volume
</pre></div>
</div>
</li>
<li><p>To use a custom volume <code class="docutils literal notranslate"><span class="pre">my-images-volume</span></code> to store the image tarballs:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc config set storage.images_volume=my-pool/my-images-volume
</pre></div>
</div>
</li>
</ul>
</div><div aria-labelledby="tab-3-VUk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-3-VUk=" name="VUk=" role="tabpanel" tabindex="0"><p>To use a volume to store backups or images, select <span class="guilabel">Settings</span> from the main navigation. From this page, set the value of the <span class="guilabel">storage.backups_volume</span> key or the <span class="guilabel">storage.images_volume</span> key to the name of the target storage volume, then select <span class="guilabel">Save</span>.</p>
</div></div>
</section>
</section>
<section id="configure-storage-volume-settings">
<span id="storage-configure-volume"></span><h2>Configure storage volume settings<a class="headerlink" href="#configure-storage-volume-settings" title="Link to this heading">¶</a></h2>
<p>See the <a class="reference internal" href="../../reference/storage_drivers/#storage-drivers"><span class="std std-ref">Storage drivers</span></a> documentation for a list of available storage volume configuration options for each driver.</p>
<div class="sphinx-tabs docutils container">
<div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-4-Q0xJ" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-4-Q0xJ" name="Q0xJ" role="tab" tabindex="0">CLI</button><button aria-controls="panel-4-VUk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-4-VUk=" name="VUk=" role="tab" tabindex="-1">UI</button></div><div aria-labelledby="tab-4-Q0xJ" class="sphinx-tabs-panel group-tab" id="panel-4-Q0xJ" name="Q0xJ" role="tabpanel" tabindex="0"><p>To set the maximum size of custom storage volume <code class="docutils literal notranslate"><span class="pre">my-volume</span></code> to 1 GiB, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume set my-pool my-volume size=1GiB
</pre></div>
</div>
<p>The default <a class="reference internal" href="../../explanation/storage/#storage-volume-types"><span class="std std-ref">storage volume type</span></a> is <code class="docutils literal notranslate"><span class="pre">custom</span></code>, but other volume types can be configured by using the <code class="docutils literal notranslate"><span class="pre">&lt;volume_type&gt;/&lt;volume_name&gt;</span></code> syntax.</p>
<p>To set the snapshot expiry time for virtual machine <code class="docutils literal notranslate"><span class="pre">my-vm</span></code> to one month, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume set my-pool virtual-machine/my-vm snapshots.expiry=1M
</pre></div>
</div>
<p>You can also edit the storage volume configuration as YAML in a text editor:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume edit my-pool virtual-machine/my-vm
</pre></div>
</div>
<p class="rubric" id="configure-default-values-for-storage-volumes"><span id="storage-configure-vol-default"></span>Configure default values for storage volumes</p>
<p>You can define default volume configurations for a storage pool.
To do so, set a storage pool configuration with a <code class="docutils literal notranslate"><span class="pre">volume</span></code> prefix: <code class="docutils literal notranslate"><span class="pre">volume.&lt;KEY&gt;=&lt;VALUE&gt;</span></code>.</p>
<p>This value is used for all new storage volumes in the pool, unless it is explicitly overridden.
In general, the defaults set at the storage pool level can be overridden through a volume’s configuration.
For storage volumes of <a class="reference internal" href="../../explanation/storage/#storage-volume-types"><span class="std std-ref">type</span></a> <code class="docutils literal notranslate"><span class="pre">container</span></code> or <code class="docutils literal notranslate"><span class="pre">virtual-machine</span></code>, the pool’s volume configuration can be overridden via the instance configuration.</p>
<p>For example, to set the default volume size for <code class="docutils literal notranslate"><span class="pre">my-pool</span></code>, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage set my-pool volume.size=15GiB
</pre></div>
</div>
<p class="rubric" id="attach-instance-root-volumes-to-other-instances">Attach instance root volumes to other instances</p>
<p>Virtual-machine root volumes can be attached as disk devices to other virtual machines.
In order to prevent concurrent access, <code class="docutils literal notranslate"><span class="pre">security.protection.start</span></code> must be set on
an instance before its root volume can be attached to another virtual-machine.</p>
<div class="admonition caution">
<p class="admonition-title">Caution</p>
<p>Because instances created from the same image share the same partition and file system
UUIDs and labels, booting an instance with two root file systems mounted may result
in the wrong root file system being used. This may result in unexpected behavior
or data loss. <strong>It is strongly recommended to only attach virtual-machine root
volumes to other virtual machines when the target virtual-machine is running.</strong></p>
</div>
<p>Assuming <code class="docutils literal notranslate"><span class="pre">vm1</span></code> is stopped and <code class="docutils literal notranslate"><span class="pre">vm2</span></code> is running, attach the <code class="docutils literal notranslate"><span class="pre">virtual-machine/vm1</span></code> storage
volume to <code class="docutils literal notranslate"><span class="pre">vm2</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc config set vm1 security.protection.start=true
lxc storage volume attach my-pool virtual-machine/vm1 vm2
</pre></div>
</div>
<p><code class="docutils literal notranslate"><span class="pre">virtual-machine/vm1</span></code> must be detached from <code class="docutils literal notranslate"><span class="pre">vm2</span></code> before <code class="docutils literal notranslate"><span class="pre">security.protection.start</span></code>
can be unset from <code class="docutils literal notranslate"><span class="pre">vm1</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume detach my-pool virtual-machine/vm1 vm2
lxc config unset vm1 security.protection.start
</pre></div>
</div>
<p><code class="docutils literal notranslate"><span class="pre">security.shared</span></code> can also be used on <code class="docutils literal notranslate"><span class="pre">virtual-machine</span></code> volumes to enable concurrent
access. Note that concurrent access to block volumes may result in data loss.</p>
<p class="rubric" id="attaching-virtual-machine-snapshots-to-other-instances">Attaching virtual machine snapshots to other instances</p>
<p>Virtual-machine snapshots can also be attached to instances with the
<a class="configref reference internal" href="../../reference/devices_disk/#device-disk-device-conf:source.snapshot"><code class="docutils literal notranslate"><span class="pre">source.snapshot</span></code></a> disk device
configuration key.</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc config device add v1 v2-root-snap0 disk pool=my-pool source=vm2 source.type=virtual-machine source.snapshot=snap0
</pre></div>
</div>
<p class="rubric" id="resize-a-storage-volume">Resize a storage volume</p>
<p>If you need more storage in a volume, you can increase the size of your storage volume.
In some cases, it is also possible to reduce the size of a storage volume.</p>
<p>To adjust a storage volume’s quota, set its <code class="docutils literal notranslate"><span class="pre">size</span></code> configuration.
For example, to resize <code class="docutils literal notranslate"><span class="pre">my-volume</span></code> in storage pool <code class="docutils literal notranslate"><span class="pre">my-pool</span></code> to <code class="docutils literal notranslate"><span class="pre">15GiB</span></code>, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage volume set my-pool my-volume size=15GiB
</pre></div>
</div>
<div class="admonition important">
<p class="admonition-title">Important</p>
<ul class="simple">
<li><p>Growing a volume is possible if the storage pool has sufficient storage.</p></li>
<li><p>Shrinking a storage volume is only possible for storage volumes with content type <code class="docutils literal notranslate"><span class="pre">filesystem</span></code>.
It is not guaranteed to work though, because you cannot shrink storage below its current used size.</p></li>
<li><p>Shrinking a storage volume with content type <code class="docutils literal notranslate"><span class="pre">block</span></code> is not possible.</p></li>
</ul>
</div>
</div><div aria-labelledby="tab-4-VUk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-4-VUk=" name="VUk=" role="tabpanel" tabindex="0"><p>To configure a custom storage volume, select <span class="guilabel">Storage</span> &gt; <span class="guilabel">Volumes</span> from the main navigation. Next, click the name of your target storage volume to view its details page.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Volume details pages are only available for volumes of type Custom. Volumes of other types—such as Instance root disks—can also be accessed from the Volumes page and redirect to their respective entity overview or list page.</p>
<p>To sort the Volumes table by type, you can click the <span class="guilabel">Content type</span> column header.</p>
</div>
<p>On the volume’s overview page, go to the <span class="guilabel">Configuration</span> tab. Here, you can configure settings such as the storage volume size. Further configuration options can be found in the secondary menu.
After making changes, click the <span class="guilabel">Save changes</span> button. This button also displays the number of changes you have made.</p>
</div></div>
</section>
<section id="create-a-storage-volume-in-a-cluster">
<h2>Create a storage volume in a cluster<a class="headerlink" href="#create-a-storage-volume-in-a-cluster" title="Link to this heading">¶</a></h2>
<p>For most storage drivers, custom storage volumes are not replicated across the cluster and exist only on the member for which they were created.
This behavior differs for remote storage pools (<code class="docutils literal notranslate"><span class="pre">ceph</span></code>, <code class="docutils literal notranslate"><span class="pre">cephfs</span></code> and <code class="docutils literal notranslate"><span class="pre">powerflex</span></code>), where volumes are available from any cluster member.</p>
<div class="sphinx-tabs docutils container">
<div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-5-Q0xJ" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-5-Q0xJ" name="Q0xJ" role="tab" tabindex="0">CLI</button><button aria-controls="panel-5-VUk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-5-VUk=" name="VUk=" role="tab" tabindex="-1">UI</button></div><div aria-labelledby="tab-5-Q0xJ" class="sphinx-tabs-panel group-tab" id="panel-5-Q0xJ" name="Q0xJ" role="tabpanel" tabindex="0"><p>To add a custom storage volume on a cluster member, add the <code class="docutils literal notranslate"><span class="pre">--target</span></code> flag:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>lxc<span class="w"> </span>storage<span class="w"> </span>volume<span class="w"> </span>create<span class="w"> </span>&lt;pool-name&gt;<span class="w"> </span>&lt;volume-name&gt;<span class="w"> </span>--target<span class="o">=</span>&lt;member-name&gt;
</pre></div>
</div>
<p>Example:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>lxc<span class="w"> </span>storage<span class="w"> </span>volume<span class="w"> </span>create<span class="w"> </span>my-pool<span class="w"> </span>my-volume<span class="w"> </span>--target<span class="o">=</span>my-member
</pre></div>
</div>
<p>To create a custom storage volume of type <code class="docutils literal notranslate"><span class="pre">iso</span></code>, use <code class="docutils literal notranslate"><span class="pre">import</span></code> instead of <code class="docutils literal notranslate"><span class="pre">create</span></code>:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>lxc<span class="w"> </span>storage<span class="w"> </span>volume<span class="w"> </span>import<span class="w"> </span>&lt;pool-name&gt;<span class="w"> </span>&lt;path-to-iso&gt;<span class="w"> </span>&lt;volume-name&gt;<span class="w"> </span>--type<span class="o">=</span>iso
</pre></div>
</div>
</div><div aria-labelledby="tab-5-VUk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-5-VUk=" name="VUk=" role="tabpanel" tabindex="0"><p>To create a storage volume in a clustered environment, select <span class="guilabel">Storage</span> &gt; <span class="guilabel">Volumes</span> from the main navigation. On the Volumes page, click <span class="guilabel">Create volume</span> in the upper-right corner.</p>
<p>On the volume creation page, select the cluster member on which to base the storage volume from the <span class="guilabel">Cluster member</span> dropdown. This dropdown is only available if the storage pool selected for this volume is cluster-member specific, rather than shared across the cluster.</p>
<figure class="align-default">
<a class="reference internal image-reference" href="../../_images/storage_volumes_create_clustered.png"><img alt="Create a custom storage volume in a clustered environment" src="../../_images/storage_volumes_create_clustered.png" style="width: 80%;" />
</a>
</figure>
</div></div>
<p>To find out more about clusters in LXD, see:</p>
<ul class="simple">
<li><p><a class="reference internal" href="../../clustering/#clustering"><span class="std std-ref">Clustering how-to guides</span></a></p></li>
<li><p><a class="reference internal" href="../../explanation/clusters/#exp-clusters"><span class="std std-ref">An explanation about clusters</span></a></p></li>
</ul>
</section>
</section>

        </article>
      </div>
      <footer>
        
   

<div class="related-pages">
  
  
      
  
  
  <a class="next-page" href="../storage_buckets/">
        <div class="page-info">
          <div class="context">
            <span>Next</span>
          </div>
          <div class="title">How to manage storage buckets</div>
        </div>
        <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
      </a>
    <a class="prev-page" href="../storage_pools/">
        <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
        <div class="page-info">
          <div class="context">
            <span>Previous</span>
          </div>
          
            <div class="title">How to manage storage pools</div>
          
        </div>
      </a>
</div>
<div class="bottom-of-page">
  <div class="left-details">
    <div class="copyright">
        &copy; 2014-2026 AGPL-3.0, LXD contributors 
    </div><div class="last-updated">
      Last updated on Feb 13, 2026</div>
  </div>
  <div class="right-details">
    
      <a href="" class="js-revoke-cookie-manager muted-link">Manage your tracker settings</a>
</div>

      </footer>
    </div>
    <aside class="toc-drawer">
      
<div class="toc-sticky toc-scroll">
   
    <div class="toc-title-container">
      <span class="toc-title">
       Contents
      </span>
    </div>
    <div class="toc-tree-container">
      <div class="toc-tree">
        <ul>
<li><a class="reference internal" href="#">How to manage storage volumes</a><ul>
<li><a class="reference internal" href="#view-storage-volumes">View storage volumes</a></li>
<li><a class="reference internal" href="#create-a-custom-storage-volume">Create a custom storage volume</a><ul>
<li><a class="reference internal" href="#create-the-volume">Create the volume</a></li>
<li><a class="reference internal" href="#attach-the-volume-to-an-instance">Attach the volume to an instance</a></li>
<li><a class="reference internal" href="#use-the-volume-for-backups-or-images">Use the volume for backups or images</a></li>
</ul>
</li>
<li><a class="reference internal" href="#configure-storage-volume-settings">Configure storage volume settings</a></li>
<li><a class="reference internal" href="#create-a-storage-volume-in-a-cluster">Create a storage volume in a cluster</a></li>
</ul>
</li>
</ul>

      </div>
    </div>
   
    
  </div>

    </aside>
  </div>
</div><script src="../../_static/jquery.js?v=5d32c60e"></script>
    <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
    <script src="../../_static/documentation_options.js?v=a5603611"></script>
    <script src="../../_static/doctools.js?v=9a2dae69"></script>
    <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
    <script src="../../_static/scripts/furo.js?v=46bd48cc"></script>
    <script src="../../_static/clipboard.min.js?v=a7894cd8"></script>
    <script src="../../_static/copybutton.js?v=b01cb6f2"></script>
    <script src="../../_static/config-options.js"></script>
    <script src="../../_static/design-tabs.js?v=f930bc37"></script>
    <script src="../../_static/tabs.js?v=3030b3cb"></script>
    <script src="../../_static/js/bundle.js?v=a4d88309"></script>
    <script src="../../_static/header-nav.js?v=e117ad08"></script>
    <script src="../../_static/github_issue_links.js?v=32bb732f"></script>
    
<script>
  const github_url = "https://github.com/canonical/lxd";
</script>
</body>
</html>