Your IP : 216.73.217.13

Current Path : /snap/lxd/current/share/lxd-documentation/howto/storage_pools/
Upload File :
Current File : //snap/lxd/current/share/lxd-documentation/howto/storage_pools/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 pools" />
<meta property="og:type" content="website" />
<meta property="og:url" content="/howto/storage_pools/" />
<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 pools. Create a storage pool: LXD creates a storage pool during initialization. You can add more sto..." />
<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 pools. Create a storage pool: LXD creates a storage pool during initialization. You can add more sto..." />

    <meta property="article:modified_time" content="2026-02-25T16:14:45+00:00" /><link rel="index" title="Index" href="../../genindex/"><link rel="search" title="Search" href="../../search/"><link rel="next" title="How to manage storage volumes" href="../storage_volumes/"><link rel="prev" title="Storage" href="../../storage/">
        <link rel="canonical" href="/howto/storage_pools/">

    <link rel="shortcut icon" href="../../_static/favicon.ico"><!-- Generated with Sphinx 7.4.7 and Furo 2025.12.19 -->
        <title>How to manage storage pools - 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 current current-page"><a class="current reference internal" href="#">Manage pools</a></li>
<li class="toctree-l3"><a class="reference internal" href="../storage_volumes/">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_pools.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-pools">
<span id="howto-storage-pools"></span><h1>How to manage storage pools<a class="headerlink" href="#how-to-manage-storage-pools" title="Link to this heading">¶</a></h1>
<p>See the following sections for instructions on how to create, configure, view and resize <a class="reference internal" href="../../explanation/storage/#storage-pools"><span class="std std-ref">Storage pools</span></a>.</p>
<section id="create-a-storage-pool">
<span id="storage-create-pool"></span><h2>Create a storage pool<a class="headerlink" href="#create-a-storage-pool" title="Link to this heading">¶</a></h2>
<p>LXD creates a storage pool during initialization. You can add more storage pools later, using the same driver or different drivers.</p>
<p>For Ceph-based storage pools, first see the <a class="reference internal" href="#howto-storage-pools-ceph-requirements"><span class="std std-ref">Requirements for Ceph-based storage pools</span></a> section.</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 create a storage pool, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create &lt;pool_name&gt; &lt;driver&gt; [configuration_options...]
</pre></div>
</div>
<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 configuration options for each driver.</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>To create a storage pool, select <span class="guilabel">Pools</span> from the <span class="guilabel">Storage</span> section of the main navigation.</p>
<p>On the resulting screen, click <span class="guilabel">Create pool</span> in the upper right corner.</p>
<p>From this screen, you can configure the name and description of your storage pool.
You can select a storage driver from the <span class="guilabel">Driver</span> dropdown. Additional settings might appear, depending on the storage driver 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_pools_create.png"><img alt="Create a storage pool in LXD" src="../../_images/storage_pools_create.png" style="width: 80%;" />
</a>
</figure>
</div></div>
<p>By default, LXD sets up loop-based storage with a sensible default size/quota: 20% of the free disk space, with a minimum of 5 GiB and a maximum of 30 GiB.</p>
<section id="examples">
<h3>Examples<a class="headerlink" href="#examples" 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>The following examples demonstrate how to create a storage pool using different types of storage drivers.</p>
<p class="rubric" id="create-a-directory-pool">Create a directory pool</p>
<p>Create a directory pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 dir
</pre></div>
</div>
<p>Use the existing directory <code class="docutils literal notranslate"><span class="pre">/data/lxd</span></code> for <code class="docutils literal notranslate"><span class="pre">pool2</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 dir source=/data/lxd
</pre></div>
</div>
<p class="rubric" id="create-a-btrfs-pool">Create a Btrfs pool</p>
<p>Create a loop-backed pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 btrfs
</pre></div>
</div>
<p>Use the existing Btrfs file system at <code class="docutils literal notranslate"><span class="pre">/some/path</span></code> for <code class="docutils literal notranslate"><span class="pre">pool2</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 btrfs source=/some/path
</pre></div>
</div>
<p>Create a pool named <code class="docutils literal notranslate"><span class="pre">pool3</span></code> on <code class="docutils literal notranslate"><span class="pre">/dev/sdX</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 btrfs source=/dev/sdX
</pre></div>
</div>
<p class="rubric" id="create-an-lvm-pool">Create an LVM pool</p>
<p>Create a loop-backed pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> (the LVM volume group will also be called <code class="docutils literal notranslate"><span class="pre">pool1</span></code>):</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 lvm
</pre></div>
</div>
<p>Use the existing LVM volume group called <code class="docutils literal notranslate"><span class="pre">my-pool</span></code> for <code class="docutils literal notranslate"><span class="pre">pool2</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 lvm source=my-pool
</pre></div>
</div>
<p>Use the existing LVM thin pool called <code class="docutils literal notranslate"><span class="pre">my-pool</span></code> in volume group <code class="docutils literal notranslate"><span class="pre">my-vg</span></code> for <code class="docutils literal notranslate"><span class="pre">pool3</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 lvm source=my-vg lvm.thinpool_name=my-pool
</pre></div>
</div>
<p>Create a pool named <code class="docutils literal notranslate"><span class="pre">pool4</span></code> on <code class="docutils literal notranslate"><span class="pre">/dev/sdX</span></code> (the LVM volume group will also be called <code class="docutils literal notranslate"><span class="pre">pool4</span></code>):</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool4 lvm source=/dev/sdX
</pre></div>
</div>
<p>Create a pool named <code class="docutils literal notranslate"><span class="pre">pool5</span></code> on <code class="docutils literal notranslate"><span class="pre">/dev/sdX</span></code> with the LVM volume group name <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 create pool5 lvm source=/dev/sdX lvm.vg_name=my-pool
</pre></div>
</div>
<p class="rubric" id="create-a-zfs-pool">Create a ZFS pool</p>
<p>Create a loop-backed pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> (the ZFS zpool will also be called <code class="docutils literal notranslate"><span class="pre">pool1</span></code>):</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 zfs
</pre></div>
</div>
<p>Create a loop-backed pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> with the ZFS zpool name <code class="docutils literal notranslate"><span class="pre">my-tank</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 zfs zfs.pool_name=my-tank
</pre></div>
</div>
<p>Use the existing ZFS zpool <code class="docutils literal notranslate"><span class="pre">my-tank</span></code> for <code class="docutils literal notranslate"><span class="pre">pool3</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 zfs source=my-tank
</pre></div>
</div>
<p>Use the existing ZFS dataset <code class="docutils literal notranslate"><span class="pre">my-tank/slice</span></code> for <code class="docutils literal notranslate"><span class="pre">pool4</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool4 zfs source=my-tank/slice
</pre></div>
</div>
<p>Use the existing ZFS dataset <code class="docutils literal notranslate"><span class="pre">my-tank/zvol</span></code> for <code class="docutils literal notranslate"><span class="pre">pool5</span></code> and configure it to use ZFS block mode:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool5 zfs source=my-tank/zvol volume.zfs.block_mode=yes
</pre></div>
</div>
<p>Create a pool named <code class="docutils literal notranslate"><span class="pre">pool6</span></code> on <code class="docutils literal notranslate"><span class="pre">/dev/sdX</span></code> (the ZFS zpool will also be called <code class="docutils literal notranslate"><span class="pre">pool6</span></code>):</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool6 zfs source=/dev/sdX
</pre></div>
</div>
<p>Create a pool named <code class="docutils literal notranslate"><span class="pre">pool7</span></code> on <code class="docutils literal notranslate"><span class="pre">/dev/sdX</span></code> with the ZFS zpool name <code class="docutils literal notranslate"><span class="pre">my-tank</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool7 zfs source=/dev/sdX zfs.pool_name=my-tank
</pre></div>
</div>
<p class="rubric" id="ceph-based-storage-pools">Ceph-based storage pools</p>
<p>For Ceph-based storage pools, first see the <a class="reference internal" href="#howto-storage-pools-ceph-requirements"><span class="std std-ref">Requirements for Ceph-based storage pools</span></a>.</p>
<p class="rubric" id="create-a-ceph-rbd-pool">Create a Ceph RBD pool</p>
<p>Create an OSD storage pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> in the default Ceph cluster (named <code class="docutils literal notranslate"><span class="pre">ceph</span></code>):</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 ceph
</pre></div>
</div>
<p>Create an OSD storage pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> in the Ceph cluster <code class="docutils literal notranslate"><span class="pre">my-cluster</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 ceph ceph.cluster_name=my-cluster
</pre></div>
</div>
<p>Create an OSD storage pool named <code class="docutils literal notranslate"><span class="pre">pool3</span></code> with the on-disk name <code class="docutils literal notranslate"><span class="pre">my-osd</span></code> in the default Ceph cluster:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 ceph ceph.osd.pool_name=my-osd
</pre></div>
</div>
<p>Use the existing OSD storage pool <code class="docutils literal notranslate"><span class="pre">my-already-existing-osd</span></code> for <code class="docutils literal notranslate"><span class="pre">pool4</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool4 ceph source=my-already-existing-osd
</pre></div>
</div>
<p>Use the existing OSD erasure-coded pool <code class="docutils literal notranslate"><span class="pre">ecpool</span></code> and the OSD replicated pool <code class="docutils literal notranslate"><span class="pre">rpl-pool</span></code> for <code class="docutils literal notranslate"><span class="pre">pool5</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool5 ceph source=rpl-pool ceph.osd.data_pool_name=ecpool
</pre></div>
</div>
<p class="rubric" id="create-a-cephfs-pool">Create a CephFS pool</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Each CephFS file system consists of two OSD storage pools, one for the actual data and one for the file metadata.</p>
</div>
<p>Use the existing CephFS file system <code class="docutils literal notranslate"><span class="pre">my-filesystem</span></code> for <code class="docutils literal notranslate"><span class="pre">pool1</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 cephfs source=my-filesystem
</pre></div>
</div>
<p>Use the sub-directory <code class="docutils literal notranslate"><span class="pre">my-directory</span></code> from the <code class="docutils literal notranslate"><span class="pre">my-filesystem</span></code> file system for <code class="docutils literal notranslate"><span class="pre">pool2</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 cephfs source=my-filesystem/my-directory
</pre></div>
</div>
<p>Create a CephFS file system <code class="docutils literal notranslate"><span class="pre">my-filesystem</span></code> with a data pool called <code class="docutils literal notranslate"><span class="pre">my-data</span></code> and a metadata pool called <code class="docutils literal notranslate"><span class="pre">my-metadata</span></code> for <code class="docutils literal notranslate"><span class="pre">pool3</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 cephfs source=my-filesystem cephfs.create_missing=true cephfs.data_pool=my-data cephfs.meta_pool=my-metadata
</pre></div>
</div>
<p class="rubric" id="create-a-ceph-object-pool">Create a Ceph Object pool</p>
<p>A RADOS Gateway endpoint is required for a <a class="reference internal" href="../../reference/storage_cephobject/#storage-cephobject"><span class="std std-ref">Ceph Object</span></a> storage pool. See: <a class="reference internal" href="#howto-storage-pools-ceph-requirements-radosgw"><span class="std std-ref">Ceph Object and radosgw</span></a>.</p>
<p>For a non-clustered LXD server, create <code class="docutils literal notranslate"><span class="pre">pool1</span></code> by passing in a Ceph Object Gateway endpoint (the endpoint shown below is only an example; you must use your own):</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>lxc<span class="w"> </span>storage<span class="w"> </span>create<span class="w"> </span>pool1<span class="w"> </span>cephobject<span class="w"> </span>cephobject.radosgw.endpoint<span class="o">=</span>http://192.0.2.10:8080
</pre></div>
</div>
<p>If your LXD server is clustered, such as in a <a class="reference external" href="https://canonical.com/microcloud">MicroCloud</a> deployment, see: <a class="reference internal" href="#storage-pools-cluster"><span class="std std-ref">Create a storage pool in a cluster</span></a>.</p>
<p class="rubric" id="create-a-dell-powerflex-pool">Create a Dell PowerFlex pool</p>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> using the PowerFlex pool <code class="docutils literal notranslate"><span class="pre">sp1</span></code> in the protection domain <code class="docutils literal notranslate"><span class="pre">pd1</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 powerflex powerflex.pool=sp1 powerflex.domain=pd1 powerflex.gateway=https://powerflex powerflex.user.name=lxd powerflex.user.password=foo
</pre></div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> using the ID of PowerFlex pool <code class="docutils literal notranslate"><span class="pre">sp1</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 powerflex powerflex.pool=&lt;ID of sp1&gt; powerflex.gateway=https://powerflex powerflex.user.name=lxd powerflex.user.password=foo
</pre></div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool3</span></code> that uses PowerFlex volume snapshots (see <a class="reference internal" href="../../reference/storage_powerflex/#storage-powerflex-limitations"><span class="std std-ref">Limitations</span></a>) when creating volume copies:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 powerflex powerflex.snapshot_copy=true powerflex.pool=&lt;id of sp1&gt; powerflex.gateway=https://powerflex powerflex.user.name=lxd powerflex.user.password=foo
</pre></div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool4</span></code> that uses a PowerFlex gateway with a certificate that is not trusted:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool4 powerflex powerflex.gateway.verify=false powerflex.pool=&lt;id of sp1&gt; powerflex.gateway=https://powerflex powerflex.user.name=lxd powerflex.user.password=foo
</pre></div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool5</span></code> that explicitly uses the PowerFlex SDC:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool5 powerflex powerflex.mode=sdc powerflex.pool=&lt;id of sp1&gt; powerflex.gateway=https://powerflex powerflex.user.name=lxd powerflex.user.password=foo
</pre></div>
</div>
<p class="rubric" id="create-a-pure-storage-pool">Create a Pure Storage pool</p>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> that uses NVMe/TCP by default:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 pure pure.gateway=https://&lt;pure-storage-address&gt; pure.api.token=&lt;pure-storage-api-token&gt;
</pre></div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> that uses a Pure Storage gateway with a certificate that is not trusted:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 pure pure.gateway=https://&lt;pure-storage-address&gt; pure.gateway.verify=false pure.api.token=&lt;pure-storage-api-token&gt;
</pre></div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool3</span></code> that uses iSCSI to connect to Pure Storage array:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 pure pure.gateway=https://&lt;pure-storage-address&gt; pure.api.token=&lt;pure-storage-api-token&gt; pure.mode=iscsi
</pre></div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool4</span></code> that uses NVMe/TCP to connect to Pure Storage array via specific target addresses:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool4 pure pure.gateway=https://&lt;pure-storage-address&gt; pure.api.token=&lt;pure-storage-api-token&gt; pure.mode=nvme pure.target=&lt;target_address_1&gt;,&lt;target_address_2&gt;
</pre></div>
</div>
<p class="rubric" id="create-a-hpe-alletra-pool">Create a HPE Alletra pool</p>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> that uses NVMe/TCP by default:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 alletra alletra.wsapi=https://&lt;alletra-storage-address&gt; alletra.user.name=&lt;alletra-storage-username&gt; alletra.user.password=&lt;alletra-storage-password&gt;
</pre></div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> that uses a HPE Alletra gateway with a certificate that is not trusted:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 alletra alletra.wsapi=https://&lt;alletra-storage-address&gt; alletra.wsapi.verify=false alletra.user.name=&lt;alletra-storage-username&gt; alletra.user.password=&lt;alletra-storage-password&gt;
</pre></div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">pool3</span></code> that uses NVMe/TCP to connect to HPE Alletra array via specific target addresses:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 alletra alletra.wsapi=https://&lt;alletra-storage-address&gt; alletra.user.name=&lt;alletra-storage-username&gt; alletra.user.password=&lt;alletra-storage-password&gt; alletra.mode=nvme alletra.target=&lt;target_address_1&gt;,&lt;target_address_2&gt;
</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>You can select a storage driver from the <span class="guilabel">Driver</span> dropdown.</p>
<p>Some storage drivers offer additional settings. Click the driver name in the secondary menu to further configure the storage pool.</p>
<figure class="align-default">
<a class="reference internal image-reference" href="../../_images/storage_pools_create_ZFS_driver.png"><img alt="Storage pool options for driver ZFS in LXD-UI" src="../../_images/storage_pools_create_ZFS_driver.png" style="width: 80%;" />
</a>
</figure>
<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 configuration options for each driver.</p>
</div></div>
</section>
</section>
<section id="create-a-storage-pool-in-a-cluster">
<span id="storage-pools-cluster"></span><h2>Create a storage pool in a cluster<a class="headerlink" href="#create-a-storage-pool-in-a-cluster" title="Link to this heading">¶</a></h2>
<p>If you are running a LXD cluster and want to add a storage pool, you must create the storage pool for each cluster member separately.
The reason for this is that the configuration, for example, the storage location or the size of the pool, might be different between cluster members.</p>
<p>If some cluster members use disks that already contain a LXD storage pool or you want to recover an existing remote storage pool,
refer to the <a class="reference internal" href="#storage-recover-pool"><span class="std std-ref">Recover a storage pool</span></a> section.</p>
<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>To create a storage pool via the CLI, start by creating a pending storage pool on each member with the <code class="docutils literal notranslate"><span class="pre">--target=&lt;cluster_member&gt;</span></code> flag and the appropriate configuration for the member.</p>
<p>Make sure to use the same storage pool name for all members.
Then create the storage pool without specifying the <code class="docutils literal notranslate"><span class="pre">--target</span></code> flag to actually set it up.</p>
<p>Also see <a class="reference internal" href="../cluster_config_storage/#cluster-config-storage"><span class="std std-ref">How to configure storage for a cluster</span></a>.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>For most storage drivers, the storage pools exist locally on each cluster member.
That means that if you create a storage volume in a storage pool on one member, it will not be available on other cluster members.</p>
<p>This behavior is different for Ceph-based 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">cephobject</span></code>) where each storage pool exists in one central location and therefore, all cluster members access the same storage pool with the same storage volumes.</p>
</div>
<p class="rubric" id="id1">Examples</p>
<p>See the following examples for different storage drivers for instructions on how to create local or remote storage pools in a cluster.</p>
<p class="rubric" id="create-a-local-storage-pool">Create a local storage pool</p>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">my-pool</span></code> using the ZFS driver at different locations and with different sizes on three cluster members:</p>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-pool</span> <span class="pre">zfs</span> <span class="pre">source=/dev/sdX</span> <span class="pre">size=10GiB</span> <span class="pre">--target=vm01</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-pool pending on member vm01
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-pool</span> <span class="pre">zfs</span> <span class="pre">source=/dev/sdX</span> <span class="pre">size=15GiB</span> <span class="pre">--target=vm02</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-pool pending on member vm02
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-pool</span> <span class="pre">zfs</span> <span class="pre">source=/dev/sdY</span> <span class="pre">size=10GiB</span> <span class="pre">--target=vm03</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-pool pending on member vm03
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-pool</span> <span class="pre">zfs</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-pool created
</pre></div>
</div>
</div>
<p class="rubric" id="create-a-remote-or-distributed-storage-pool">Create a remote or distributed storage pool</p>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">my-ceph-pool</span></code> using the <a class="reference internal" href="../../reference/storage_ceph/#storage-ceph"><span class="std std-ref">Ceph RBD driver</span></a> and the on-disk name <code class="docutils literal notranslate"><span class="pre">my-osd</span></code> on three cluster members.
Because the <a class="configref reference internal" href="../../reference/storage_ceph/#storage-ceph-pool-conf:ceph.osd.pool_name"><code class="docutils literal notranslate"><span class="pre">ceph.osd.pool_name</span></code></a> configuration setting isn’t member-specific, it must be set when creating the actual storage pool:</p>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-ceph-pool</span> <span class="pre">ceph</span> <span class="pre">--target=vm01</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-ceph-pool pending on member vm01
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-ceph-pool</span> <span class="pre">ceph</span> <span class="pre">--target=vm02</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-ceph-pool pending on member vm02
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-ceph-pool</span> <span class="pre">ceph</span> <span class="pre">--target=vm03</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-ceph-pool pending on member vm03
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-ceph-pool</span> <span class="pre">ceph</span> <span class="pre">ceph.osd.pool_name=my-osd</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-ceph-pool created
</pre></div>
</div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">my-cephobject-pool</span></code> using the <a class="reference internal" href="../../reference/storage_cephobject/#storage-cephobject"><span class="std std-ref">Ceph Object driver</span></a> and a preconfigured <a class="reference internal" href="#howto-storage-pools-ceph-requirements-radosgw"><span class="std std-ref">RADOS Gateway endpoint</span></a> (the endpoint shown below is only an example):</p>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-cephobject-pool</span> <span class="pre">cephobject</span> <span class="pre">--target=vm01</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-cephobject-pool pending on member vm01
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-cephobject-pool</span> <span class="pre">cephobject</span> <span class="pre">--target=vm02</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-cephobject-pool pending on member vm02
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-cephobject-pool</span> <span class="pre">cephobject</span> <span class="pre">--target=vm03</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-cephobject-pool pending on member vm03
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-cephobject-pool</span> <span class="pre">cephobject</span> <span class="pre">cephobject.radosgw.endpoint=http://192.0.2.10:8080</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-cephobject-pool created
</pre></div>
</div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">my-powerflex-pool</span></code> using the <a class="reference internal" href="../../reference/storage_powerflex/#storage-powerflex"><span class="std std-ref">Dell PowerFlex driver</span></a> in SDC mode and the pool <code class="docutils literal notranslate"><span class="pre">sp1</span></code> in protection domain <code class="docutils literal notranslate"><span class="pre">pd1</span></code>:</p>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-powerflex-pool</span> <span class="pre">powerflex</span> <span class="pre">--target=vm01</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-powerflex-pool pending on member vm01
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-powerflex-pool</span> <span class="pre">powerflex</span> <span class="pre">--target=vm02</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-powerflex-pool pending on member vm02
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-powerflex-pool</span> <span class="pre">powerflex</span> <span class="pre">--target=vm03</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-powerflex-pool pending on member vm03
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-powerflex-pool</span> <span class="pre">powerflex</span> <span class="pre">powerflex.mode=sdc</span> <span class="pre">powerflex.pool=sp1</span> <span class="pre">powerflex.domain=pd1</span> <span class="pre">powerflex.gateway=https://powerflex</span> <span class="pre">powerflex.user.name=lxd</span> <span class="pre">powerflex.user.password=foo</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-powerflex-pool created
</pre></div>
</div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">my-purestorage-pool</span></code> using the <a class="reference internal" href="../../reference/storage_pure/#storage-pure"><span class="std std-ref">Pure Storage driver</span></a>:</p>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-purestorage-pool</span> <span class="pre">pure</span> <span class="pre">--target=vm01</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-purestorage-pool pending on member vm01
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-purestorage-pool</span> <span class="pre">pure</span> <span class="pre">--target=vm02</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-purestorage-pool pending on member vm02
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">purestorage-pool</span> <span class="pre">pure</span> <span class="pre">--target=vm03</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool purestorage-pool pending on member vm03
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">purestorage-pool</span> <span class="pre">pure</span> <span class="pre">pure.gateway=https://&lt;pure-storage-address&gt;</span> <span class="pre">pure.api.token=&lt;pure-storage-api-token&gt;</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool purestorage-pool created
</pre></div>
</div>
</div>
<p>Create a storage pool named <code class="docutils literal notranslate"><span class="pre">my-alletrastorage-pool</span></code> using the <a class="reference internal" href="../../reference/storage_alletra/#storage-alletra"><span class="std std-ref">HPE Alletra driver</span></a>:</p>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-alletrastorage-pool</span> <span class="pre">alletra</span> <span class="pre">--target=vm01</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-alletrastorage-pool pending on member vm01
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-alletrastorage-pool</span> <span class="pre">alletra</span> <span class="pre">--target=vm02</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-alletrastorage-pool pending on member vm02
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">create</span> <span class="pre">my-alletrastorage-pool</span> <span class="pre">alletra</span> <span class="pre">--target=vm03</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-alletrastorage-pool pending on member vm03
</pre></div>
</div>
</div>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">user&#64;host:~$</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">my-alletrastorage-pool</span> <span class="pre">alletra</span> <span class="pre">alletra.wsapi=https://&lt;alletra-storage-address&gt;</span> <span class="pre">alletra.user.name=&lt;alletra-storage-username&gt;</span> <span class="pre">alletra.user.password=&lt;alletra-storage-password&gt;</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>Storage pool my-alletrastorage-pool created
</pre></div>
</div>
</div>
</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>To create a storage pool in a cluster, select <span class="guilabel">Pools</span> from the <span class="guilabel">Storage</span> section of the main navigation, then click <span class="guilabel">Create pool</span> in the upper right corner.</p>
<p>On the resulting page, configure the storage pool’s name and description. Depending on the selected driver, some settings can be configured per cluster member or applied globally to the cluster.</p>
<p>Finally, 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_pools_create_clustered_pool.png"><img alt="Create a storage pool in a clustered LXD environment" src="../../_images/storage_pools_create_clustered_pool.png" style="width: 80%;" />
</a>
</figure>
</div></div>
</section>
<section id="recover-a-storage-pool">
<span id="storage-recover-pool"></span><h2>Recover a storage pool<a class="headerlink" href="#recover-a-storage-pool" title="Link to this heading">¶</a></h2>
<p>You might need to recover a storage pool when setting up a new LXD server or cluster with non-pristine storage disks, or when trying to access remote storage that was previously used by another LXD deployment.</p>
<p>Using recovery, you can restore instances, custom volumes, and buckets that are still located on those storage pools.</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></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 recover a storage pool, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create &lt;pool_name&gt; &lt;driver&gt; source.recover=true [original_pool_configuration_options...]
</pre></div>
</div>
<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 configuration options for each driver.
The <code class="docutils literal notranslate"><span class="pre">lxd</span> <span class="pre">recover</span></code> command output also provides hints about missing storage pools and their original configuration, if such information can be discovered.</p>
</div></div>
<section id="get-storage-pool-configuration">
<h3>Get storage pool configuration<a class="headerlink" href="#get-storage-pool-configuration" title="Link to this heading">¶</a></h3>
<p>Before recovering a storage pool, you need to know its original configuration (driver type, source, and configuration keys).</p>
<p>See <a class="reference internal" href="../cluster_config_storage/#cluster-config-storage"><span class="std std-ref">How to configure storage for a cluster</span></a> to learn how to view and export storage pool configuration (use <a class="reference internal" href="../../reference/manpages/lxc/storage/show/#lxc-storage-show-md"><span class="std std-ref"><code class="docutils literal notranslate"><span class="pre">lxc</span> <span class="pre">storage</span> <span class="pre">show</span></code></span></a> with <code class="docutils literal notranslate"><span class="pre">--target</span></code> for member-specific settings in clusters).</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>For <a class="reference internal" href="../../reference/storage_drivers/#storage-drivers-features-local"><span class="std std-ref">local storage pools</span></a> in a cluster, the <code class="docutils literal notranslate"><span class="pre">source</span></code> value is member-specific and must be obtained from each cluster member. For <a class="reference internal" href="../../reference/storage_drivers/#storage-drivers-features-nonlocal"><span class="std std-ref">non-local storage pools</span></a>, the <code class="docutils literal notranslate"><span class="pre">source</span></code> is shared across all cluster members.</p>
</div>
</section>
<section id="id2">
<h3>Examples<a class="headerlink" href="#id2" 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-4-Q0xJ" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-4-Q0xJ" name="Q0xJ" role="tab" tabindex="0">CLI</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>The following examples demonstrate how to recover a storage pool using different types of storage drivers.</p>
<p class="rubric" id="recover-a-directory-pool">Recover a directory pool</p>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 dir source.recover=true source=/data/lxd
</pre></div>
</div>
<p class="rubric" id="recover-a-btrfs-pool">Recover a Btrfs pool</p>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> on the existing Btrfs filesystem at <code class="docutils literal notranslate"><span class="pre">/some/path</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 btrfs source.recover=true source=/some/path
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> on <code class="docutils literal notranslate"><span class="pre">/dev/sdX</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 btrfs source.recover=true source=/dev/sdX
</pre></div>
</div>
<p class="rubric" id="recover-a-lvm-pool">Recover a LVM pool</p>
<div class="tip admonition">
<p class="admonition-title">Existing LVM volume groups</p>
<p>Get a list of existing LVM volume groups by running <code class="docutils literal notranslate"><span class="pre">vgs</span></code>.</p>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> using the existing LVM volume group called <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 create pool1 lvm source.recover=true source=my-pool
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> using the existing LVM thin pool called <code class="docutils literal notranslate"><span class="pre">my-pool</span></code> in volume group <code class="docutils literal notranslate"><span class="pre">my-vg</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 lvm source.recover=true source=my-vg lvm.thinpool_name=my-pool
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool3</span></code> on <code class="docutils literal notranslate"><span class="pre">/dev/sdX</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 lvm source.recover=true source=/dev/sdX
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool4</span></code> on <code class="docutils literal notranslate"><span class="pre">/dev/sdX</span></code> with the LVM volume group name <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 create pool4 lvm source.recover=true source=/dev/sdX lvm.vg_name=my-pool
</pre></div>
</div>
<p class="rubric" id="recover-a-zfs-pool">Recover a ZFS pool</p>
<div class="tip admonition">
<p class="admonition-title">Existing ZFS pools</p>
<p>Get a list of existing ZFS pools by running <code class="docutils literal notranslate"><span class="pre">zpool</span> <span class="pre">list</span></code>.</p>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> using the existing ZFS pool <code class="docutils literal notranslate"><span class="pre">my-tank</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 zfs source.recover=true source=my-tank
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> using the existing ZFS dataset <code class="docutils literal notranslate"><span class="pre">my-tank/slice</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 zfs source.recover=true source=my-tank/slice
</pre></div>
</div>
<p class="rubric" id="recover-a-ceph-rbd-pool">Recover a Ceph RBD pool</p>
<div class="tip admonition">
<p class="admonition-title">Existing OSD pools</p>
<p>Get a list of existing OSD pools by running <code class="docutils literal notranslate"><span class="pre">ceph</span> <span class="pre">osd</span> <span class="pre">pool</span> <span class="pre">ls</span></code>.</p>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> using the existing OSD storage pool <code class="docutils literal notranslate"><span class="pre">my-osd</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 ceph source.recover=true source=my-osd
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> using the existing OSD storage pool <code class="docutils literal notranslate"><span class="pre">my-osd</span></code> in the Ceph cluster <code class="docutils literal notranslate"><span class="pre">my-cluster</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 ceph source.recover=true source=my-osd ceph.cluster_name=my-cluster
</pre></div>
</div>
<p class="rubric" id="recover-a-cephfs-pool">Recover a CephFS pool</p>
<div class="tip admonition">
<p class="admonition-title">Existing CephFS file systems</p>
<p>Get a list of existing CephFS file systems by running <code class="docutils literal notranslate"><span class="pre">ceph</span> <span class="pre">fs</span> <span class="pre">volume</span> <span class="pre">ls</span></code>.</p>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> using the existing CephFS file system <code class="docutils literal notranslate"><span class="pre">my-filesystem</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 cephfs source.recover=true source=my-filesystem
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> using the existing sub-directory <code class="docutils literal notranslate"><span class="pre">my-directory</span></code> on the Ceph FS file system <code class="docutils literal notranslate"><span class="pre">my-filesystem</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 cephfs source.recover=true source=my-filesystem/my-directory
</pre></div>
</div>
<p class="rubric" id="recover-a-ceph-object-pool">Recover a Ceph Object pool</p>
<p>The Ceph Object storage driver doesn’t require providing any additional configuration for recovery.
Use the regular Ceph object pool creation command for recovery.</p>
<p>Ceph Object does not yet support recovery of existing buckets already present on the <code class="docutils literal notranslate"><span class="pre">radosgw</span></code>.</p>
<p class="rubric" id="recover-a-dell-powerflex-pool">Recover a Dell PowerFlex pool</p>
<p>The PowerFlex storage driver doesn’t require providing any additional configuration for recovery as LXD is not creating any entities on
the storage array when creating a pool. Instead it uses an existing pool inside the respective protection domain.</p>
<p>Use the regular PowerFlex pool creation command for recovery.</p>
<p class="rubric" id="recover-a-pure-storage-pool">Recover a Pure Storage pool</p>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> using the existing pod <code class="docutils literal notranslate"><span class="pre">pool1</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 pure source.recover=true pure.gateway=https://&lt;pure-storage-address&gt; pure.api.token=&lt;pure-storage-api-token&gt;
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> using the existing pod <code class="docutils literal notranslate"><span class="pre">pool2</span></code> and iSCSI to connect to Pure Storage array:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 pure source.recover=true pure.gateway=https://&lt;pure-storage-address&gt; pure.api.token=&lt;pure-storage-api-token&gt; pure.mode=iscsi
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool3</span></code> using the existing pod <code class="docutils literal notranslate"><span class="pre">pool3</span></code> and NVMe/TCP to connect to Pure Storage array via specific target address:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 pure source.recover=true pure.gateway=https://&lt;pure-storage-address&gt; pure.api.token=&lt;pure-storage-api-token&gt; pure.mode=nvme pure.target=&lt;target_address_1&gt;,&lt;target_address_2&gt;
</pre></div>
</div>
<p class="rubric" id="recover-a-hpe-alletra-pool">Recover a HPE Alletra pool</p>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool1</span></code> using the existing volume set <code class="docutils literal notranslate"><span class="pre">pool1</span></code>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool1 alletra source.recover=true alletra.wsapi=https://&lt;alletra-storage-address&gt; alletra.user.name=&lt;alletra-storage-username&gt; alletra.user.password=&lt;alletra-storage-password&gt;
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool2</span></code> using the existing volume set <code class="docutils literal notranslate"><span class="pre">pool2</span></code> and accept a not trusted certificate of the HPE Alletra gateway:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool2 alletra source.recover=true alletra.wsapi=https://&lt;alletra-storage-address&gt; alletra.wsapi.verify=false alletra.user.name=&lt;alletra-storage-username&gt; alletra.user.password=&lt;alletra-storage-password&gt;
</pre></div>
</div>
<p>Recover a pool named <code class="docutils literal notranslate"><span class="pre">pool3</span></code> using the existing volume set <code class="docutils literal notranslate"><span class="pre">pool3</span></code> and NVMe/TCP to connect to HPE Alletra array via specific target address:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage create pool3 alletra source.recover=true alletra.wsapi=https://&lt;alletra-storage-address&gt; alletra.user.name=&lt;alletra-storage-username&gt; alletra.user.password=&lt;alletra-storage-password&gt; alletra.mode=nvme alletra.target=&lt;target_address_1&gt;,&lt;target_address_2&gt;
</pre></div>
</div>
</div></div>
</section>
</section>
<section id="configure-storage-pool-settings">
<h2>Configure storage pool settings<a class="headerlink" href="#configure-storage-pool-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 the available configuration options for each storage driver.</p>
<p>General keys for a storage pool (like <code class="docutils literal notranslate"><span class="pre">source</span></code>) are top-level.
Driver-specific keys are namespaced by the driver name.</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>Use the following command to set configuration options for a storage pool:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage set &lt;pool_name&gt; &lt;key&gt; &lt;value&gt;
</pre></div>
</div>
<p>For example, to turn off compression during storage pool migration for a <code class="docutils literal notranslate"><span class="pre">dir</span></code> storage pool, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage set my-dir-pool rsync.compression false
</pre></div>
</div>
<p>You can also edit the storage pool configuration by using the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage edit &lt;pool_name&gt;
</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 configure a storage pool, select <span class="guilabel">Pools</span> from the <span class="guilabel">Storage</span> section of the Main navigation.</p>
<p>The resulting screen shows a list of existing storage pools. Click a pool’s name to access its details.</p>
<p>Go to the <span class="guilabel">Configuration</span> tab. Here, you can configure settings such as the storage pool description.</p>
<p>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="view-storage-pools">
<h2>View storage pools<a class="headerlink" href="#view-storage-pools" title="Link to this heading">¶</a></h2>
<p>You can display a list of all available storage pools and check their configuration.</p>
<div class="sphinx-tabs docutils container">
<div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-6-Q0xJ" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-6-Q0xJ" name="Q0xJ" role="tab" tabindex="0">CLI</button><button aria-controls="panel-6-VUk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-6-VUk=" name="VUk=" role="tab" tabindex="-1">UI</button></div><div aria-labelledby="tab-6-Q0xJ" class="sphinx-tabs-panel group-tab" id="panel-6-Q0xJ" name="Q0xJ" role="tabpanel" tabindex="0"><p>Use the following command to list all available storage pools:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage list
</pre></div>
</div>
<p>The resulting table contains the storage pool that you created during initialization (usually called <code class="docutils literal notranslate"><span class="pre">default</span></code> or <code class="docutils literal notranslate"><span class="pre">local</span></code>) and any storage pools that you added.</p>
<p>To show detailed information about a specific pool, use the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage show &lt;pool_name&gt;
</pre></div>
</div>
<p>To see usage information for a specific pool, run the following command:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage info &lt;pool_name&gt;
</pre></div>
</div>
</div><div aria-labelledby="tab-6-VUk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-6-VUk=" name="VUk=" role="tabpanel" tabindex="0"><p>To view available storage pools in the UI, select <span class="guilabel">Pools</span> from the <span class="guilabel">Storage</span> section of the main navigation.</p>
</div></div>
</section>
<section id="resize-a-storage-pool">
<span id="storage-resize-pool"></span><h2>Resize a storage pool<a class="headerlink" href="#resize-a-storage-pool" title="Link to this heading">¶</a></h2>
<p>If you need more storage, you can increase the size (quota) of your storage pool. You can only grow the pool (increase its size), not shrink it.</p>
<div class="sphinx-tabs docutils container">
<div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-7-Q0xJ" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-7-Q0xJ" name="Q0xJ" role="tab" tabindex="0">CLI</button><button aria-controls="panel-7-VUk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-7-VUk=" name="VUk=" role="tab" tabindex="-1">UI</button></div><div aria-labelledby="tab-7-Q0xJ" class="sphinx-tabs-panel group-tab" id="panel-7-Q0xJ" name="Q0xJ" role="tabpanel" tabindex="0"><p>In the CLI, resize a storage pool by changing the <code class="docutils literal notranslate"><span class="pre">size</span></code> configuration key:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lxc storage set &lt;pool_name&gt; size=&lt;new_size&gt;
</pre></div>
</div>
<p>This will only work for loop-backed storage pools that are managed by LXD.</p>
</div><div aria-labelledby="tab-7-VUk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-7-VUk=" name="VUk=" role="tabpanel" tabindex="0"><p>To resize a storage pool in the UI, select <span class="guilabel">Pools</span> from the <span class="guilabel">Storage </span> section of the main navigation.</p>
<p>Click the name of a storage pool to open its details page, then go to its <span class="guilabel">Configuration</span> tab. Edit the <span class="guilabel">Size</span> field.</p>
<p>After making changes, click the <span class="guilabel">Save changes</span> button. This button also displays the number of changes you have made.</p>
<p>In clustered environments, the <span class="guilabel">Size</span> field appears as a per-member selector, allowing you to configure the size for each cluster member.</p>
<figure class="align-default">
<a class="reference internal image-reference" href="../../_images/storage_pools_create_clustered_pool_size_config.png"><img alt="Configuring storage pools sizes within a clustered environment." src="../../_images/storage_pools_create_clustered_pool_size_config.png" style="width: 80%;" />
</a>
</figure>
</div></div>
</section>
<section id="requirements-for-ceph-based-storage-pools">
<span id="howto-storage-pools-ceph-requirements"></span><h2>Requirements for Ceph-based storage pools<a class="headerlink" href="#requirements-for-ceph-based-storage-pools" title="Link to this heading">¶</a></h2>
<p>For Ceph-based storage pools, the requirements below must be met before you can <a class="reference internal" href="#storage-create-pool"><span class="std std-ref">Create a storage pool</span></a> or <a class="reference internal" href="#storage-pools-cluster"><span class="std std-ref">Create a storage pool in a cluster</span></a>.</p>
<section id="ceph-cluster">
<span id="howto-storage-pools-ceph-requirements-cluster"></span><h3>Ceph cluster<a class="headerlink" href="#ceph-cluster" title="Link to this heading">¶</a></h3>
<p>Before you can create a storage pool that uses the <a class="reference internal" href="../../reference/storage_ceph/#storage-ceph"><span class="std std-ref">Ceph RBD</span></a>, <a class="reference internal" href="../../reference/storage_cephfs/#storage-cephfs"><span class="std std-ref">CephFS</span></a>, or <a class="reference internal" href="../../reference/storage_cephobject/#storage-cephobject"><span class="std std-ref">Ceph Object</span></a> driver, you must have access to a <a class="reference external" href="https://ceph.io">Ceph</a> cluster.</p>
<p>To deploy a Ceph cluster, we recommend using <a class="reference external" href="https://snapcraft.io/microcloud">MicroCloud</a>. If you have completed the default MicroCloud setup, you already have a Ceph cluster deployed through MicroCeph, so this requirement is met. MicroCeph is a lightweight way of deploying and managing a Ceph cluster.</p>
<p>If you do not use MicroCloud, set up a standalone deployment of <a class="reference external" href="https://snapcraft.io/microceph">MicroCeph</a> before you continue.</p>
</section>
<section id="ceph-object-and-radosgw">
<span id="howto-storage-pools-ceph-requirements-radosgw"></span><h3>Ceph Object and <code class="docutils literal notranslate"><span class="pre">radosgw</span></code><a class="headerlink" href="#ceph-object-and-radosgw" title="Link to this heading">¶</a></h3>
<p>Storage pools that use the <a class="reference internal" href="../../reference/storage_cephobject/#storage-cephobject"><span class="std std-ref">Ceph Object driver</span></a> require a Ceph cluster with the RADOS Gateway (also known as RGW or <code class="docutils literal notranslate"><span class="pre">radosgw</span></code>) enabled.</p>
<section id="check-if-radosgw-is-already-enabled">
<span id="howto-storage-pools-ceph-requirements-radosgw-check"></span><h4>Check if <code class="docutils literal notranslate"><span class="pre">radosgw</span></code> is already enabled<a class="headerlink" href="#check-if-radosgw-is-already-enabled" title="Link to this heading">¶</a></h4>
<p>To check if the RADOS Gateway is already enabled in MicroCeph, run this command from one of its cluster members:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>microceph<span class="w"> </span>status
</pre></div>
</div>
<p>In the output, look for a cluster member with <code class="docutils literal notranslate"><span class="pre">rgw</span></code> in its <code class="docutils literal notranslate"><span class="pre">Services</span></code> list.</p>
<p>Example:</p>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">root&#64;micro1:~#</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">microceph</span> <span class="pre">status</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>MicroCeph deployment summary:
- micro1 (192.0.2.10)
  Services: mds, mgr, mon, rgw, osd
  Disks: 1
- micro2 (192.0.2.20)
  Services: mds, mgr, mon, osd
  Disks: 1
</pre></div>
</div>
</div>
<p>In the output above, notice <code class="docutils literal notranslate"><span class="pre">rgw</span></code> in the list of <code class="docutils literal notranslate"><span class="pre">Services</span></code> for <code class="docutils literal notranslate"><span class="pre">micro1</span></code>. This means that this cluster member is running the RADOS Gateway.</p>
<p>Look for <code class="docutils literal notranslate"><span class="pre">rgw</span></code> in your output. If you do not see it, you must <a class="reference internal" href="#howto-storage-pools-ceph-requirements-radosgw-enable"><span class="std std-ref">Enable radosgw</span></a>.</p>
<p>If you do see it, you’ll need the corresponding port number. On the cluster member with the <code class="docutils literal notranslate"><span class="pre">rgw</span></code> service, run:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>ss<span class="w"> </span>-ltnp<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>radosgw
</pre></div>
</div>
<p>Example:</p>
<div class="terminal docutils container">
<div class="input docutils container">
<div class="prompt docutils container">
<code class="docutils literal notranslate"><span class="pre">root&#64;micro1:~#</span> </code></div>
<span class="command"><code class="docutils literal notranslate"><span class="pre">sudo</span> <span class="pre">ss</span> <span class="pre">-ltnp</span> <span class="pre">|</span> <span class="pre">grep</span> <span class="pre">radosgw</span>
</code></span></div>
<div class="terminal-code highlight-text notranslate"><div class="highlight"><pre><span></span>LISTEN 0      4096         0.0.0.0:8080      0.0.0.0:*    users:((&quot;radosgw&quot;,pid=11345,fd=60))
LISTEN 0      4096            [::]:8080         [::]:*    users:((&quot;radosgw&quot;,pid=11345,fd=61))
</pre></div>
</div>
</div>
<p>The output above shows that the <code class="docutils literal notranslate"><span class="pre">radosgw</span></code> port number is <code class="docutils literal notranslate"><span class="pre">8080</span></code>.</p>
</section>
<section id="enable-radosgw">
<span id="howto-storage-pools-ceph-requirements-radosgw-enable"></span><h4>Enable <code class="docutils literal notranslate"><span class="pre">radosgw</span></code><a class="headerlink" href="#enable-radosgw" title="Link to this heading">¶</a></h4>
<p>If you did not find <code class="docutils literal notranslate"><span class="pre">rgw</span></code> in the <code class="docutils literal notranslate"><span class="pre">Services</span></code> list for any of your cluster members in the output from <code class="docutils literal notranslate"><span class="pre">microceph</span> <span class="pre">status</span></code>, then you must enable the RADOS Gateway. On one of the Ceph cluster members, run:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>microceph<span class="w"> </span><span class="nb">enable</span><span class="w"> </span>rgw<span class="w"> </span>--port<span class="w"> </span><span class="m">8080</span>
</pre></div>
</div>
<p>We include the <code class="docutils literal notranslate"><span class="pre">--port</span> <span class="pre">8080</span></code> flag because if unspecified, the default port is <code class="docutils literal notranslate"><span class="pre">80</span></code>. This default is a commonly used port number that can often cause conflicts with other services. You are not required to use <code class="docutils literal notranslate"><span class="pre">8080</span></code> — if needed, use a different port number.</p>
</section>
<section id="the-rados-gateway-endpoint">
<span id="howto-storage-pools-ceph-requirements-radosgw-endpoint"></span><h4>The RADOS Gateway endpoint<a class="headerlink" href="#the-rados-gateway-endpoint" title="Link to this heading">¶</a></h4>
<p>The full RADOS Gateway endpoint includes the HTTP protocol, the IP address of the Ceph cluster member where the <code class="docutils literal notranslate"><span class="pre">rgw</span></code> service is enabled, and the port number specified. Example: <code class="docutils literal notranslate"><span class="pre">http://192.0.2.10:8080</span></code>.</p>
</section>
</section>
</section>
</section>

        </article>
      </div>
      <footer>
        
   

<div class="related-pages">
  
  
      
  
  
  <a class="next-page" href="../storage_volumes/">
        <div class="page-info">
          <div class="context">
            <span>Next</span>
          </div>
          <div class="title">How to manage storage volumes</div>
        </div>
        <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
      </a>
    <a class="prev-page" href="../../storage/">
        <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">Storage</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 25, 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 pools</a><ul>
<li><a class="reference internal" href="#create-a-storage-pool">Create a storage pool</a><ul>
<li><a class="reference internal" href="#examples">Examples</a></li>
</ul>
</li>
<li><a class="reference internal" href="#create-a-storage-pool-in-a-cluster">Create a storage pool in a cluster</a></li>
<li><a class="reference internal" href="#recover-a-storage-pool">Recover a storage pool</a><ul>
<li><a class="reference internal" href="#get-storage-pool-configuration">Get storage pool configuration</a></li>
<li><a class="reference internal" href="#id2">Examples</a></li>
</ul>
</li>
<li><a class="reference internal" href="#configure-storage-pool-settings">Configure storage pool settings</a></li>
<li><a class="reference internal" href="#view-storage-pools">View storage pools</a></li>
<li><a class="reference internal" href="#resize-a-storage-pool">Resize a storage pool</a></li>
<li><a class="reference internal" href="#requirements-for-ceph-based-storage-pools">Requirements for Ceph-based storage pools</a><ul>
<li><a class="reference internal" href="#ceph-cluster">Ceph cluster</a></li>
<li><a class="reference internal" href="#ceph-object-and-radosgw">Ceph Object and <code class="docutils literal notranslate"><span class="pre">radosgw</span></code></a><ul>
<li><a class="reference internal" href="#check-if-radosgw-is-already-enabled">Check if <code class="docutils literal notranslate"><span class="pre">radosgw</span></code> is already enabled</a></li>
<li><a class="reference internal" href="#enable-radosgw">Enable <code class="docutils literal notranslate"><span class="pre">radosgw</span></code></a></li>
<li><a class="reference internal" href="#the-rados-gateway-endpoint">The RADOS Gateway endpoint</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>

      </div>
    </div>
   
    
    <div class="relatedlinks-title-container">
      <span class="relatedlinks-title">
       Related links
      </span>
    </div>
    <div class="relatedlinks-container">
      <div class="relatedlinks">
        
          <ul><li><a href="https://discuss.linuxcontainers.org/t/1333" target="_blank">How&#32;to&#32;resize&#32;ZFS&#32;used&#32;in&#32;LXD</a></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>