The process of moving from one version of Data Science & AI Workbench to another varies slightly, depending on which version you are migrating to and from, so follow the instructions that correspond to your Workbench implementation.
If you’re moving from an implementation of Anaconda Enterprise 4 to Workbench, we consider that a migration.
If you’re moving between point releases of the same version, we consider that an upgrade.
Migrating between major releases of Workbench requires administrators to migrate the package repository and project owners to migrate their notebooks.Upgrading Workbench generally involves exporting or backing up your current package repository and all project data, uninstalling the existing version and installing the newer version, then importing or restoring this information on the new platform.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Anaconda","description":"Guides, tutorials, and reference material for Anaconda's Python, data science, and AI tools","colors":{"primary":"#1d6cf7","light":"#1d6cf7","dark":"#96f778"},"logo":{"light":"https://mintcdn.com/anaconda-29683c67/s-9WR15r5rZoaPqb/logo/light.svg?fit=max\u0026auto=format\u0026n=s-9WR15r5rZoaPqb\u0026q=85\u0026s=5996719b8530aaf065dc1ee1f39b2e67","dark":"https://mintcdn.com/anaconda-29683c67/s-9WR15r5rZoaPqb/logo/dark.svg?fit=max\u0026auto=format\u0026n=s-9WR15r5rZoaPqb\u0026q=85\u0026s=db482b1eac6af589d234160a76de3400","href":"https://www.anaconda.com/docs/main"},"favicon":"https://mintcdn.com/anaconda-29683c67/p8JNFuYYvTL8gfpM/favicon.png?fit=max\u0026auto=format\u0026n=p8JNFuYYvTL8gfpM\u0026q=85\u0026s=51a585758330bbe8f1ea032113854252","api":{"playground":{"display":"simple"}},"background":{"color":{"light":"#f4f5f8","dark":"#10121a"}},"navbar":{},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/anacondainc","github":"https://github.com/ContinuumIO","youtube":"https://www.youtube.com/c/ContinuumIo"},"links":[{"header":"Company","items":[{"label":"Anaconda Newsletter","href":"https://www.anaconda.com/newsletter"}]}]},"seo":{"metatags":{"canonical":"https://www.anaconda.com/docs"}},"styling":{"eyebrows":"breadcrumbs","latex":false},"integrations":{"ga4":{"measurementId":"G-VQTY6YKM6J"},"heap":{"appId":"758475466"}},"contextual":{"options":["claude","chatgpt","perplexity","cursor","vscode","add-mcp","copy"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"anaconda-29683c67","hasAudioNarration":false,"actualSubdomain":"anaconda-29683c67","customDomains":["anaconda.com"],"gitSource":{"type":"github","owner":"anaconda","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4c786f2f7375d4fd98894","collectionId":"b7369fc2-d35b-4364-be35-1bba3594abbc","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4c786f2f7375d4fd98894"},"feedback":{"thumbs":true,"contextualFeedback":{"allowEmail":true,"emailDisclaimer":"Your email will only be used to follow up on this feedback."}},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4c786f2f7375d4fd98894","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Data Science \u0026 AI Workbench","count":240},{"language":"default","tag":"Anaconda Platform","count":150},{"language":"default","tag":"Package Security Manager","count":128},{"language":"default","tag":"Anaconda CLI","count":112},{"language":"default","tag":"Guides","count":105},{"language":"default","tag":"Anaconda CLI \u0026 MCP","count":104},{"language":"default","tag":"Plugins","count":93},{"language":"default","tag":"Commands","count":91},{"language":"default","tag":"Anaconda Desktop","count":86},{"language":"default","tag":"Platform Guides","count":86}],"searchSettings":{"isFiltersEnabled":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"support@anaconda.com"}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","href":"/docs/_mintlify/custom/anaconda-29683c67/8e7e337189353d6a/custom.css"}],"page":{"pagePath":"data-science/latest/install/migrate/main","slug":"/data-science/latest/install/migrate/main","pageMetadata":{"title":"Upgrading Workbench","sidebarTitle":"Upgrading vs Migrating","description":null,"href":"/data-science/latest/install/migrate/main"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,em:`em`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Frame,OptimizedImage}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The process of moving from one version of Data Science \u0026 AI Workbench to another varies slightly, depending on which version you are migrating to and from, so follow the instructions that correspond to your Workbench implementation.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`If you’re moving from an implementation of Anaconda Enterprise 4 to Workbench, we consider that a `,_jsx(_components.em,{children:`migration`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`If you’re moving between point releases of the same version, we consider that an `,_jsx(_components.em,{children:`upgrade`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Migrating between major releases of Workbench requires administrators to `,_jsx(_components.a,{href:`/data-science/latest/admin/advanced/ae-migrate#exporting-packages`,children:`migrate the package repository`}),` and project owners to `,_jsx(_components.a,{href:`/data-science/latest/admin/advanced/ae-migrate#migrating-anaconda-enterprise-4-notebook-projects`,children:`migrate their notebooks`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Upgrading Workbench generally involves exporting or backing up your current package repository and all project data, uninstalling the existing version and `,_jsx(_components.a,{href:`/data-science/latest/install/main`,children:`installing`}),` the newer version, then importing or restoring this information on the new platform.`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/anaconda-29683c67/Jbxn1KJ0XaeZeGhX/images/data-science/upgrade-green.png?fit=max\u0026auto=format\u0026n=Jbxn1KJ0XaeZeGhX\u0026q=85\u0026s=428ce4408c765b95742c8878bc472bd3`,alt:``,\"data-og-width\":`1602`,width:`1602`,\"data-og-height\":`371`,height:`371`,\"data-path\":`images/data-science/upgrade-green.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/anaconda-29683c67/Jbxn1KJ0XaeZeGhX/images/data-science/upgrade-green.png?w=280\u0026fit=max\u0026auto=format\u0026n=Jbxn1KJ0XaeZeGhX\u0026q=85\u0026s=0bdd1fdd9a1df38293181f2648e99037 280w, https://mintcdn.com/anaconda-29683c67/Jbxn1KJ0XaeZeGhX/images/data-science/upgrade-green.png?w=560\u0026fit=max\u0026auto=format\u0026n=Jbxn1KJ0XaeZeGhX\u0026q=85\u0026s=84058c0afab9ea4662de8b21035d46c8 560w, https://mintcdn.com/anaconda-29683c67/Jbxn1KJ0XaeZeGhX/images/data-science/upgrade-green.png?w=840\u0026fit=max\u0026auto=format\u0026n=Jbxn1KJ0XaeZeGhX\u0026q=85\u0026s=819cb27f36e4bc3cb67b00432c121f9c 840w, https://mintcdn.com/anaconda-29683c67/Jbxn1KJ0XaeZeGhX/images/data-science/upgrade-green.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Jbxn1KJ0XaeZeGhX\u0026q=85\u0026s=58116735ca8ae3eabb3ba06cc893c1fe 1100w, https://mintcdn.com/anaconda-29683c67/Jbxn1KJ0XaeZeGhX/images/data-science/upgrade-green.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Jbxn1KJ0XaeZeGhX\u0026q=85\u0026s=3a8c63ec820cad7ad2b704d2498ff05f 1650w, https://mintcdn.com/anaconda-29683c67/Jbxn1KJ0XaeZeGhX/images/data-science/upgrade-green.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Jbxn1KJ0XaeZeGhX\u0026q=85\u0026s=c440d8c00d7e47f98e1064a992d2c90d 2500w`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Upgrading Workbench","sidebarTitle":"Upgrading vs Migrating","description":null,"href":"/data-science/latest/install/migrate/main"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/anaconda-29683c67/b738e1eb47e9934c/_transcend.js","/docs/_mintlify/custom/anaconda-29683c67/3ca111da84ffed5d/docs-dropdown-tooltip.js","/docs/_mintlify/custom/anaconda-29683c67/a3d1c2dd97aa6593/toc-indicator.js"],"subdomain":"anaconda-29683c67","siteName":"Anaconda","title":"Upgrading Workbench - Anaconda","contextualStarterQuestions":[{"_id":"6ada7255f7a19560e83d864f","deploymentId":"6781700c5f1e7d2ac00fcc4a","questionText":"How do I back up my project data?","status":"active","generatedBy":"contextual","path":"data-science/latest/install/migrate/main","createdAt":"2026-10-22T20:30:13.430Z","updatedAt":"2026-10-22T20:30:13.430Z","__v":0}],"navMaps":{"firstHrefInVersion":{"5.9.0":{"href":"/data-science/latest/install/migrate/main","matchLevel":0},"5.8.1":{"href":"/data-science/5.8.1/install/migrate/main","matchLevel":1,"noindex":true},"5.8.0":{"href":"/data-science/5.8.0/install/migrate/main","matchLevel":1,"noindex":true},"5.7.1":{"href":"/data-science/5.7.1/install/migrate/main","matchLevel":1,"noindex":true},"5.7.0":{"href":"/data-science/5.7.0/install/migrate/main","matchLevel":1,"noindex":true},"5.6.2":{"href":"/data-science/5.6.2/install/migrate/main","matchLevel":1,"noindex":true},"5.6.1":{"href":"/data-science/5.6.1/install/migrate/main","matchLevel":1,"noindex":true},"5.6.0":{"href":"/data-science/5.6.0/install/migrate/main","matchLevel":1,"noindex":true},"5.5.2":{"href":"/data-science/5.5.2/install/migrate/main","matchLevel":1,"noindex":true},"5.5.1":{"href":"/data-science/5.5.1/install/migrate/main","matchLevel":1,"noindex":true},"6.8.0":{"href":"/psm-on-prem/6.8.0/main","matchLevel":4},"6.7.2":{"href":"/psm-on-prem/6.7.2/main","matchLevel":4},"6.7.1":{"href":"/psm-on-prem/6.7.1/main","matchLevel":4},"6.7.0":{"href":"/psm-on-prem/6.7.0/main","matchLevel":4},"6.6.5":{"href":"/psm-on-prem/6.6.5/main","matchLevel":4},"6.6.4":{"href":"/psm-on-prem/6.6.4/main","matchLevel":4},"6.6.3":{"href":"/psm-on-prem/6.6.3/main","matchLevel":4},"6.6.2":{"href":"/psm-on-prem/6.6.2/main","matchLevel":4},"6.6.1":{"href":"/psm-on-prem/6.6.1/main","matchLevel":4},"6.6.0":{"href":"/psm-on-prem/6.6.0/main","matchLevel":4},"6.5.3":{"href":"/psm-on-prem/6.5.3/main","matchLevel":4},"6.5.2":{"href":"/psm-on-prem/6.5.2/main","matchLevel":4},"6.5.1":{"href":"/psm-on-prem/6.5.1/main","matchLevel":4},"6.4.0":{"href":"/psm-on-prem/6.4.0/main","matchLevel":4},"6.3.1":{"href":"/psm-on-prem/6.3.1/main","matchLevel":4},"6.3.0":{"href":"/psm-on-prem/6.3.0/main","matchLevel":4},"6.2.0":{"href":"/psm-on-prem/6.2.0/main","matchLevel":4},"6.1.9":{"href":"/psm-on-prem/6.1.9/main","matchLevel":4},"6.1.8":{"href":"/psm-on-prem/6.1.8/main","matchLevel":4},"6.1.7":{"href":"/psm-on-prem/6.1.7/main","matchLevel":4},"6.1.6":{"href":"/psm-on-prem/6.1.6/main","matchLevel":4},"6.1.4":{"href":"/psm-on-prem/6.1.4/main","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T21:02:36.560Z","originalFileLocation":"data-science/latest/install/migrate/main.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Anaconda\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/anaconda-29683c67/Q6mS5k5M0lNdBscF/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/anaconda-29683c67/Q6mS5k5M0lNdBscF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/anaconda-29683c67/Q6mS5k5M0lNdBscF/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/anaconda-29683c67/Q6mS5k5M0lNdBscF/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/anaconda-29683c67/Q6mS5k5M0lNdBscF/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/anaconda-29683c67/Q6mS5k5M0lNdBscF/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/anaconda-29683c67/Q6mS5k5M0lNdBscF/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/anaconda-29683c67/Q6mS5k5M0lNdBscF/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/anaconda-29683c67/Q6mS5k5M0lNdBscF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Upgrading Workbench - Anaconda\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Anaconda\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.anaconda.com/docs/data-science/latest/install/migrate/main\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://anaconda-29683c67.mintlify.app/_mintlify/api/og/v2?division=Upgrading+Workbench\u0026amp;title=Upgrading+Workbench\u0026amp;theme=a631e829865976b88c6af112\u0026amp;signature=d64382ca0e8df61b358e96b44aed446f33d4956ed6cdbfda7913946a33489324\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Upgrading Workbench - Anaconda\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://anaconda-29683c67.mintlify.app/_mintlify/api/og/v2?division=Upgrading+Workbench\u0026amp;title=Upgrading+Workbench\u0026amp;theme=a631e829865976b88c6af112\u0026amp;signature=d64382ca0e8df61b358e96b44aed446f33d4956ed6cdbfda7913946a33489324\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/anaconda-29683c67/Q6mS5k5M0lNdBscF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Anaconda\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1d6cf7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.anaconda.com/docs/data-science/latest/install/migrate/main\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/data-science/latest/install/migrate/main.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.anaconda.com/#organization\",\"name\":\"Anaconda\",\"url\":\"https://www.anaconda.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/anaconda-29683c67/s-9WR15r5rZoaPqb/logo/light.svg?fit=max\u0026auto=format\u0026n=s-9WR15r5rZoaPqb\u0026q=85\u0026s=5996719b8530aaf065dc1ee1f39b2e67\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.anaconda.com/docs#website\",\"name\":\"Anaconda\",\"url\":\"https://www.anaconda.com/docs\",\"publisher\":{\"@id\":\"https://www.anaconda.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.anaconda.com/docs/data-science/latest/install/migrate/main#webpage\",\"url\":\"https://www.anaconda.com/docs/data-science/latest/install/migrate/main\",\"name\":\"Upgrading Workbench\",\"dateModified\":\"2026-10-22T21:02:36.560Z\",\"isPartOf\":{\"@id\":\"https://www.anaconda.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.anaconda.com/docs/data-science/latest/install/migrate/main#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.anaconda.com/docs/data-science/latest/install/migrate/main#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Data Science \u0026 AI Workbench\",\"item\":\"https://www.anaconda.com/docs/data-science/latest/main\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Installing Workbench\",\"item\":\"https://www.anaconda.com/docs/data-science/latest/install/main\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Upgrading Workbench\",\"item\":\"https://www.anaconda.com/docs/data-science/latest/install/migrate/main\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.anaconda.com/docs/data-science/latest/install/migrate/main#article\",\"headline\":\"Upgrading Workbench\",\"name\":\"Upgrading Workbench\",\"url\":\"https://www.anaconda.com/docs/data-science/latest/install/migrate/main\",\"mainEntityOfPage\":{\"@id\":\"https://www.anaconda.com/docs/data-science/latest/install/migrate/main#webpage\"},\"dateModified\":\"2026-10-22T21:02:36.560Z\",\"publisher\":{\"@id\":\"https://www.anaconda.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.anaconda.com/docs#website\"}}]}\u003c/script>","siteName":"Anaconda","nav":{"global":null,"products":[{"product":"Anaconda Docs","icon":"https://mintlify.s3.us-west-1.amazonaws.com/anaconda-29683c67/images/anaconda-icon.svg","pages":[{"title":"Anaconda Docs","href":"/main"}]},{"product":"Getting Started","icon":"rocket-launch","pages":[{"title":"Getting Started","href":"/getting-started/main"}]},{"product":"Anaconda.org","icon":"globe","pages":[{"title":"Anaconda.org","href":"/anaconda-org/key-features"}]},{"product":"Anaconda Desktop","icon":"desktop","pages":[{"title":"Anaconda Desktop","href":"/anaconda-desktop/key-features"}]},{"product":"Package Security Manager","icon":"shield-check","versions":[{"version":"6.8.0"},{"version":"6.7.2"},{"version":"6.7.1"},{"version":"6.7.0"},{"version":"6.6.5"},{"version":"6.6.4"},{"version":"6.6.3"},{"version":"6.6.2"},{"version":"6.6.1"},{"version":"6.6.0"},{"version":"6.5.3"},{"version":"6.5.2"},{"version":"6.5.1"},{"version":"6.4.0"},{"version":"6.3.1"},{"version":"6.3.0"},{"version":"6.2.0"},{"version":"6.1.9"},{"version":"6.1.8"},{"version":"6.1.7"},{"version":"6.1.6"},{"version":"6.1.4"}],"pages":[{"title":"Package Security Manager","href":"/anaconda-platform/main"}]},{"product":"Anaconda Platform","icon":"layer-group","pages":[{"title":"Anaconda Platform","href":"/platform/main"}]},{"product":"Data Science \u0026 AI Workbench","icon":"chart-network","versions":[{"version":"5.9.0","groups":[{"group":"Data Science \u0026 AI Workbench","pages":[{"title":"Data Science \u0026 AI Workbench","sidebarTitle":"Key Features","href":"/data-science/latest/main"},{"group":"Preparing an environment for Workbench","pages":[{"title":"Preparing an environment for Workbench","sidebarTitle":"Getting started","href":"/data-science/latest/environment-prep/main"},{"title":"Preparing a K3s environment for Workbench","href":"/data-science/latest/environment-prep/k3s-prep"},{"title":"Preparing a BYOK8s environment for Workbench","href":"/data-science/latest/environment-prep/byok8s-prep"},{"group":"Environment-specific recommendations","pages":[{"title":"Environment-specific recommendations","href":"/data-science/latest/environment-prep/env-specific-reqs/main"},{"title":"Azure Kubernetes Service","href":"/data-science/latest/environment-prep/env-specific-reqs/aks"},{"title":"Amazon Elastic Kubernetes Service","href":"/data-science/latest/environment-prep/env-specific-reqs/eks"},{"title":"Google Kubernetes Engine","href":"/data-science/latest/environment-prep/env-specific-reqs/gke"},{"title":"OpenShift Container Platform","href":"/data-science/latest/environment-prep/env-specific-reqs/ocp"},{"title":"RedHat OpenShift Service on AWS (ROSA)","href":"/data-science/latest/environment-prep/env-specific-reqs/rosa"},{"title":"NFS Storage Recommendations","href":"/data-science/latest/environment-prep/env-specific-reqs/nfs"}]},{"title":"Preparing a Gravity environment for Workbench","href":"/data-science/latest/environment-prep/gravity-prep"}]},{"group":"Installing Workbench","pages":[{"title":"Installing Workbench","sidebarTitle":"Installation","href":"/data-science/latest/install/main"},{"title":"K3s installation","href":"/data-science/latest/install/k3s"},{"title":"Bring Your Own Kubernetes (BYOK8s) Installation","href":"/data-science/latest/install/byok8s"},{"title":"Gravity Installation","href":"/data-science/latest/install/gravity"},{"title":"Post-install configuration","href":"/data-science/latest/install/config"},{"title":"Updating TLS/SSL certificates","description":null,"href":"/data-science/latest/install/certs"},{"group":"Upgrading Workbench","pages":[{"title":"Upgrading Workbench","sidebarTitle":"Upgrading vs Migrating","href":"/data-science/latest/install/migrate/main"},{"title":"Upgrading Workbench on Gravity","description":null,"href":"/data-science/latest/install/migrate/upgrade"},{"title":"Bring Your Own Kubernetes (BYOK8s) Upgrade","href":"/data-science/latest/install/migrate/byok8s-upgrade"},{"title":"Backing up and restoring Workbench","href":"/data-science/latest/install/migrate/backup-restore"},{"title":"Migrating from Gravity to K3s","href":"/data-science/latest/install/migrate/gravity-to-k3s"},{"title":"Migrating from Gravity to Bring Your Own Kubernetes (BYOK8s)","sidebarTitle":"Migrating from Gravity to BYOK8s","href":"/data-science/latest/install/migrate/byok8s-migrate"},{"title":"Uninstalling Workbench","href":"/data-science/latest/install/migrate/uninstall"},{"title":"Uninstalling Workbench and K3s","href":"/data-science/latest/install/migrate/k3s-uninstall"},{"title":"Uninstalling Workbench on BYOK8s","href":"/data-science/latest/install/migrate/byok8s-uninstall"},{"title":"Keycloak Upgrade","href":"/data-science/latest/install/migrate/keycloak-upgrade"}]}]},{"group":"Administering Workbench","pages":[{"title":"Administering Workbench","sidebarTitle":"Administrator Guides","href":"/data-science/latest/admin/main"},{"group":"Managing Cluster Resources","pages":[{"title":"Managing cluster resources","sidebarTitle":"Cluster Management","href":"/data-science/latest/admin/resources/main"},{"group":"Gravity Monitoring","pages":[{"title":"Gravity Monitoring","href":"/data-science/latest/admin/resources/gravity/main"},{"title":"Adding and removing nodes","href":"/data-science/latest/admin/resources/gravity/add-remove-node"},{"title":"Monitoring cluster utilization","href":"/data-science/latest/admin/resources/gravity/monitor-cluster"},{"title":"Monitoring sessions and deployments","href":"/data-science/latest/admin/resources/gravity/monitor-sessions-deps"},{"title":"Viewing system logs","href":"/data-science/latest/admin/resources/gravity/logging"},{"title":"Viewing activity logs","href":"/data-science/latest/admin/resources/gravity/activity"}]},{"title":"System metrics","href":"/data-science/latest/admin/resources/prometheus"},{"title":"Configuring workload resource profiles","href":"/data-science/latest/admin/resources/resource-profile"},{"title":"Fault tolerance in Workbench","href":"/data-science/latest/admin/resources/fault-tolerance"}]},{"group":"Configuring user access","pages":[{"title":"Configuring user access","href":"/data-science/latest/admin/user-mgmt/main"},{"title":"Managing users","href":"/data-science/latest/admin/user-mgmt/users"},{"title":"Roles and groups","href":"/data-science/latest/admin/user-mgmt/groups"},{"title":"Managing System Administrators","href":"/data-science/latest/admin/user-mgmt/admins"},{"title":"Configuring session timeouts","href":"/data-science/latest/admin/user-mgmt/session-timeout"},{"title":"Enabling brute force protection","href":"/data-science/latest/admin/user-mgmt/threat-mitigation"},{"title":"Establishing an LDAP connection","href":"/data-science/latest/admin/user-mgmt/ldap-setup"},{"title":"Google IAM setup example","href":"/data-science/latest/admin/user-mgmt/google-setup"}]},{"group":"Configuring channels and mirrors","pages":[{"title":"Configuring channels and mirrors","sidebarTitle":"Distributing software","href":"/data-science/latest/admin/chan-pkg/main"},{"title":"Configuring conda in Workbench","href":"/data-science/latest/admin/chan-pkg/conda-config"},{"title":"Managing channels and packages","href":"/data-science/latest/admin/chan-pkg/channels"},{"title":"Mirroring channels and packages","href":"/data-science/latest/admin/chan-pkg/mirror"}]},{"title":"Configuring persistent environments and sample projects","href":"/data-science/latest/admin/custom_env_proj"},{"title":"Generating custom Anaconda installers","href":"/data-science/latest/admin/custom-installer"},{"title":"Project session management","href":"/data-science/latest/admin/session-mgmt"},{"group":"Advanced platform settings","pages":[{"title":"Advanced platform settings","sidebarTitle":"Platform configurations","href":"/data-science/latest/admin/advanced/main"},{"title":"Configuring platform settings","href":"/data-science/latest/admin/advanced/settings"},{"title":"Setting global config variables","href":"/data-science/latest/admin/advanced/global_config"},{"title":"Changing the database password","href":"/data-science/latest/admin/advanced/db-passwd"},{"title":"Workbench CLI","href":"/data-science/latest/admin/advanced/ae-cli"},{"title":"Changing the platform redirect URLs","href":"/data-science/latest/admin/advanced/redirect-urls"},{"title":"Apache Livy and Workbench","href":"/data-science/latest/admin/advanced/livy-server"},{"title":"Configuring Livy server for Hadoop Spark access","href":"/data-science/latest/admin/advanced/config-livy-server"},{"title":"Adding Anaconda Assistant to Workbench","href":"/data-science/latest/admin/advanced/anaconda-assistant"},{"title":"Adding VSCode to Workbench","href":"/data-science/latest/admin/advanced/vscode"},{"title":"Adding RStudio to Workbench","href":"/data-science/latest/admin/advanced/rstudio-install"},{"title":"Adding MLflow to Workbench","href":"/data-science/latest/admin/advanced/mlflow_install"},{"title":"Connecting to an external version control repository","href":"/data-science/latest/admin/advanced/config-repo"},{"title":"Migrating projects between version control repositories","href":"/data-science/latest/admin/advanced/migrate-projects"},{"title":"Mounting an external file share","href":"/data-science/latest/admin/advanced/nfs"},{"title":"Disabling sudo for yum","href":"/data-science/latest/admin/advanced/sudo-yum"},{"title":"Specifying alternate wildcard domains","href":"/data-science/latest/admin/advanced/domains"},{"title":"Connecting to external Postgres","href":"/data-science/latest/admin/advanced/external-postgres"},{"title":"Upgrading Postgres version","href":"/data-science/latest/admin/advanced/postgres-upgrade"},{"title":"Migrating from Anaconda Enterprise 4 to Workbench","href":"/data-science/latest/admin/advanced/ae-migrate"},{"title":"Editor Lite","href":"/data-science/latest/admin/advanced/editor-lite"}]}]},{"group":"Data Science Workflows","pages":[{"title":"Using Workbench","sidebarTitle":"Using Workbench","href":"/data-science/latest/data-science-workflows/main"},{"group":"Projects","pages":[{"title":"Projects","sidebarTitle":"Getting started with projects","href":"/data-science/latest/data-science-workflows/projects/main"},{"title":"Project templates","href":"/data-science/latest/data-science-workflows/projects/project-templates"},{"title":"Working with projects","href":"/data-science/latest/data-science-workflows/projects/working-with-projects"},{"title":"Branching and merging","href":"/data-science/latest/data-science-workflows/projects/branching"},{"title":"Project tagging","href":"/data-science/latest/data-science-workflows/projects/project-tagging"},{"title":"Project sessions","href":"/data-science/latest/data-science-workflows/projects/project-session"},{"title":"Project configurations","href":"/data-science/latest/data-science-workflows/projects/project-config"},{"title":"Converting projects to pixi format","sidebarTitle":"Converting to pixi","href":"/data-science/latest/data-science-workflows/projects/pixi"},{"title":"Project collaboration","href":"/data-science/latest/data-science-workflows/projects/collaborate"},{"title":"Project logs","href":"/data-science/latest/data-science-workflows/projects/project-logs"}]},{"group":"Packages","pages":[{"title":"Working with channels and packages","sidebarTitle":"Distributing software","href":"/data-science/latest/data-science-workflows/packages/main"},{"title":"Building a conda package","href":"/data-science/latest/data-science-workflows/packages/build"},{"title":"Channels and packages","href":"/data-science/latest/data-science-workflows/packages/channels"},{"title":"Configuring conda","href":"/data-science/latest/data-science-workflows/packages/conda"}]},{"title":"Using installers, parcels and management packs","href":"/data-science/latest/data-science-workflows/installers"},{"group":"Data","pages":[{"title":"Working with data","sidebarTitle":"Working with data","href":"/data-science/latest/data-science-workflows/data/main"},{"title":"Loading data into your project","href":"/data-science/latest/data-science-workflows/data/load"},{"title":"Exploring project data","href":"/data-science/latest/data-science-workflows/data/explore"},{"title":"Data preparation","href":"/data-science/latest/data-science-workflows/data/prep"},{"title":"Using statistics","href":"/data-science/latest/data-science-workflows/data/stats"}]},{"group":"Deployments","pages":[{"title":"Deployments","sidebarTitle":"Deploying projects","href":"/data-science/latest/data-science-workflows/deployments/main"},{"title":"Deploying a REST API","href":"/data-science/latest/data-science-workflows/deployments/rest-api"},{"title":"Deploying a Flask application","href":"/data-science/latest/data-science-workflows/deployments/deploy-flask"},{"title":"Sharing deployments","href":"/data-science/latest/data-science-workflows/deployments/share"},{"title":"Deployment logs","href":"/data-science/latest/data-science-workflows/deployments/deployment-logs"}]},{"title":"Schedules","href":"/data-science/latest/data-science-workflows/schedules"},{"title":"Using GPUs in sessions and deployments","href":"/data-science/latest/data-science-workflows/gpu"},{"title":"User settings","href":"/data-science/latest/data-science-workflows/user-settings"},{"title":"Secrets","href":"/data-science/latest/data-science-workflows/secrets"},{"title":"Configuring user access to external version control","href":"/data-science/latest/data-science-workflows/external-repo-user"},{"title":"Visualizations and dashboards","href":"/data-science/latest/data-science-workflows/viz"},{"group":"Ml Deep Learn","pages":[{"title":"Machine learning and deep learning","sidebarTitle":"Overview","href":"/data-science/latest/data-science-workflows/ml-deep-learn/main"},{"title":"Developing models","href":"/data-science/latest/data-science-workflows/ml-deep-learn/dev-model"},{"title":"Training models","href":"/data-science/latest/data-science-workflows/ml-deep-learn/train-model"},{"title":"Deploying models as endpoints","href":"/data-science/latest/data-science-workflows/ml-deep-learn/deploy-model"},{"title":"Querying and scoring models","href":"/data-science/latest/data-science-workflows/ml-deep-learn/query-score-model"}]}]},{"title":"Troubleshooting","href":"/data-science/latest/troubleshoot"},{"group":"Reference","pages":[{"title":"Reference materials","sidebarTitle":"Overview","href":"/data-science/latest/reference/main"},{"title":"Release notes","href":"/data-science/latest/reference/release"},{"title":"Known issues","href":"/data-science/latest/reference/known-issues"},{"title":"Frequently asked questions","href":"/data-science/latest/reference/faq"},{"title":"Understanding Workbench system requirements","href":"/data-science/latest/reference/understanding-ae5"},{"title":"Gravity update policy","href":"/data-science/latest/reference/gravity-support"},{"title":"Project reproducibility in Workbench","href":"/data-science/latest/reference/reproducibility"}]}]}]},{"version":"5.8.1","pages":[{"title":"5.8.1","href":"/data-science/5.8.1/install/migrate/main"}]},{"version":"5.8.0","pages":[{"title":"5.8.0","href":"/data-science/5.8.0/install/migrate/main"}]},{"version":"5.7.1","pages":[{"title":"5.7.1","href":"/data-science/5.7.1/install/migrate/main"}]},{"version":"5.7.0","pages":[{"title":"5.7.0","href":"/data-science/5.7.0/install/migrate/main"}]},{"version":"5.6.2","pages":[{"title":"5.6.2","href":"/data-science/5.6.2/install/migrate/main"}]},{"version":"5.6.1","pages":[{"title":"5.6.1","href":"/data-science/5.6.1/install/migrate/main"}]},{"version":"5.6.0","pages":[{"title":"5.6.0","href":"/data-science/5.6.0/install/migrate/main"}]},{"version":"5.5.2","pages":[{"title":"5.5.2","href":"/data-science/5.5.2/install/migrate/main"}]},{"version":"5.5.1","pages":[{"title":"5.5.1","href":"/data-science/5.5.1/install/migrate/main"}]}]},{"product":"Anaconda CLI \u0026 MCP","icon":"terminal","pages":[{"title":"Anaconda CLI \u0026 MCP","href":"/cli-reference/anaconda-cli/getting-started"}]},{"product":"Legacy applications","icon":"window-restore","pages":[{"title":"Legacy applications","href":"/legacy/anaconda-navigator/main"}]},{"product":"Reference","icon":"book","pages":[{"title":"Reference","href":"/reference/release-notes"}]},{"product":"Support \u0026 Troubleshooting","icon":"headset","pages":[{"title":"Support \u0026 Troubleshooting","href":"/reference/help-support"}]},{"product":"Repository Managers","hidden":true,"pages":[{"title":"Repository Managers","href":"/repo-managers/main"}]}]},"basePath":"","title":"Upgrading Workbench - Anaconda","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-Bj1PpgeO.js","DynamicMarkdown-Bas9A7wq.js","zoom-image-lightbox-B-WKhCOL.js","lightbox-handle-r17bVUz3.js"]}