What a workspace is and why it matters for ML development on VESSL Cloud.
Workspaces work from the CLI too. Create, list, SSH into, pause, and terminate workspaces from your terminal with vesslctl workspace. See the CLI cheat sheet for a one-page command reference, or vesslctl workspace for the full flag reference.
Workspace gives you a containerized environment with GPU and CPU resources for ML development, set up in a few clicks.In a workspace, you can run code using JupyterLab or connect using SSH.
Start quickly without complex infrastructure setup
Choose resources and create a workspace from a single page
Pause to preserve the environment at lower cost, or Terminate to stop billing
⌘I
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"VESSL Cloud","description":"Documentation for VESSL Cloud by VESSL AI. It covers Container Compute (workspaces and batch jobs), VM Clusters, Provisioned Throughput, and Storage, along with the vesslctl CLI and organization management.","colors":{"primary":"#0069ED","light":"#4D9CFF","dark":"#0050B4"},"logo":{"light":"https://mintcdn.com/dora/QMgwib6XVzFV2yBx/images/logo-horizontal-blue-vesslcloud.svg?fit=max\u0026auto=format\u0026n=QMgwib6XVzFV2yBx\u0026q=85\u0026s=5ba796658c4afba8bb010cda471d84c8","dark":"https://mintcdn.com/dora/QMgwib6XVzFV2yBx/images/logo-horizontal-white-vesslcloud.svg?fit=max\u0026auto=format\u0026n=QMgwib6XVzFV2yBx\u0026q=85\u0026s=a899589a00c02b0bc4daf55aff8e8a70","href":"https://cloud.vessl.ai/~/signin?redirect=%2F\u0026utm_source=docs\u0026utm_medium=nav\u0026utm_campaign=docs-cta\u0026utm_content=logo"},"favicon":"https://mintcdn.com/dora/ASBmpR7P1EWQcMH-/images/favicon_32px.png?fit=max\u0026auto=format\u0026n=ASBmpR7P1EWQcMH-\u0026q=85\u0026s=649370d2c3684dcc6092f06e483290eb","api":{"playground":{"display":"simple"}},"navbar":{"links":[{"href":"https://vessl.ai/talk-to-sales?utm_source=docs\u0026utm_medium=nav\u0026utm_campaign=docs-cta\u0026utm_content=talk-to-sales","label":"Talk to Sales"}],"primary":{"type":"button","label":"Get Started","href":"https://cloud.vessl.ai/~/signup?utm_source=docs\u0026utm_medium=nav\u0026utm_campaign=docs-cta\u0026utm_content=button"}},"footer":{"socials":{"website":"https://vessl.ai","github":"https://github.com/vessl-ai/examples","linkedin":"https://www.linkedin.com/company/vesslai"}},"seo":{"metatags":{"google-site-verification":"jwYKGXUxP-I6bLjLYquEsLKk3dlgEx14melgsmvQSNk","og:site_name":"VESSL Cloud Docs","og:type":"website","twitter:card":"summary_large_image","author":"VESSL AI","canonical":"https://docs.cloud.vessl.ai","referrer":"origin-when-cross-origin","theme-color":"#0069ED","color-scheme":"light dark"},"organization":{"name":"VESSL AI","url":"https://vessl.ai"},"indexing":"navigable"},"integrations":{"amplitude":{"apiKey":"8ae1e9c618024056136ae5c12761262c"},"ga4":{"measurementId":"G-N7NDLW2PZK"},"gtm":{"tagId":"GTM-MGBL4PW"}},"contextual":{"options":["copy","chatgpt","claude","perplexity","mcp","cursor","vscode",{"title":"Share on X","description":"Share this page on X","icon":"x","href":{"base":"https://x.com/intent/tweet","query":[{"key":"text","value":"Check out this documentation: $path"}]}},{"title":"Share on LinkedIn","description":"Share this page on LinkedIn","icon":"linkedin","href":{"base":"https://www.linkedin.com/sharing/share-offsite/","query":[{"key":"url","value":"$path"}]}},{"title":"Send feedback","description":"Email our support team with page context","icon":"envelope","href":{"base":"mailto:support@vessl.ai","query":[{"key":"subject","value":"Docs feedback"},{"key":"body","value":"Page: $path"}]}}],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"languages":[{"language":"en","href":"guides/get-started/introduction"},{"language":"ko","href":"ko/guides/get-started/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dora","hasAudioNarration":false,"actualSubdomain":"dora","customDomains":["docs.cloud.vessl.ai"],"gitSource":{"type":"github","owner":"vessl-ai","repo":"dora","deployBranch":"develop","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afd3e1a86454f1f6e9086c0","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"en","tag":"Explore docs","count":95},{"language":"ko","tag":"문서 살펴보기","count":95},{"language":"en","tag":"Legal","count":32},{"language":"ko","tag":"약관 및 정책","count":32},{"language":"en","tag":"Use VESSL Cloud","count":28},{"language":"ko","tag":"VESSL Cloud 사용하기","count":28},{"language":"en","tag":"Operate organization","count":21},{"language":"ko","tag":"조직 운영하기","count":21},{"language":"en","tag":"vesslctl CLI","count":16},{"language":"ko","tag":"vesslctl CLI","count":16},{"language":"en","tag":"Command Reference","count":12},{"language":"en","tag":"VM Clusters","count":12},{"language":"ko","tag":"명령어 레퍼런스","count":12},{"language":"ko","tag":"VM Clusters","count":12},{"language":"en","tag":"Inference","count":10},{"language":"ko","tag":"Inference","count":10},{"language":"en","tag":"Run GPU instances","count":9},{"language":"ko","tag":"GPU 인스턴스 실행하기","count":9},{"language":"en","tag":"Run batch jobs","count":7},{"language":"ko","tag":"배치 잡 실행하기","count":7}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@vessl.ai","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"site-roles","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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"691a8395918670fb0efa71fe","deploymentId":"68dd8fe90d595fd5818b9394","questionText":"How do I connect to Jupyter?","status":"active","generatedBy":"manual","createdAt":"2025-11-17T02:08:21.219Z","updatedAt":"2025-11-17T02:08:21.219Z","__v":0},{"_id":"691a8392918670fb0efa71a0","deploymentId":"68dd8fe90d595fd5818b9394","questionText":"What are volumes and how do I use them?","status":"active","generatedBy":"manual","createdAt":"2025-11-17T02:08:18.031Z","updatedAt":"2025-11-17T02:08:18.031Z","__v":0},{"_id":"691a838e918670fb0efa7127","deploymentId":"68dd8fe90d595fd5818b9394","questionText":"How do I create a workspace?","status":"active","generatedBy":"manual","createdAt":"2025-11-17T02:08:14.534Z","updatedAt":"2025-11-17T02:08:14.534Z","__v":0}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"member/workspace/overview","slug":"/member/workspace/overview","pageMetadata":{"title":"Understand workspaces","description":"What a workspace is and why it matters for ML development on VESSL Cloud.","href":"/member/workspace/overview"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"What a workspace is and why it matters for ML development on VESSL Cloud.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"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`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,OptimizedImage,Tip}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Workspaces work from the CLI too.`}),` Create, list, SSH into, pause, and terminate workspaces from your terminal with `,_jsx(_components.code,{children:`vesslctl workspace`}),`. See the `,_jsx(_components.a,{href:`/cli/cheatsheet`,children:`CLI cheat sheet`}),` for a one-page command reference, or `,_jsx(_components.a,{href:`/cli/commands/workspace`,children:`vesslctl workspace`}),` for the full flag reference.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/guides/get-started/glossary#workspace`,children:`Workspace`})}),` gives you a containerized environment with `,_jsx(_components.a,{href:`/guides/get-started/glossary#gpu`,children:`GPU`}),` and CPU resources for ML development, set up in a few clicks.`]}),`\n`,_jsx(_components.p,{children:`In a workspace, you can run code using JupyterLab or connect using SSH.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Start quickly without complex infrastructure setup`}),`\n`,_jsx(_components.li,{children:`Choose resources and create a workspace from a single page`}),`\n`,_jsx(_components.li,{children:`Pause to preserve the environment at lower cost, or Terminate to stop billing`}),`\n`]}),`\n`,_jsx(`div`,{children:_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/dora/ak9sJWQAzmPhmU9G/images/understandworkspaces.png?fit=max\u0026auto=format\u0026n=ak9sJWQAzmPhmU9G\u0026q=85\u0026s=d192de235743ad4180634d280732a25a`,alt:`Workspace tab listing running and paused environments with their resources and cost`,\"data-og-width\":`3840`,width:`3840`,\"data-og-height\":`2834`,height:`2834`,\"data-path\":`images/understandworkspaces.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/dora/ak9sJWQAzmPhmU9G/images/understandworkspaces.png?w=280\u0026fit=max\u0026auto=format\u0026n=ak9sJWQAzmPhmU9G\u0026q=85\u0026s=39a1c6f2ef9660595b02a5767afcb601 280w, https://mintcdn.com/dora/ak9sJWQAzmPhmU9G/images/understandworkspaces.png?w=560\u0026fit=max\u0026auto=format\u0026n=ak9sJWQAzmPhmU9G\u0026q=85\u0026s=63da7a216956dc597352a4eada130e7e 560w, https://mintcdn.com/dora/ak9sJWQAzmPhmU9G/images/understandworkspaces.png?w=840\u0026fit=max\u0026auto=format\u0026n=ak9sJWQAzmPhmU9G\u0026q=85\u0026s=140080033969208a41b9339393c0b922 840w, https://mintcdn.com/dora/ak9sJWQAzmPhmU9G/images/understandworkspaces.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ak9sJWQAzmPhmU9G\u0026q=85\u0026s=e9d0341677daddf402c6f26df952b504 1100w, https://mintcdn.com/dora/ak9sJWQAzmPhmU9G/images/understandworkspaces.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ak9sJWQAzmPhmU9G\u0026q=85\u0026s=0db666d222154d1421f4bd1650a74619 1650w, https://mintcdn.com/dora/ak9sJWQAzmPhmU9G/images/understandworkspaces.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ak9sJWQAzmPhmU9G\u0026q=85\u0026s=f9af985ec2c9b9ab67c5f1ba9b9cbc4d 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":"Understand workspaces","description":"What a workspace is and why it matters for ML development on VESSL Cloud.","href":"/member/workspace/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"dora","siteName":"VESSL Cloud","title":"Understand workspaces - VESSL Cloud","contextualStarterQuestions":[{"_id":"6aeadfe61a61ce3ce4427bef","deploymentId":"68dd8fe90d595fd5818b9394","questionText":"How do I create a workspace?","status":"active","generatedBy":"contextual","path":"member/workspace/overview","createdAt":"2026-11-04T07:33:58.809Z","updatedAt":"2026-11-04T07:33:58.809Z","__v":0},{"_id":"6aeadfe61a61ce3ce4427bf0","deploymentId":"68dd8fe90d595fd5818b9394","questionText":"Can I use SSH to connect?","status":"active","generatedBy":"contextual","path":"member/workspace/overview","createdAt":"2026-11-04T07:33:58.809Z","updatedAt":"2026-11-04T07:33:58.809Z","__v":0},{"_id":"6aeadfe61a61ce3ce4427bee","deploymentId":"68dd8fe90d595fd5818b9394","questionText":"What is a workspace?","status":"active","generatedBy":"contextual","path":"member/workspace/overview","createdAt":"2026-11-04T07:33:58.809Z","updatedAt":"2026-11-04T07:33:58.809Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/member/workspace/overview","matchLevel":0},"ko":{"href":"/ko/member/workspace/overview","matchLevel":1}}},"lastModified":"2026-11-04T07:33:55.872Z","originalFileLocation":"member/workspace/overview.mdx","locale":"en"},"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=\"description\" content=\"What a workspace is and why it matters for ML development on VESSL Cloud.\">\u003cmeta data-mint-head name=\"application-name\" content=\"VESSL Cloud\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dora/zzjZrlWa-GiFM2xV/_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=\"/mintlify-assets/_mintlify/favicons/dora/zzjZrlWa-GiFM2xV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dora/zzjZrlWa-GiFM2xV/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dora/zzjZrlWa-GiFM2xV/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dora/zzjZrlWa-GiFM2xV/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dora/zzjZrlWa-GiFM2xV/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dora/zzjZrlWa-GiFM2xV/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dora/zzjZrlWa-GiFM2xV/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dora/zzjZrlWa-GiFM2xV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Understand workspaces - VESSL Cloud\">\u003cmeta data-mint-head property=\"og:description\" content=\"What a workspace is and why it matters for ML development on VESSL Cloud.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"VESSL Cloud Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloud.vessl.ai/member/workspace/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dora.mintlify.site/_mintlify/api/og/v2?division=Run+GPU+instances\u0026amp;title=Understand+workspaces\u0026amp;description=What+a+workspace+is+and+why+it+matters+for+ML+development+on+VESSL+Cloud.\u0026amp;theme=d7fd5162f03442bd080d3d62\u0026amp;signature=f4f4eeddcb33c70ee660be4e0993d7f86e2c69aa275a189e30e4916a723273ba\">\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=\"Understand workspaces - VESSL Cloud\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What a workspace is and why it matters for ML development on VESSL Cloud.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dora.mintlify.site/_mintlify/api/og/v2?division=Run+GPU+instances\u0026amp;title=Understand+workspaces\u0026amp;description=What+a+workspace+is+and+why+it+matters+for+ML+development+on+VESSL+Cloud.\u0026amp;theme=d7fd5162f03442bd080d3d62\u0026amp;signature=f4f4eeddcb33c70ee660be4e0993d7f86e2c69aa275a189e30e4916a723273ba\">\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=\"/mintlify-assets/_mintlify/favicons/dora/zzjZrlWa-GiFM2xV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"VESSL Cloud\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0069ED\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"jwYKGXUxP-I6bLjLYquEsLKk3dlgEx14melgsmvQSNk\">\u003cmeta data-mint-head name=\"author\" content=\"VESSL AI\">\u003cmeta data-mint-head name=\"referrer\" content=\"origin-when-cross-origin\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#0069ED\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"light dark\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloud.vessl.ai/member/workspace/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/member/workspace/overview.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloud.vessl.ai/member/workspace/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloud.vessl.ai/ko/member/workspace/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloud.vessl.ai/member/workspace/overview\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://vessl.ai/#organization\",\"name\":\"VESSL AI\",\"url\":\"https://vessl.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dora/QMgwib6XVzFV2yBx/images/logo-horizontal-blue-vesslcloud.svg?fit=max\u0026auto=format\u0026n=QMgwib6XVzFV2yBx\u0026q=85\u0026s=5ba796658c4afba8bb010cda471d84c8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloud.vessl.ai#website\",\"name\":\"VESSL Cloud\",\"url\":\"https://docs.cloud.vessl.ai\",\"publisher\":{\"@id\":\"https://vessl.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloud.vessl.ai/member/workspace/overview#webpage\",\"url\":\"https://docs.cloud.vessl.ai/member/workspace/overview\",\"name\":\"Understand workspaces\",\"description\":\"What a workspace is and why it matters for ML development on VESSL Cloud.\",\"dateModified\":\"2026-11-04T07:33:55.872Z\",\"isPartOf\":{\"@id\":\"https://docs.cloud.vessl.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloud.vessl.ai/member/workspace/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloud.vessl.ai/member/workspace/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Use VESSL Cloud\",\"item\":\"https://docs.cloud.vessl.ai/member/dashboard/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Understand workspaces\",\"item\":\"https://docs.cloud.vessl.ai/member/workspace/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloud.vessl.ai/member/workspace/overview#article\",\"headline\":\"Understand workspaces\",\"name\":\"Understand workspaces\",\"description\":\"What a workspace is and why it matters for ML development on VESSL Cloud.\",\"url\":\"https://docs.cloud.vessl.ai/member/workspace/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloud.vessl.ai/member/workspace/overview#webpage\"},\"dateModified\":\"2026-11-04T07:33:55.872Z\",\"publisher\":{\"@id\":\"https://vessl.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloud.vessl.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"VESSL Cloud\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"VESSL AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/member/workspace/overview.md","siteName":"VESSL Cloud","nav":{"global":{"anchors":[]},"languages":[{"language":"en","tabs":[{"tab":"Explore docs","groups":[{"group":"Get started","icon":"compass","pages":[{"title":"Introduction","icon":"lightbulb","href":"/guides/get-started/introduction"},{"group":"Start quickly","icon":"rocket","pages":[{"title":"Member quickstart","sidebarTitle":"Member","href":"/guides/get-started/quickstart-user"},{"title":"Admin quickstart","sidebarTitle":"Admin","href":"/guides/get-started/quickstart-admin"}]}]},{"group":"Examples","icon":"wand-magic-sparkles","pages":[{"title":"Fine-tune Gemma 4","icon":"flask","href":"/examples/fine-tuning-gemma-4"},{"title":"Run autoresearch in parallel","icon":"flask","href":"/examples/autoresearch"},{"title":"Train a point-in-time finance LLM","icon":"flask","href":"/examples/point-in-time-finance-llm"}]},{"group":"vesslctl CLI","icon":"terminal","pages":[{"title":"Understand vesslctl","icon":"terminal","href":"/cli/overview"},{"title":"CLI Quickstart","icon":"rocket","href":"/cli/quickstart"},{"title":"CLI Cheat Sheet","icon":"list","href":"/cli/cheatsheet"},{"group":"Command Reference","icon":"book","pages":[{"title":"vesslctl workspace","icon":"desktop","href":"/cli/commands/workspace"},{"title":"vesslctl ssh-key","icon":"key","href":"/cli/commands/ssh-key"},{"title":"vesslctl job","icon":"play","href":"/cli/commands/job"},{"title":"vesslctl volume","icon":"hard-drive","href":"/cli/commands/volume"},{"title":"vesslctl storage","icon":"database","href":"/cli/commands/storage"},{"title":"vesslctl org \u0026 team","icon":"users","href":"/cli/commands/org-team"},{"title":"vesslctl cluster \u0026 resource-spec","icon":"server","href":"/cli/commands/cluster"},{"title":"vesslctl tag","icon":"tag","href":"/cli/commands/tag"},{"title":"vesslctl skill","icon":"wand-magic-sparkles","href":"/cli/commands/skill"},{"title":"vesslctl config, auth, billing \u0026 utility","icon":"cog","href":"/cli/commands/config"},{"title":"vesslctl update","icon":"arrow-up","href":"/cli/commands/update"},{"title":"vesslctl completion","icon":"keyboard","href":"/cli/commands/completion"}]},{"title":"Use with AI tools","icon":"wand-magic-sparkles","href":"/cli/ai-tools"}]},{"group":"Use VESSL Cloud","icon":"book-open","pages":[{"group":"Home - View Dashboard","icon":"chart-line","pages":[{"title":"Monitor workloads","description":"View your active workloads, GPU usage, and burn rate at a glance.","href":"/member/dashboard/overview"}]},{"group":"Run GPU instances","icon":"layer-group","pages":[{"title":"Understand workspaces","href":"/member/workspace/overview"},{"title":"Create a workspace","description":"Select resources, configure your environment, and launch a GPU instance from a single page.","href":"/member/workspace/create"},{"title":"View workspaces","href":"/member/workspace/list"},{"title":"Connect to a workspace","href":"/member/workspace/connect"},{"title":"View workspace details","href":"/member/workspace/details"},{"title":"View logs","href":"/member/workspace/logs"},{"title":"Monitor metrics","href":"/member/workspace/metrics"},{"title":"Convert a workspace to a Job","href":"/member/workspace/convert-to-job"},{"title":"Clean up workspaces","href":"/member/workspace/cleanup"}]},{"group":"Run batch jobs","icon":"play","pages":[{"title":"Understand jobs","href":"/member/job/overview"},{"title":"Create a batch job","href":"/member/job/create"},{"title":"List batch jobs","href":"/member/job/list"},{"title":"View job details","href":"/member/job/details"},{"title":"View logs","href":"/member/job/logs"},{"title":"Monitor metrics","href":"/member/job/metrics"},{"title":"Clean up jobs","href":"/member/job/cleanup"}]},{"group":"Use storage","icon":"hard-drive","pages":[{"title":"Understand storage","href":"/member/volume/overview"},{"title":"Create Object storage volume","href":"/member/volume/create"},{"title":"View volumes","href":"/member/volume/list"},{"title":"Manage volume data","href":"/member/volume/detail"},{"title":"Load data into a volume","href":"/member/volume/load-data"}]},{"group":"Platform reference","icon":"gauge-high","pages":[{"title":"Resource limits","href":"/guides/platform/resource-limits"},{"title":"Managed software stack","href":"/guides/platform/managed-software-stack"}]},{"group":"Manage account","icon":"cog","pages":[{"title":"Profile","href":"/member/settings/profile"},{"title":"SSH Keys","href":"/member/settings/ssh-keys"},{"title":"Secrets","href":"/member/settings/secrets"},{"title":"Notifications","href":"/member/settings/notifications"}]}]},{"group":"Operate organization","icon":"shield","pages":[{"group":"Configure organization","icon":"cog","pages":[{"title":"Organization overview","href":"/admin/organization/overview"},{"title":"SAML SSO","href":"/admin/organization/saml-sso"},{"title":"Monitor organization usage","href":"/admin/dashboard/overview"}]},{"group":"Manage clusters","icon":"server","pages":[{"title":"Cluster overview","href":"/admin/cluster/overview"}]},{"group":"Manage storage","icon":"database","pages":[{"title":"Storage overview","href":"/admin/storage/overview"},{"title":"Volume list","href":"/admin/storage/volume-list"},{"title":"Create a volume","href":"/admin/storage/create-volume"},{"title":"Volume detail","href":"/admin/storage/volume-detail"}]},{"group":"Manage teams","icon":"users","pages":[{"title":"Teams overview","href":"/admin/teams/overview"},{"title":"Create a team","href":"/admin/teams/create-team"},{"title":"Member list","href":"/admin/teams/member-list"},{"title":"Invite a member","href":"/admin/teams/invite-member"},{"title":"Team list","href":"/admin/teams/team-list"}]},{"group":"Manage secrets","icon":"key","pages":[{"title":"Manage secrets","icon":"key","href":"/admin/secrets/overview"}]},{"group":"Manage API keys","icon":"key","pages":[{"title":"Rename and revoke API keys","icon":"key","href":"/admin/api-keys/overview"}]},{"group":"Track spend","icon":"credit-card","pages":[{"title":"Billing overview","href":"/admin/billing/overview"},{"title":"Credits","href":"/admin/billing/credits"},{"title":"Payment methods","href":"/admin/billing/payment-methods"},{"title":"Usage reports","href":"/admin/billing/usage-reports"},{"title":"Credit exhaustion policy","href":"/admin/billing/credit-exhaustion-policy"}]},{"group":"Control access","icon":"key","pages":[{"title":"Roles \u0026 permissions","href":"/admin/roles-permissions"}]}]},{"group":"VM Clusters","icon":"server","pages":[{"group":"Learn the basics","icon":"compass","pages":[{"title":"Understand VM Clusters","href":"/vm-clusters/overview"},{"title":"Compare with Workspace","href":"/vm-clusters/vs-workspace"}]},{"group":"Get started","icon":"rocket","pages":[{"title":"Request a VM cluster","href":"/vm-clusters/order"}]},{"group":"Use your cluster","icon":"terminal","pages":[{"title":"Connect over SSH","href":"/vm-clusters/connect-ssh"},{"title":"Use NFS storage","href":"/vm-clusters/nfs-storage"},{"title":"Configure firewall rules","href":"/vm-clusters/firewall-rules"},{"title":"Reboot a node","href":"/vm-clusters/reboot"}]},{"group":"Monitor your cluster","icon":"chart-line","pages":[{"title":"Health checks","href":"/vm-clusters/health-checks"},{"title":"Metrics","href":"/vm-clusters/metrics"}]},{"group":"Manage your contract","icon":"file-contract","pages":[{"title":"Extend a contract","href":"/vm-clusters/extend-contract"},{"title":"Plan for data retention","href":"/vm-clusters/data-retention"}]},{"group":"Find answers","icon":"circle-question","pages":[{"title":"Browse the FAQ","sidebarTitle":"FAQ","href":"/vm-clusters/faq"}]}]},{"group":"Inference","icon":"bolt","pages":[{"group":"Learn the basics","icon":"compass","pages":[{"title":"Understand Provisioned Throughput","href":"/inference/overview"},{"title":"Compare inference service types","href":"/inference/vs-service-types"},{"title":"Understand PTUs and billing","href":"/inference/ptu"},{"title":"Understand the SLA","href":"/inference/sla"}]},{"title":"Request Provisioned Throughput","sidebarTitle":"Get started","icon":"rocket","href":"/inference/request"},{"group":"Use your endpoint","icon":"terminal","pages":[{"title":"Browse models","href":"/inference/models"},{"title":"Send your first request","href":"/inference/send-requests"}]},{"title":"Monitor inference status","sidebarTitle":"Monitor your endpoint","icon":"chart-line","href":"/inference/monitor-usage"},{"title":"Manage API keys","icon":"key","href":"/inference/api-keys"},{"title":"Manage your contract","sidebarTitle":"Manage your contract","icon":"file-contract","href":"/inference/contracts"}]},{"group":"Glossary","icon":"book","pages":[{"title":"Glossary","href":"/guides/get-started/glossary"}]},{"group":"Support","icon":"life-ring","pages":[{"title":"Support","href":"/guides/get-started/support"}]}]},{"tab":"Pricing","pages":[{"title":"Pricing","href":"/pricing/gpu-instances"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/overview/updates"}]},{"tab":"Legal","pages":[{"title":"Legal","href":"/legal/overview"}]},{"tab":"Resources","icon":"book-open","menu":[{"item":"Blog","icon":"newspaper","href":"https://blog.vessl.ai/?utm_source=docs\u0026utm_medium=nav\u0026utm_campaign=docs-nav\u0026utm_content=blog"},{"item":"YouTube","icon":"play-circle","href":"https://www.youtube.com/@vesslai?utm_source=docs\u0026utm_medium=nav\u0026utm_campaign=docs-nav\u0026utm_content=youtube"},{"item":"Newsletter","icon":"rss","href":"https://share.hsforms.com/2zxOO6PGhROm29UWBec4etwqrbya"}]}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/member/workspace/overview"}]}]},"basePath":"","title":"Understand workspaces - VESSL Cloud","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-B0oVBAXA.js","DynamicMarkdown-BvJIe00T.js","zoom-image-lightbox-BXthlMNf.js","lightbox-handle-r17bVUz3.js"]}