docs/stable/end-user-guide/requesting-persistent-storage-for-workspaces/index.html - www.eclipse.org/che - Git at Google

 <!DOCTYPE html>
 <html lang="en">
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
     <title>Requesting persistent storage for workspaces :: Eclipse Che Documentation</title>
     <link rel="canonical" href="https://www.eclipse.org/che/docs/stable/end-user-guide/requesting-persistent-storage-for-workspaces/">
     <meta name="description" content="Requesting persistent storage for workspaces">
     <meta name="keywords" content="user-guide, configuring, user, volumes, persistent, volume, claim, mounting, mount">
     <meta name="generator" content="Antora 3.1.7">
     <link rel="stylesheet" href="../../../../docs/_/css/site.css">
 <link rel="stylesheet" href="../../../../docs/_/css/extra.css">
 <link rel="stylesheet" href="../../../../docs/_/font-awesome-4.7.0/css/font-awesome.min.css">
 <link rel="icon" href="../../../../docs/_/img/favicon.ico" type="image/x-icon">
 <script>var uiRootPath = '../../../../docs/_'</script>
     <script async src="https://www.googletagmanager.com/gtag/js?id=UA-37306001-2"></script>
     <script>function gtag(){dataLayer.push(arguments)};window.dataLayer=window.dataLayer||[];gtag('js',new Date());gtag('config','UA-37306001-2')</script>
   </head>
   <body class="article">
 <header class="header">
   <nav class="navbar">
     <div class="navbar-brand">
       <div class="navbar-item">
         <button class="navbar-burger" data-target="topbar-nav">
           <span></span>
           <span></span>
           <span></span>
         </button>
         <img src="../../../../docs/_/img/icon-eclipse-che.svg" class="navbar-logo" alt="Eclipse Che logo">
         <a href="https://www.eclipse.org/che/docs/index.html">Eclipse Che Documentation</a>
       </div>
     </div>
     <div id="topbar-nav" class="navbar-menu">
       <div class="navbar-end">
         <div class="navbar-item search hide-for-print">
           <div id="search-field" class="field">
             <input id="search-input" type="text" placeholder="Search the docs">
           </div>
         </div>
         <a class="navbar-item" href="https://www.eclipse.org/che/">Home</a>
         <a class="navbar-item" href="https://che.eclipseprojects.io/">Blog</a>
         <a class="navbar-item" href="https://github.com/eclipse/che">Source Code</a>
       </div>
     </div>
   </nav>
 </header>
 <div class="body">
 <div class="nav-container" data-component="docs" data-version="7.82.x">
   <aside class="nav">
     <div class="panels">
 <div class="nav-panel-menu is-active" data-panel="menu">
   <nav class="nav-menu">
     <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
     <h3 class="title"><a href="../../overview/introduction-to-eclipse-che/">Documentation</a></h3>
 <ul class="nav-list">
   <li class="nav-item" data-depth="0">
 <ul class="nav-list">
   <li class="nav-item" data-depth="1">
     <a class="nav-link" href="../../overview/introduction-to-eclipse-che/">Introduction to Che</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="0">
 <ul class="nav-list">
   <li class="nav-item" data-depth="1">
     <a class="nav-link" href="../../hosted-che/hosted-che/">Eclipse Che hosted by Red Hat</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="0">
     <button class="nav-item-toggle"></button>
     <span class="nav-text">User Guide</span>
 <ul class="nav-list">
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../getting-started-with-che/">Getting started with Che</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../starting-a-workspace-from-a-git-repository-url/">Starting a workspace from a Git repository URL</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../optional-parameters-for-the-urls-for-starting-a-new-workspace/">Optional parameters for the URLs for starting a new workspace</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../url-parameter-concatenation/">URL parameter concatenation</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../url-parameter-for-the-ide/">URL parameter for the IDE</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../url-parameter-for-the-ide-image/">URL parameter for the IDE image</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../url-parameter-for-starting-duplicate-workspaces/">URL parameter for starting duplicate workspaces</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../url-parameter-for-the-devfile-file-name/">URL parameter for the devfile file name</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../url-parameter-for-the-devfile-file-path/">URL parameter for the devfile file path</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../url-parameter-for-the-workspace-storage/">URL parameter for the workspace storage</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../url-parameter-for-additional-remotes/">URL parameter for additional remotes</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../url-parameter-for-container-image/">URL parameter for a container image</a>
   </li>
 </ul>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../starting-a-workspace-from-a-raw-devfile-url/">Starting a workspace from a raw devfile URL</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../basic-actions-you-can-perform-on-a-workspace/">Basic actions you can perform on a workspace</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../authenticating-to-a-git-server-from-a-workspace/">Authenticating to a Git server from a workspace</a>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../using-the-fuse-overlay-storage-driver/">Using the fuse-overlayfs storage driver for Podman and Buildah</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../accessing-fuse/">Accessing /dev/fuse</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../enabling-overlay-with-a-configmap/">Enabling fuse-overlayfs with a ConfigMap</a>
   </li>
 </ul>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../using-che-in-team-workflow/">Using Che in team workflow</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../first-time-contributors/">Badge for first-time contributors</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../benefits-of-pull-requests-review-in-che/">Reviewing pull and merge requests</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../try-in-web-ide-github-action/">Try in Web IDE GitHub action</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="1">
     <a class="nav-link" href="../customizing-workspace-components/">Customizing workspace components</a>
   </li>
   <li class="nav-item" data-depth="1">
     <a class="nav-link" href="../devfile-introduction/">Introduction to devfile in Che</a>
   </li>
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../ides-in-workspaces/">IDEs in workspaces</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../microsoft-visual-studio-code-open-source-ide/">Microsoft Visual Studio Code - Open Source</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../defining-a-common-ide/">Defining a common IDE</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../using-credentials-and-configurations-in-workspaces/">Using credentials and configurations in workspaces</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../mounting-secrets/">Mounting Secrets</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../creating-image-pull-secrets/">Creating image pull Secrets</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../using-a-git-provider-access-token/">Using a Git-provider access token</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../mounting-configmaps/">Mounting ConfigMaps</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../mounting-git-configuration/">Mounting Git configuration</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../enabling-artifact-repositories-in-a-restricted-environment/">Enabling artifact repositories in a restricted environment</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../enabling-maven-artifact-repositories/">Maven</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../enabling-gradle-artifact-repositories/">Gradle</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../enabling-npm-artifact-repositories/">npm</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../enabling-python-artifact-repositories/">Python</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../enabling-go-artifact-repositories/">Go</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../enabling-nuget-artifact-repositories/">NuGet</a>
   </li>
 </ul>
   </li>
 </ul>
   </li>
   <li class="nav-item is-current-page" data-depth="1">
     <a class="nav-link" href="./">Requesting persistent storage for workspaces</a>
   </li>
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../integrating-with-kubernetes/">Integrating with Kubernetes</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../managing-workspaces-with-apis/">Managing workspaces with Kubernetes APIs</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../automatic-token-injection/">Automatic Kubernetes token injection</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../navigating-che-from-openshift-developer-perspective/">Navigating Che from OpenShift Developer Perspective</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../navigating-openshift-web-console-from-che/">Navigating OpenShift web console from Che</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../troubleshooting-che/">Troubleshooting Che</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../viewing-che-workspaces-logs/">Viewing Che workspaces logs</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../viewing-workspace-logs-in-cli/">Workspace logs in CLI</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../viewing-workspace-logs-in-the-openshift-console/">Workspace logs in OpenShift console</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../viewing-language-servers-and-debug-adapters-logs-in-visual-studio-code/">Language servers and debug adapters logs in the editor</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../troubleshooting-slow-workspaces/">Troubleshooting slow workspaces</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../troubleshooting-network-problems/">Troubleshooting network problems</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../troubleshooting-webview-loading-error/">Troubleshooting webview loading error</a>
   </li>
 </ul>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="0">
     <button class="nav-item-toggle"></button>
     <span class="nav-text">Administration Guide</span>
 <ul class="nav-list">
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/preparing-the-installation/">Preparing the installation</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/supported-platforms/">Supported platforms</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/installing-the-chectl-management-tool/">Installing the chectl management tool</a>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/architecture-overview/">Architecture</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/server-components/">Server components</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/che-operator/">Che operator</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/devworkspace-operator/">DevWorkspace operator</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/gateway/">Gateway</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/dashboard/">User dashboard</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/devfile-registries/">Devfile registries</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/che-server/">Che server</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/plugin-registry/">Plug-in registry</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/user-workspaces/">User workspaces</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/calculating-che-resource-requirements/">Calculating Che resource requirements</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/installing-che/">Installing Che</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/installing-che-in-the-cloud/">Installing Che in the cloud</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/installing-che-on-openshift-using-cli/">Installing Che on OpenShift using CLI</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/installing-che-on-openshift-using-the-web-console/">Installing Che on OpenShift using the web console</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/installing-che-in-a-restricted-environment/">Installing Che in a restricted environment</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/installing-che-on-microsoft-azure/">Installing Che on Microsoft Azure</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/installing-che-locally/">Installing Che locally</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/installing-che-on-red-hat-openshift-local/">Installing Che on Red Hat OpenShift Local</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/installing-che-on-minikube/">Installing Che on Minikube</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/installing-che-on-minikube-keycloak-oidc/">Installing Che on Minikube with Keycloak as the OIDC provider</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/finding-the-fully-qualified-domain-name-fqdn/">Finding the fully qualified domain name (FQDN)</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/configuring-che/">Configuring Che</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/understanding-the-checluster-custom-resource/">Understanding the <code>CheCluster</code> Custom Resource</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/using-chectl-to-configure-the-checluster-custom-resource-during-installation/">Using chectl to configure the <code>CheCluster</code> Custom Resource during installation</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/using-the-cli-to-configure-the-checluster-custom-resource/">Using the CLI to configure the CheCluster Custom Resource</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/checluster-custom-resource-fields-reference/"><code>CheCluster</code> Custom Resource fields reference</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/configuring-namespace-provisioning/">Configuring namespaces</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-workspace-target-namespace/">Configuring namespace name</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/provisioning-namespaces-in-advance/">Provisioning namespaces in advance</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/configuring-server-components/">Configuring server components</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/mounting-a-secret-as-a-file-or-an-environment-variable-into-a-container/">Mounting a Secret or a ConfigMap as a file or an environment variable into a Eclipse&#160;Che container</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/advanced-configuration-options-for-the-che-server-component/">Advanced configuration options for Che server</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-number-of-replicas/">Configuring number of replicas for a Eclipse&#160;Che container</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/configuring-workspaces-globally/">Configuring workspaces globally</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/limiting-the-number-of-workspaces-that-a-user-can-keep/">Limiting the number of workspaces that a user can keep</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/enabling-users-to-run-multiple-workspaces-simultaneously/">Enabling users to run multiple workspaces simultaneously</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/deploying-che-with-support-for-git-repositories-with-self-signed-certificates/">Git with self-signed certificates</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-workspaces-nodeselector/">Configuring workspaces nodeSelector</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-the-open-vsx-registry-url/">Open VSX registry URL</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-a-user-namespace/">Configuring a user namespace</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/caching-images-for-faster-workspace-start/">Caching images for faster workspace start</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/defining-the-list-of-images-to-pull/">Defining the list of images</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/defining-the-memory-parameters-for-the-image-puller/">Defining the memory settings</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/installing-image-puller-on-openshift-using-the-web-console/">Installing Image Puller on OpenShift using the web console</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/installing-image-puller-on-openshift-using-cli/">Installing Image Puller on OpenShift using CLI</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/configuring-observability/">Configuring observability</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/the-woopra-telemetry-plugin/">The Woopra telemetry plugin</a>
   </li>
   <li class="nav-item" data-depth="3">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/creating-a-telemetry-plugin/">Creating a telemetry plugin</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/configuring-server-logging/">Configuring server logging</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/collecting-logs-using-chectl/">Collecting logs using chectl</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/monitoring-the-dev-workspace-operator/">Monitoring the DevWorkspace Operator</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/monitoring-che/">Monitoring Che Server</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/configuring-networking/">Configuring networking</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-network-policies/">Configuring network policies</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-che-hostname/">Configuring Che hostname</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-che-with-self-signed-certificate/">Configuring Che with self-signed certificates</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/importing-untrusted-tls-certificates/">Importing untrusted TLS certificates to Che</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/adding-labels-and-annotations/">Adding labels and annotations</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/configuring-storage/">Configuring storage</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-storage-classes/">Configuring storage classes</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-the-storage-strategy/">Configuring the storage strategy</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-storage-sizes/">Configuring storage sizes</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/configuring-dashboard/">Configuring dashboard</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-getting-started-samples/">Configuring getting started samples</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/customizing-openshift-che-consolelink-icon/">Customizing OpenShift Eclipse Che ConsoleLink icon</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/managing-identities-and-authorizations/">Managing identities and authorizations</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/configuring-oauth-for-git-providers/">Configuring OAuth for Git providers</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/configuring-oauth-2-for-github/">Configuring OAuth 2.0 for GitHub</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/configuring-oauth-2-for-gitlab/">Configuring OAuth 2.0 for GitLab</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/configuring-oauth-2-for-a-bitbucket-server/">Configuring OAuth 2.0 for a Bitbucket Server</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/configuring-oauth-2-for-the-bitbucket-cloud/">Configuring OAuth 2.0 for the Bitbucket Cloud</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/configuring-oauth-1-for-a-bitbucket-server/">Configuring OAuth 1.0 for a Bitbucket Server</a>
   </li>
   <li class="nav-item" data-depth="4">
     <a class="nav-link" href="../../administration-guide/configuring-oauth-2-for-microsoft-azure-devops-services/">Configuring OAuth 2.0 for Microsoft Azure DevOps Services</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-cluster-roles-for-users/">Configuring cluster roles for Che users</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/configuring-advanced-authorization/">Configuring advanced authorization</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../administration-guide/removing-user-data-in-compliance-with-the-gdpr/">Removing user data in compliance with the GDPR</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/configuring-fuse/">Configuring fuse-overlayfs</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/managing-ide-extensions/">Managing IDE extensions</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/extensions-for-microsoft-visual-studio-code-open-source/">Extensions for Microsoft Visual Studio Code - Open Source</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="1">
     <a class="nav-link" href="../../administration-guide/managing-workloads-using-the-che-server-api/">Using the Che server API</a>
   </li>
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../administration-guide/upgrading-che/">Upgrading Che</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/upgrading-the-chectl-management-tool/">Upgrading the chectl management tool</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/specifying-the-update-approval-strategy/">Specifying the update approval strategy</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/upgrading-che-using-the-web-console/">Upgrading Che using the OpenShift web console</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/upgrading-che-using-the-cli-management-tool/">Upgrading Che using the CLI management tool</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/upgrading-che-using-the-cli-management-tool-in-restricted-environment/">Upgrading Che in a restricted environment</a>
   </li>
   <li class="nav-item" data-depth="2">
     <a class="nav-link" href="../../administration-guide/repairing-the-devworkspace-operator-on-openshift/">Repairing the DevWorkspace Operator on OpenShift</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="1">
     <a class="nav-link" href="../../administration-guide/uninstalling-che/">Uninstalling Che</a>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="0">
 <ul class="nav-list">
   <li class="nav-item" data-depth="1">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../extensions/extensions/">Extensions</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="2">
     <button class="nav-item-toggle"></button>
     <a class="nav-link" href="../../extensions/openshift-connector-overview/">OpenShift Connector</a>
 <ul class="nav-list">
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../extensions/features-of-openshift-connector/">Features of OpenShift Connector</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../extensions/installing-openshift-connector-in-che/">Installing OpenShift Connector in Eclipse Che</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../extensions/authenticating-with-openshift-connector-from-che/">Authenticating with OpenShift Connector from Eclipse Che</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../extensions/creating-components-with-openshift-connector-in-che/">Creating Components with OpenShift Connector in Eclipse Che</a>
   </li>
   <li class="nav-item" data-depth="3">
     <a class="nav-link" href="../../extensions/connecting-source-code-from-github-to-a-openshift-component-using-openshift-connector/">Connecting source code from GitHub to a OpenShift Component</a>
   </li>
 </ul>
   </li>
 </ul>
   </li>
 </ul>
   </li>
   <li class="nav-item" data-depth="0">
 <ul class="nav-list">
   <li class="nav-item" data-depth="1">
     <a class="nav-link" href="../../glossary/che-glossary/">Che glossary</a>
   </li>
 </ul>
   </li>
 </ul>
   </nav>
 </div>
 <div class="nav-panel-explore" data-panel="explore">
   <div class="context">
     <span class="title">Documentation</span>
     <span class="version">7.82.x</span>
   </div>
   <ul class="components">
     <li class="component is-current">
       <div class="title"><a href="../../overview/introduction-to-eclipse-che/">Documentation</a></div>
       <ul class="versions">
         <li class="version">
           <a href="../../../next/overview/introduction-to-eclipse-che/">next</a>
         </li>
         <li class="version is-current is-latest">
           <a href="../../overview/introduction-to-eclipse-che/">7.82.x</a>
         </li>
       </ul>
     </li>
   </ul>
 </div>
     </div>
   </aside>
 </div>
 <main class="article">
 <div class="toolbar" role="navigation">
 <button class="nav-toggle"></button>
   <a href="../../overview/introduction-to-eclipse-che/" class="home-link"></a>
 <nav class="breadcrumbs" aria-label="breadcrumbs">
   <ul>
     <li><a href="../../overview/introduction-to-eclipse-che/">Documentation</a></li>
     <li>User Guide</li>
     <li><a href="./">Requesting persistent storage for workspaces</a></li>
   </ul>
 </nav>
 <div class="page-versions">
   <button class="version-menu-toggle" title="Show other versions of page">7.82.x</button>
   <div class="version-menu">
     <a class="version" href="../../../next/end-user-guide/requesting-persistent-storage-for-workspaces/">next</a>
     <a class="version is-current" href="./">7.82.x</a>
   </div>
 </div>
 <div class="edit-this-page"><a href="https://github.com/eclipse-che/che-docs/edit/7.82.x/modules/end-user-guide/pages/requesting-persistent-storage-for-workspaces.adoc">Edit this Page</a></div>
 </div>
   <div class="content">
 <aside class="toc sidebar" data-title="Contents" data-levels="2">
   <div class="toc-menu"></div>
 </aside>
 <article class="doc">
 <h1 class="page">Requesting persistent storage for workspaces</h1>
 <div id="preamble">
 <div class="sectionbody">
 <div class="paragraph">
 <p><!-- vale RedHat.CaseSensitiveTerms = NO --></p>
 </div>
 <div class="paragraph">
 <p>Che workspaces and workspace data are ephemeral and are lost when the workspace stops.</p>
 </div>
 <div class="paragraph">
 <p>To preserve the workspace state in persistent storage while the workspace is stopped, request a Kubernetes PersistentVolume (PV) for the <code>DevWorkspace</code> containers in the Kubernetes cluster of your organization&#8217;s Che instance.</p>
 </div>
 <div class="paragraph">
 <p>You can request a PV by using the devfile or a Kubernetes PersistentVolumeClaim (PVC).</p>
 </div>
 <div class="paragraph">
 <p>An example of a PV is the <code>/projects/</code> directory of a workspace, which is mounted by default for non-ephemeral workspaces.</p>
 </div>
 <div class="paragraph">
 <p>Persistent Volumes come at a cost: attaching a persistent volume slows workspace startup.</p>
 </div>
 <div class="admonitionblock warning">
 <table>
 <tr>
 <td class="icon">
 <i class="fa icon-warning" title="Warning"></i>
 </td>
 <td class="content">
 <div class="paragraph">
 <p>Starting another, concurrently running workspace with a <a href="https://kubernetes.io/docs/concepts/storage/persistent-volumes/#access-modes"><code>ReadWriteOnce</code> PV</a> might fail.</p>
 </div>
 </td>
 </tr>
 </table>
 </div>
 <div class="ulist">
 <div class="title">Additional resources</div>
 <ul>
 <li>
 <p><a href="https://docs.openshift.com/container-platform/latest/storage/understanding-persistent-storage.html">Red Hat OpenShift Documentation: Understanding persistent storage</a></p>
 </li>
 <li>
 <p><a href="https://kubernetes.io/docs/concepts/storage/persistent-volumes/">Kubernetes Documentation: Persistent Volumes</a></p>
 </li>
 </ul>
 </div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="requesting-persistent-storage-in-a-devfile"><a class="anchor" href="#requesting-persistent-storage-in-a-devfile"></a>Requesting persistent storage in a devfile</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>When a workspace requires its own persistent storage, request a PersistentVolume (PV) in the devfile, and Che will automatically manage the necessary PersistentVolumeClaims.</p>
 </div>
 <div class="ulist">
 <div class="title">Prerequisites</div>
 <ul>
 <li>
 <p>You have not started the workspace.</p>
 </li>
 </ul>
 </div>
 <div class="olist arabic">
 <div class="title">Procedure</div>
 <ol class="arabic">
 <li>
 <p>Add a <code>volume</code> component in the devfile:</p>
 <div class="listingblock">
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">...
 components:
   ...
   - name: <em>&lt;chosen_volume_name&gt;</em>
     volume:
       size: <em>&lt;requested_volume_size&gt;</em>G
   ...</code></pre>
 </div>
 </div>
 </li>
 <li>
 <p>Add a <code>volumeMount</code> for the relevant <code>container</code> in the devfile:</p>
 <div class="listingblock">
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">...
 components:
   - name: ...
     container:
       ...
       volumeMounts:
         - name: <em>&lt;chosen_volume_name_from_previous_step&gt;</em>
           path: <em>&lt;path_where_to_mount_the_PV&gt;</em>
       ...</code></pre>
 </div>
 </div>
 </li>
 </ol>
 </div>
 <div class="exampleblock">
 <div class="title">Example 1. A devfile that provisions a PV for a workspace to a container</div>
 <div class="content">
 <div class="paragraph">
 <p>When a workspace is started with the following devfile, the <code>cache</code> PV is provisioned to the <code>golang</code> container in the <code>./cache</code> container path:</p>
 </div>
 <div class="listingblock">
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">schemaVersion: 2.1.0
 metadata:
   name: mydevfile
 components:
   - name: golang
     container:
       image: golang
       memoryLimit: 512Mi
       mountSources: true
       command: ['sleep', 'infinity']
       volumeMounts:
         - name: cache
           path: /.cache
   - name: cache
     volume:
       size: 2Gi</code></pre>
 </div>
 </div>
 </div>
 </div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="requesting-persistent-storage-in-a-pvc"><a class="anchor" href="#requesting-persistent-storage-in-a-pvc"></a>Requesting persistent storage in a PVC</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>You can opt to apply a PersistentVolumeClaim (PVC) to request a PersistentVolume (PV) for your workspaces in the following cases:</p>
 </div>
 <div class="ulist">
 <ul>
 <li>
 <p>Not all developers of the project need the PV.</p>
 </li>
 <li>
 <p>The PV lifecycle goes beyond the lifecycle of a single workspace.</p>
 </li>
 <li>
 <p>The data included in the PV are shared across workspaces.</p>
 </li>
 </ul>
 </div>
 <div class="admonitionblock tip">
 <table>
 <tr>
 <td class="icon">
 <i class="fa icon-tip" title="Tip"></i>
 </td>
 <td class="content">
 You can apply a PVC to the <code>DevWorkspace</code> containers even if the workspace is ephemeral and its devfile contains the <code>controller.devfile.io/storage-type: ephemeral</code> attribute.
 </td>
 </tr>
 </table>
 </div>
 <div class="ulist">
 <div class="title">Prerequisites</div>
 <ul>
 <li>
 <p>You have not started the workspace.</p>
 </li>
 <li>
 <p>An active <code>kubectl</code> session with administrative permissions to the destination Kubernetes cluster. See <a href="https://kubernetes.io/docs/reference/kubectl/overview/">Overview of kubectl</a>.</p>
 </li>
 <li>
 <p>A PVC is created in your user namespace to mount to all <code>DevWorkspace</code> containers.</p>
 </li>
 </ul>
 </div>
 <div class="olist arabic">
 <div class="title">Procedure</div>
 <ol class="arabic">
 <li>
 <p>Add the <code>controller.devfile.io/mount-to-devworkspace: true</code> label to the PVC.</p>
 <div class="listingblock">
 <div class="content">
 <pre><code>$ kubectl label persistentvolumeclaim <em>&lt;PVC_name&gt;</em> \
           controller.devfile.io/mount-to-devworkspace=true</code></pre>
 </div>
 </div>
 </li>
 <li>
 <p>Optional: Use the annotations to configure how the PVC is mounted:</p>
 <table class="tableblock frame-all grid-all stretch">
 <caption class="title">Table 1. Optional annotations</caption>
 <colgroup>
 <col style="width: 50%;">
 <col style="width: 50%;">
 </colgroup>
 <thead>
 <tr>
 <th class="tableblock halign-left valign-top">Annotation</th>
 <th class="tableblock halign-left valign-top">Description</th>
 </tr>
 </thead>
 <tbody>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>controller.devfile.io/mount-path:</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">The mount path for the PVC.</p>
 <p class="tableblock">Defaults to <code>/tmp/<em>&lt;PVC_name&gt;</em></code>.</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>controller.devfile.io/read-only:</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">Set to <code>'true'</code> or <code>'false'</code> to specify whether the PVC is to be mounted as read-only.</p>
 <p class="tableblock">Defaults to <code>'false'</code>, resulting in the PVC mounted as read/write.</p></td>
 </tr>
 </tbody>
 </table>
 </li>
 </ol>
 </div>
 <div class="exampleblock">
 <div class="title">Example 2. Mounting a read-only PVC</div>
 <div class="content">
 <div class="listingblock">
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">apiVersion: v1
 kind: PersistentVolumeClaim
 metadata:
   name: <em>&lt;pvc_name&gt;</em>
   labels:
     controller.devfile.io/mount-to-devworkspace: 'true'
   annotations:
     controller.devfile.io/mount-path: <em>&lt;/example/directory&gt;</em> <i class="conum" data-value="1"></i><b>(1)</b>
     controller.devfile.io/read-only: 'true'
 spec:
   accessModes:
     - ReadWriteOnce
   resources:
     requests:
       storage: 3Gi <i class="conum" data-value="2"></i><b>(2)</b>
   storageClassName: <em>&lt;storage_class_name&gt;</em> <i class="conum" data-value="3"></i><b>(3)</b>
   volumeMode: Filesystem</code></pre>
 </div>
 </div>
 <div class="colist arabic">
 <table>
 <tr>
 <td><i class="conum" data-value="1"></i><b>1</b></td>
 <td>The mounted PV is available at <code><em>&lt;/example/directory&gt;</em></code> in the workspace.</td>
 </tr>
 <tr>
 <td><i class="conum" data-value="2"></i><b>2</b></td>
 <td>Example size value of the requested storage.</td>
 </tr>
 <tr>
 <td><i class="conum" data-value="3"></i><b>3</b></td>
 <td>The name of the StorageClass required by the claim. Remove this line if you want to use a default StorageClass.</td>
 </tr>
 </table>
 </div>
 </div>
 </div>
 <div class="paragraph">
 <p><!-- vale RedHat.CaseSensitiveTerms = YES --></p>
 </div>
 </div>
 </div>
 </article>
   </div>
 </main>
 </div>
 <footer class="footer">
     <div>
        <a href="https://www.eclipse.org/che/sitemap.xml" target="_blank">Site Map</a> |
        <a href="https://www.eclipse.org" target="_blank">Eclipse Foundation</a> |
        <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">Privacy Policy</a> |
        <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">Terms of Use</a> |
        <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">Eclipse Public License</a> |
        <a href="https://www.eclipse.org/legal" target="_blank">Legal Resources</a></div>
 </footer>

 <script id="site-script" src="../../../../docs/_/js/site.js" data-ui-root-path="../../../../docs/_"></script>
 <script async src="../../../../docs/_/js/vendor/highlight.js"></script>
 <script src="../../../../docs/_/js/vendor/lunr.js"></script>
 <script src="../../../../docs/_/js/search-ui.js" id="search-ui-script" data-site-root-path="../../../.." data-snippet-length="142" data-stylesheet="../../../../docs/_/css/search.css"></script>
 <script async src="../../../../search-index.js"></script>
   </body>
 </html>