This feature is only available in Incredibuild’s Enterprise and Business Plans and is currently in limited availability. For more details, speak to your Customer Success Representative.
The purpose of this playbook is to help you start using Incredibuild Build Cache with a new C++ project. If you have multiple projects, repeat this procedure one by one…Introducing a new project to Build Cache often requires several trials and adjustments until it shows optimal results. The steps described here are designed to identify these adjustments quickly and with minimal friction. Once this procedure is complete, you can move the project to production use with Build Cache.We assume that at this point Incredibuild 10.x is already operational, and you have a baseline performance using virtual process distribution.The procedure begins with feasibility and tuning steps: these increase diagnostics at the expense of performance. After you validate that Build Cache is properly configured for the specific project, you will follow up with testing the actual acceleration.Finally, the procedure tests the efficiency of shared cache. Initiators using a shared cache must use the same toolset version (i.e., Visual Studio) to gain the caching benefits. This is different from distribution that does not require any setup alignment on Agents.In some cases (e.g., if the project contains auto-generated code) it is possible you will need to examine some of that code. Make sure you have access to the project source code or have someone else support you if the need comes.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"IncrediBuild Documentation","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/incredibuild-docs-migrated/a90IOkXrBeudmNJU/images/logo-light.svg?fit=max\u0026auto=format\u0026n=a90IOkXrBeudmNJU\u0026q=85\u0026s=74d7751f22e305e5f7e543929f7c64e3","dark":"https://mintcdn.com/incredibuild-docs-migrated/a90IOkXrBeudmNJU/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=a90IOkXrBeudmNJU\u0026q=85\u0026s=2545789b1ee6a74f9f7c9186ef6a3b3e"},"favicon":"https://mintcdn.com/incredibuild-docs-migrated/J_iESDJtkumUEvdP/images/favicon.svg?fit=max\u0026auto=format\u0026n=J_iESDJtkumUEvdP\u0026q=85\u0026s=d4a56a75bbe0364d0ef863d3183e06ca","navbar":{"links":[{"href":"https://www.incredibuild.com/support","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/Incredibuild","github":"https://github.com/Incredibuild-RND","linkedin":"https://linkedin.com/company/incredibuild"}},"integrations":{"gtm":{"tagId":"GTM-P4S7537"},"posthog":{"apiKey":"phc_78QqWhPGnAx46NqlRahsOjygVlyPJ4g3EyLzbplwzZm","sessionRecording":false}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"incredibuild-docs-migrated","hasAudioNarration":false,"actualSubdomain":"incredibuild-docs-migrated","customDomains":["docs.incredibuild.com"],"gitSource":{"type":"github","owner":"incredibuild-rnd","repo":"docs-mintlify-live","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"ce36e4d0-eb18-4c07-8a00-83eeef58da95","liveDeploymentHistoryId":"6ada2e542cd1c8b6f015a391","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ada2e542cd1c8b6f015a391"},"entitlements":{},"buildId":"6ada2e542cd1c8b6f015a391","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Windows","count":4524},{"language":"default","tag":"Linux","count":1559},{"language":"default","tag":"Integrations","count":1534},{"language":"default","tag":"Features and Settings","count":1267},{"language":"default","tag":"Installation","count":875},{"language":"default","tag":"Other","count":752},{"language":"default","tag":"Devtools Solution","count":705},{"language":"default","tag":"Running Builds","count":645},{"language":"default","tag":"Integration Interfaces","count":498},{"language":"default","tag":"Introduction","count":354}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"windows/build-cache-playbook","slug":"/windows/build-cache-playbook","pageMetadata":{"title":"Build Cache - New Project Playbook","description":null,"href":"/windows/build-cache-playbook"},"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`,p:`p`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[`This feature is only available in Incredibuild’s `,_jsx(_components.a,{href:`/windows/pricing-plans`,children:`Enterprise and Business Plans`}),` and is currently in limited availability. For more details, speak to your Customer Success Representative.`]})}),`\n`,_jsx(_components.p,{children:`The purpose of this playbook is to help you start using Incredibuild Build Cache with a new C++ project. If you have multiple projects, repeat this procedure one by one…`}),`\n`,_jsx(_components.p,{children:`Introducing a new project to Build Cache often requires several trials and adjustments until it shows optimal results. The steps described here are designed to identify these adjustments quickly and with minimal friction. Once this procedure is complete, you can move the project to production use with Build Cache.`}),`\n`,_jsx(_components.p,{children:`We assume that at this point Incredibuild 10.x is already operational, and you have a baseline performance using virtual process distribution.`}),`\n`,_jsx(_components.p,{children:`The procedure begins with feasibility and tuning steps: these increase diagnostics at the expense of performance. After you validate that Build Cache is properly configured for the specific project, you will follow up with testing the actual acceleration.`}),`\n`,_jsx(_components.p,{children:`Finally, the procedure tests the efficiency of shared cache. Initiators using a shared cache must use the same toolset version (i.e., Visual Studio) to gain the caching benefits. This is different from distribution that does not require any setup alignment on Agents.`}),`\n`,_jsx(_components.p,{children:`In some cases (e.g., if the project contains auto-generated code) it is possible you will need to examine some of that code. Make sure you have access to the project source code or have someone else support you if the need comes.`})]})}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":"Build Cache - New Project Playbook","description":null,"href":"/windows/build-cache-playbook"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"incredibuild-docs-migrated","siteName":"IncrediBuild Documentation","title":"Build Cache - New Project Playbook - IncrediBuild Documentation","navMaps":{"firstHrefInVersion":{"10.38.1":{"href":"/windows/build-cache-playbook","matchLevel":0},"10.38.0":{"href":"/windows/10.38.0/_shared/site-landing/download-docs-center","matchLevel":2},"10.37.1":{"href":"/windows/10.37.1/_shared/site-landing/download-docs-center","matchLevel":2},"10.37.0":{"href":"/windows/10.37.0/_shared/site-landing/download-docs-center","matchLevel":2},"10.36.3":{"href":"/windows/10.36.3/_shared/site-landing/download-docs-center","matchLevel":2},"10.36.2":{"href":"/windows/10.36.2/_shared/site-landing/download-docs-center","matchLevel":2},"10.36.1":{"href":"/windows/10.36.1/_shared/site-landing/download-docs-center","matchLevel":2},"10.36.0":{"href":"/windows/10.36.0/_shared/site-landing/download-docs-center","matchLevel":2},"10.35.3":{"href":"/windows/10.35.3/build-group-api-syntax","matchLevel":2},"10.35.2":{"href":"/windows/10.35.2/build-group-api-syntax","matchLevel":2},"10.35.1":{"href":"/windows/10.35.1/build-group-api-syntax","matchLevel":2},"10.35.0":{"href":"/windows/10.35.0/_shared/site-landing/download-docs-center","matchLevel":2},"10.34.3":{"href":"/windows/10.34.3/index","matchLevel":2},"10.34.2":{"href":"/windows/10.34.2/index","matchLevel":2},"10.34.1":{"href":"/windows/10.34.1/index","matchLevel":2},"10.34.0":{"href":"/windows/10.34.0/index","matchLevel":2},"10.33.0":{"href":"/windows/10.33.0/index","matchLevel":2},"10.32.2":{"href":"/windows/10.32.2/index","matchLevel":2},"10.32.1":{"href":"/windows/10.32.1/index","matchLevel":2},"10.32.0":{"href":"/windows/10.32.0/index","matchLevel":2},"10.31.2":{"href":"/windows/10.31.2/index","matchLevel":2},"10.31.1":{"href":"/windows/10.31.1/index","matchLevel":2},"10.31.0":{"href":"/windows/10.31.0/index","matchLevel":2},"10.30.0":{"href":"/windows/10.30.0/index","matchLevel":2},"10.29.1":{"href":"/windows/10.29.1/index","matchLevel":2},"10.29":{"href":"/windows/10.29/index","matchLevel":2},"10.28":{"href":"/windows/10.28/index","matchLevel":2},"10.27.1":{"href":"/windows/10.27.1/index","matchLevel":2},"10.27":{"href":"/windows/10.27/index","matchLevel":2},"10.26":{"href":"/windows/10.26/index","matchLevel":2},"4.30.2":{"href":"/linux/overview","matchLevel":4},"4.30.1":{"href":"/linux/4.30.1/overview","matchLevel":4},"4.30.0":{"href":"/linux/4.30.0/overview","matchLevel":4},"4.29.3":{"href":"/linux/4.29.3/overview","matchLevel":4},"4.29.2":{"href":"/linux/4.29.2/overview","matchLevel":4},"4.29.0":{"href":"/linux/4.29.0/overview","matchLevel":4},"4.27.2":{"href":"/linux/4.27.2/release-notes","matchLevel":4},"4.27.1":{"href":"/linux/4.27.1/release-notes","matchLevel":4},"4.27.0":{"href":"/linux/4.27.0/release-notes","matchLevel":4},"4.26.1":{"href":"/linux/4.26.1/overview","matchLevel":4},"4.26.0":{"href":"/linux/4.26.0/release-notes","matchLevel":4},"4.25.0":{"href":"/linux/4.25.0/release-notes","matchLevel":4},"4.24.0":{"href":"/linux/4.24.0/release-notes","matchLevel":4},"4.23.0":{"href":"/linux/4.23.0/release-notes","matchLevel":4},"4.22.0":{"href":"/linux/4.22.0/release-notes","matchLevel":4},"4.21.0":{"href":"/linux/4.21.0/release-notes","matchLevel":4},"4.20.0":{"href":"/linux/4.20.0/release-notes","matchLevel":4},"4.19.1":{"href":"/linux/4.19.1/release-notes","matchLevel":4},"4.19.0":{"href":"/linux/4.19.0/release-notes","matchLevel":4},"4.18.1":{"href":"/linux/4.18.1/release-notes","matchLevel":4},"4.18.0":{"href":"/linux/4.18.0/release-notes","matchLevel":4},"4.12":{"href":"/mac/overview","matchLevel":4},"4.11.0":{"href":"/mac/4.11.0/release-notes","matchLevel":4},"4.10.0":{"href":"/mac/4.10.0/release-notes","matchLevel":4},"4.9.0":{"href":"/mac/4.9.0/release-notes","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-08-12T20:57:13.383Z","originalFileLocation":"windows/build-cache-playbook.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=\"IncrediBuild Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/incredibuild-docs-migrated/0baZAtTsfgTDpi0G/_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/incredibuild-docs-migrated/0baZAtTsfgTDpi0G/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/incredibuild-docs-migrated/0baZAtTsfgTDpi0G/_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/incredibuild-docs-migrated/0baZAtTsfgTDpi0G/_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/incredibuild-docs-migrated/0baZAtTsfgTDpi0G/_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/incredibuild-docs-migrated/0baZAtTsfgTDpi0G/_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/incredibuild-docs-migrated/0baZAtTsfgTDpi0G/_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/incredibuild-docs-migrated/0baZAtTsfgTDpi0G/_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/incredibuild-docs-migrated/0baZAtTsfgTDpi0G/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Build Cache - New Project Playbook - IncrediBuild Documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"IncrediBuild Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.incredibuild.com/windows/build-cache-playbook\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://incredibuild-docs-migrated.mintlify.app/_mintlify/api/og/v2?division=Other\u0026amp;title=Build+Cache+-+New+Project+Playbook\u0026amp;theme=c5b8fa8188558088a0958d16\u0026amp;signature=445f9e4b6f20bf0ae4030920c7df27e60f4390e55f848808e72b33b8cb0eecf8\">\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=\"Build Cache - New Project Playbook - IncrediBuild Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://incredibuild-docs-migrated.mintlify.app/_mintlify/api/og/v2?division=Other\u0026amp;title=Build+Cache+-+New+Project+Playbook\u0026amp;theme=c5b8fa8188558088a0958d16\u0026amp;signature=445f9e4b6f20bf0ae4030920c7df27e60f4390e55f848808e72b33b8cb0eecf8\">\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/incredibuild-docs-migrated/0baZAtTsfgTDpi0G/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"IncrediBuild Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.incredibuild.com/windows/build-cache-playbook\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/windows/build-cache-playbook.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.incredibuild.com/#organization\",\"name\":\"IncrediBuild Documentation\",\"url\":\"https://docs.incredibuild.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/incredibuild-docs-migrated/a90IOkXrBeudmNJU/images/logo-light.svg?fit=max\u0026auto=format\u0026n=a90IOkXrBeudmNJU\u0026q=85\u0026s=74d7751f22e305e5f7e543929f7c64e3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.incredibuild.com#website\",\"name\":\"IncrediBuild Documentation\",\"url\":\"https://docs.incredibuild.com\",\"publisher\":{\"@id\":\"https://docs.incredibuild.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.incredibuild.com/windows/build-cache-playbook#webpage\",\"url\":\"https://docs.incredibuild.com/windows/build-cache-playbook\",\"name\":\"Build Cache - New Project Playbook\",\"dateModified\":\"2026-08-12T20:57:13.383Z\",\"isPartOf\":{\"@id\":\"https://docs.incredibuild.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.incredibuild.com/windows/build-cache-playbook#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.incredibuild.com/windows/build-cache-playbook#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Other\",\"item\":\"https://docs.incredibuild.com/site-landing/download-docs-center\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Build Cache - New Project Playbook\",\"item\":\"https://docs.incredibuild.com/windows/build-cache-playbook\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.incredibuild.com/windows/build-cache-playbook#article\",\"headline\":\"Build Cache - New Project Playbook\",\"name\":\"Build Cache - New Project Playbook\",\"url\":\"https://docs.incredibuild.com/windows/build-cache-playbook\",\"mainEntityOfPage\":{\"@id\":\"https://docs.incredibuild.com/windows/build-cache-playbook#webpage\"},\"dateModified\":\"2026-08-12T20:57:13.383Z\",\"publisher\":{\"@id\":\"https://docs.incredibuild.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.incredibuild.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"IncrediBuild Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"IncrediBuild Documentation","nav":{"global":null,"products":[{"product":"Windows","icon":"windows","directory":"card","versions":[{"version":"10.38.1","default":true,"tag":"Latest","groups":[{"group":"Overview","pages":[{"title":"Incredibuild Documentation","mode":"custom","href":""},{"title":"Incredibuild for Windows","href":"/windows/overview"},{"title":"Release Notes","href":"/windows/release-notes"}]},{"group":"Introduction","root":{"title":"Introduction","href":"/windows/getting-started"},"pages":[{"title":"Introduction to Incredibuild","href":"/windows/introduction"},{"title":"Incredibuild Components and Architecture","href":"/windows/components-and-architecture"},{"group":"Virtualization Tech","pages":[{"title":"Incredibuild's Virtualization Technology","href":"/windows/virtualization-tech"},{"title":"What is Process Virtualization?","href":"/windows/process-virt-overview"},{"title":"Process Virtualization Flow","href":"/windows/process-virtualization-flow"}]},{"title":"Jobs and Tasks","href":"/windows/jobs-tasks"},{"title":"Pricing Plans","href":"/windows/pricing-plans"},{"title":"Supported Tools","href":"/windows/supported-tools"}]},{"group":"Installation","root":{"title":"Installation","href":"/windows/setup-install"},"pages":[{"title":"System Requirements","href":"/windows/system-requirements"},{"title":"Standard Installation","href":"/windows/standard-installation"},{"title":"Silent Installation","href":"/windows/silent-install"},{"title":"Installation from within Visual Studio","href":"/windows/installation-within-vs-2017-2019"},{"title":"Troubleshooting Installation","href":"/windows/setup-issues"},{"title":"Linux Helper (SCL) Installation","href":"/windows/linux-helper-scl-installation"},{"title":"Linux Installation","href":"/windows/linux-installation"},{"title":"Using a Backup Coordinator","href":"/windows/using-backup-coordinator"},{"group":"Upgrade","pages":[{"title":"Upgrading Incredibuild","href":"/windows/upgrade"},{"title":"Deprecations and Limitations","href":"/windows/ib10-coord-limitations"}]},{"title":"Installing Additional Components","href":"/windows/install-agent-on-coordinator"},{"title":"License Overview","href":"/windows/license-model"},{"title":"Offline Licenses","href":"/windows/offline-licenses"},{"title":"Moving the Coordinator to a New Machine","href":"/windows/move-coordinator"},{"title":"Rolling Back (Downgrade) to a Previous Version","href":"/windows/rolling-back"},{"title":"Uninstalling Incredibuild","href":"/windows/uninstall"},{"title":"Configuration Changes","href":"/windows/configuration-changes"},{"group":"Scaling Helpers in the Cloud","root":{"title":"Scaling Helpers in the Cloud","href":"/windows/scaling-helpers-in-cloud"},"pages":[{"title":"Scaling Helpers in Azure","href":"/windows/scaling-helpers-in-azure"},{"title":"Scaling Helpers in GCP","href":"/windows/scaling-helpers-in-gcp"},{"title":"Scaling Helpers in AWS EC2","href":"/windows/scaling-helpers-in-aws-ec2"}]}]},{"group":"Integrations","root":{"title":"Integrations","href":"/windows/integrations"},"pages":[{"group":"Visual Studio Solution","pages":[{"title":"Visual Studio Solution","href":"/windows/visual-studio-solution"},{"title":"Upgrading the Version of the Incredibuild Extension","href":"/windows/visual-studio-upgrade"},{"title":"Customizing Incredibuild Options in Visual Studio","href":"/windows/customizing-incredibuild-build-options"},{"title":"Configuring Incredibuild Visual Studio Commands","href":"/windows/configuring-visual-studio-commands"},{"title":"Incredibuild and Visual Studio Integration Modes","href":"/windows/using-visual-studio-integration-modes"},{"title":"Batch Build Configurations","href":"/windows/batch-build-configurations"},{"title":"Accelerating Custom Build Steps, Events, and Tools","href":"/windows/accelerating-custom-build-steps"},{"title":"Build Performance Optimizations","href":"/windows/build-performance-optimizations"},{"title":"Using NuGet","href":"/windows/nuget"},{"title":"Predictive Execution","href":"/windows/predictive-execution-msbuild-versions"}]},{"title":"Qt Creator","href":"/windows/qt-creator"},{"title":"Integrating with Github Actions","href":"/windows/github"},{"title":"Integrating with Klocwork","href":"/windows/klocwork"},{"title":"Integrating with Docker","href":"/windows/docker"},{"title":"Prometheus Integration","href":"/windows/prometheus"},{"title":"Integration with Jenkins","href":"/windows/jenkins"},{"group":"Devtools Solution","pages":[{"title":"DevTools Solution","href":"/windows/devtools-solution"},{"group":"Integration Interfaces","root":{"title":"Integration Interfaces","href":"/windows/integration-interfaces"},"pages":[{"title":"Choosing the Ideal Interface","href":"/windows/choose-ideal-interface"},{"group":"Submission Interfaces","pages":[{"title":"Using Submission Interfaces","href":"/windows/submission-interfaces"},{"title":"xgSubmit Command","href":"/windows/xgsubmit-command"},{"title":"xgWait Command","href":"/windows/xgwait-command"}]},{"title":"Using Automatic Interception Interfaces","href":"/windows/auto-interception-interfaces"},{"title":"Creating a Profile XML File","href":"/windows/create-profile-xml-file"},{"group":"Using Xml Interfaces","pages":[{"title":"Using XML Interfaces","href":"/windows/using-xml-interfaces"},{"group":"XML Syntax","pages":[{"title":"XML File Syntax","href":"/windows/xml-file-syntax"},{"title":"XML Syntax Specification","href":"/windows/xml-synax-specs"},{"title":"XML Syntax Notes","href":"/windows/xml-syntax-notes"},{"title":"XML Interface - Dependency Definition","href":"/windows/xml-dependency-definition"},{"title":"XML Interface - Macros","href":"/windows/xml-macros"},{"title":"XML Interface - Response Files","href":"/windows/xml-response-files"}]},{"title":"XML Interface - Usage","href":"/windows/xml-usage"},{"title":"Sample XML Interface Project and File","href":"/windows/xml-sample-project-file"}]},{"title":"Combined Interfaces","href":"/windows/combined-interfaces"}]},{"title":"DevTools Command Line - IBConsole","href":"/windows/devtools-command-line"},{"title":"IBConsole Command Line Options","href":"/windows/ibconsole-cli-options"},{"title":"Further Build Performance Optimizations","href":"/windows/further-build-performance-optimizations"},{"group":"Unit Tests","pages":[{"title":"Incredibuild for Unit Tests","href":"/windows/unit-tests"},{"title":"Distribution Modes","href":"/windows/distribution-modes"},{"title":"IBConsole Command Interface (All frameworks excluding NUnit \u0026 GTest)","href":"/windows/ibconsole-interface"},{"title":"IBTestConsole Command Interface (for NUnit, GTest)","href":"/windows/ibtestconsole-interface"}]}]}]},{"group":"Features and Settings","root":{"title":"Features and Settings","href":"/windows/features-and-settings"},"pages":[{"title":"Accessing the Coordinator Manager","href":"/windows/coord-access"},{"title":"User Management","href":"/windows/user-management"},{"title":"User Management Integration with External System","href":"/windows/user-management-integration"},{"title":"Viewing Agents","href":"/windows/coordinator-agents-list"},{"title":"Agent Actions","href":"/windows/coordinator-agent-list-actions"},{"title":"Managing Licenses","href":"/windows/license-manage"},{"title":"Build Groups","href":"/windows/working-with-build-groups"},{"group":"Build Cache","pages":[{"title":"Build Cache","href":"/windows/build-cache"},{"title":"Build Cache - Overview","href":"/windows/build-cache-overview"},{"title":"Build Cache - Basic Settings and Configuration","href":"/windows/build-cache-config-basic"},{"title":"Build Cache - Managing Build Cache","href":"/windows/coordinator-buildcache"},{"title":"Build Cache - Monitoring and Diagnosing Efficiency","href":"/windows/build-cache-monitor"},{"title":"Build Cache - Advanced New Project Workflow","href":"/windows/build-cache-workflow"},{"title":"Build Cache - Known Paths and Path Normalization","href":"/windows/build-cache-known-paths"},{"group":"Build Cache Project Structure","pages":[{"title":"Build Cache - How Project Structure can Affect Efficiency","href":"/windows/build-cache-project-structure"},{"title":"Build Cache - How Auto-Generated Code can Affect Efficiency","href":"/windows/build-cache-auto-gen-code"}]},{"title":"Build Cache - How Pre-Compiled Headers can Affect Efficiency","href":"/windows/build-cache-pch"}]},{"title":"SSL, Encryption, and Other Security Settings","href":"/windows/ssl"},{"title":"Concurrent Incredibuild Command Execution","href":"/windows/enterprise-concurrent-commands"},{"title":"Helper to Service Multiple Builds","href":"/windows/enterprise-helper-multi-builds"},{"group":"Agent Settings","pages":[{"title":"Agent Settings","href":"/windows/agent-settings"},{"title":"Agent options","href":"/windows/agent-options"},{"title":"Network","href":"/windows/network"},{"title":"Initiator","href":"/windows/initiator"},{"title":"Build Cache Endpoint","href":"/windows/build-cache-agent-settings"},{"title":"Build Cache Client","href":"/windows/build-cache-agent-settings2"},{"title":"Helper","href":"/windows/helper"},{"title":"Build Monitor","href":"/windows/build-monitor-options"},{"title":"Visual Studio Builds","href":"/windows/visual-studio-builds"},{"title":"Visual Studio Add-in","href":"/windows/visual-studio-add-in"},{"title":"Tray Icon","href":"/windows/tray-icon-settings"}]},{"title":"Coordinator Settings","href":"/windows/coordinator-settings"},{"title":"Incredibuild Cloud","href":"/windows/cloud-overview"},{"title":"Working from Home","href":"/windows/work-from-home"},{"title":"Globalization","href":"/windows/globalization"},{"title":"Coordinator Console Utility (xgCoordConsole.exe)","href":"/windows/coord-console-utility"},{"title":"Site Survey Tool","href":"/windows/site-survey-tool"}]},{"group":"Running Builds","root":{"title":"Running Builds","href":"/windows/running-builds"},"pages":[{"title":"Running Builds Quick Start","href":"/windows/running-builds-quick-start"},{"title":"Running Builds from Visual Studio","href":"/windows/running-build-from-visual-studio"},{"title":"Running Builds from RustRover","href":"/windows/running-build-from-rustrover"},{"title":"BuildConsole for Visual Studio","href":"/windows/build-console-cli"},{"title":"BuildConsole for Make and Build Tools","href":"/windows/running-from-command-line"},{"title":"Running Gitlab Builds with Incredibuild","href":"/windows/gitlab"},{"title":"Modify Settings per Build using a Configuration File","href":"/windows/modify-settings-per-build"},{"title":"Running Projects Created with CMake","href":"/windows/cmake-profile"},{"title":"Running Builds in Visual Studio Code","href":"/windows/running-vs-code"},{"title":"Running Builds for Bazel","href":"/windows/bazel"},{"title":"Running Builds for Rust","href":"/windows/rust"},{"title":"Running Builds for NVCC","href":"/windows/nvcc"},{"title":"Running Builds with Perl","href":"/windows/perl"},{"title":"Accelerating Unity builds with Incredibuild","href":"/windows/unity"}]},{"group":"Monitoring","root":{"title":"Monitoring Builds","href":"/windows/monitor-builds"},"pages":[{"title":"The Build Monitor Overview","href":"/windows/build-monitor-what-to-know"},{"title":"The Build Monitor Settings","href":"/windows/build-monitor-settings"},{"title":"Exporting the Build Monitor Log from the Command Line","href":"/windows/export-build-monitor-log-cli"},{"title":"Builds Dashboard","href":"/windows/dashboard-builds"},{"title":"Utilization Dashboard","href":"/windows/dashboard-utilization"},{"title":"Build List","href":"/windows/build-list"}]},{"group":"API","root":{"title":"API Reference","href":"/windows/api"},"pages":[{"title":"API Keys","href":"/windows/api-keys"},{"title":"User Management API","href":"/windows/api-users"},{"title":"External User Management API","href":"/windows/api-external-user"},{"title":"Assign Licenses via API","href":"/windows/api-assign-license"},{"title":"Build History API","href":"/windows/api-build-data"},{"title":"Build Cache API","href":"/windows/build-cache-api"},{"title":"Agent Priority API","href":"/windows/api-assign-priority"},{"title":"Health API","href":"/windows/api-health"}]},{"group":"Additional Resources","root":{"title":"Additional Resources","href":"/windows/additional-resources"},"pages":[{"group":"Troubleshooting Issues","root":{"title":"Troubleshooting Issues","href":"/windows/troubleshooting-issues"},"pages":[{"title":"Frequently Asked Questions","href":"/windows/faq"},{"title":"Exporting Logs to Support","href":"/windows/exporting-logs"},{"title":"Network Connectivity Test","href":"/windows/network-connectivity-test"},{"title":"General Performance Boost Tips","href":"/windows/general-performance-boost"},{"title":"Incredibuild Help","href":"/windows/help-menu"}]},{"title":"Case Studies","href":"/windows/case-studies"},{"title":"List of Open Sources","href":"/windows/open-sources"}]},{"group":"Other","root":{"title":"Downloads and Documentation Center","href":"/site-landing/download-docs-center"},"pages":[{"title":"Incredibuild for Linux","href":"/site-landing/linux-index"},{"title":"Open Sources","href":"/site-landing/open-sources"},{"title":"Windows vs. Linux: Features Comparison","href":"/site-landing/win-lin-features"},{"title":"Adding the Incredibuild Self-Signed Certificate to Your API Client Tool","href":"/windows/add-cert-to-api-client-tool"},{"title":"Administration Settings","href":"/windows/admin-settings"},{"title":"Assigning Agents to a Build Group","href":"/windows/assigning-agents-to-build-group"},{"title":"Assigning Agents to Build Groups During Installation","href":"/windows/assigning-agents-to-build-groups"},{"title":"Build Cache -","href":"/windows/build-cache-concepts"},{"title":"Build Cache - Customizing Settings Per Build","description":null,"href":"/windows/build-cache-customize"},{"title":"Build Cache - New Project Playbook","href":"/windows/build-cache-playbook"},{"title":"Build Group API","description":null,"href":"/windows/build-group-api-syntax"},{"title":"Clearing a Build Group","href":"/windows/clearing-build-group"},{"title":"Configuring Your API Client Tool for Using the Build Group APIs","href":"/windows/config-api-tool-for-build-group"},{"title":"Enabling the Use of Build Group APIs in the Coordinator","href":"/windows/enabling-use-build-group-apis"},{"title":"Dashboard","href":"/windows/enterprise-dashboard"},{"title":"Helpers Resource Utilization Graphs","href":"/windows/enterprise-helpers-resource-util-graphs"},{"title":"Legal Notice","href":"/windows/enterprise-legal"},{"title":"Enterprise Features","href":"/windows/enterprise-overview"},{"title":"Incredibuild Extension for VSTS and TFS","href":"/windows/enterprise-vsts-tfs-extension"},{"title":"Getting Agent Details","href":"/windows/getting-agent-details"},{"title":"Getting the List of Agents in a Build Group","href":"/windows/getting-list-agents-in-build-group"},{"title":"Getting the List of Build Groups","href":"/windows/getting-list-build-groups"},{"title":"Importing the Incredibuild Self-Signed Certificate","href":"/windows/importing-self-signed-certificate"},{"title":"Installing Incredibuild Components","href":"/windows/install-components"},{"title":"Incredibuild for Windows Product Tiers","href":"/windows/product-tiers"},{"title":"Build History API","href":"/windows/rest-api-build-cache-actions"},{"title":"Setting Up Your API Environment and Tool","href":"/windows/setting-up-api-environment"},{"title":"Generating a Baseline Execution for Benchmarking","href":"/windows/trial-baseline-benchmarking"},{"title":"Executing Your Build Using Make and Other Build Tools","href":"/windows/trial-execute-using-make"},{"title":"Executing Your Build Using Incredibuild","href":"/windows/trial-executing-builds"},{"title":"Generating Logs","href":"/windows/trial-generate-logs"},{"title":"Generating Logs for Failed Builds","href":"/windows/trial-generate-logs-failed-builds"},{"title":"Generating Logs for Successful Builds","href":"/windows/trial-generate-logs-successful-builds"},{"title":"Installing Incredibuild Windows","href":"/windows/trial-installation"},{"title":"Installing the Coordinator and Activating Incredibuild by Loading Its License","href":"/windows/trial-install-activate-load-license"},{"title":"Installing Additional Agents","href":"/windows/trial-install-agents"},{"title":"Opening the Coordinator Monitor and Verifying the Installation Success","href":"/windows/trial-open-coordinator-verify-installation"},{"title":"Trial Requirements","href":"/windows/trial-requirements"},{"title":"Trial Scope","href":"/windows/trial-scope"},{"title":"Setting Up Incredibuild Environment","href":"/windows/trial-setup"},{"title":"Understanding Incredibuild Architecture","href":"/windows/trial-understand-architecture"},{"title":"Executing Your Build Using Visual Studio","href":"/windows/trial-visual-studio"},{"title":"Executing Your Visual Studio Build Using the Command Line","href":"/windows/trial-visual-studio-command-line"},{"title":"Incredibuild Free Trial Overview","href":"/windows/trial-welcome"},{"title":"Installing the Visual Studio Extension","href":"/windows/visual-studio-install"},{"title":"Uninstalling Incredibuild with the Visual Studio Extension","href":"/windows/visual-studio-uninstall"},{"title":"What Comes with the Trial Version?","href":"/windows/what-comes-with-trial"},{"title":"Advanced Test Level Optimization","href":"/windows/z-advanced-test-level-optimization"},{"title":"IBTestConsole Command Interface (for NUnit, GTest)","href":"/windows/z-ibtestconsole-interface"},{"title":"Incredibuild Documentation","href":"/windows/site-landing-page/index"},{"title":"Build Cache - How Project Structure can Affect Efficiency","href":"/windows/build-cache-project-structure2"},{"title":"Incredibuild for Windows","href":"/windows/index"}]}]},{"version":"10.38.0","pages":[{"title":"10.38.0","href":"/windows/10.38.0/_shared/site-landing/download-docs-center"}]},{"version":"10.37.1","pages":[{"title":"10.37.1","href":"/windows/10.37.1/_shared/site-landing/download-docs-center"}]},{"version":"10.37.0","pages":[{"title":"10.37.0","href":"/windows/10.37.0/_shared/site-landing/download-docs-center"}]},{"version":"10.36.3","pages":[{"title":"10.36.3","href":"/windows/10.36.3/_shared/site-landing/download-docs-center"}]},{"version":"10.36.2","pages":[{"title":"10.36.2","href":"/windows/10.36.2/_shared/site-landing/download-docs-center"}]},{"version":"10.36.1","pages":[{"title":"10.36.1","href":"/windows/10.36.1/_shared/site-landing/download-docs-center"}]},{"version":"10.36.0","pages":[{"title":"10.36.0","href":"/windows/10.36.0/_shared/site-landing/download-docs-center"}]},{"version":"10.35.3","pages":[{"title":"10.35.3","href":"/windows/10.35.3/build-group-api-syntax"}]},{"version":"10.35.2","pages":[{"title":"10.35.2","href":"/windows/10.35.2/build-group-api-syntax"}]},{"version":"10.35.1","pages":[{"title":"10.35.1","href":"/windows/10.35.1/build-group-api-syntax"}]},{"version":"10.35.0","pages":[{"title":"10.35.0","href":"/windows/10.35.0/_shared/site-landing/download-docs-center"}]},{"version":"10.34.3","pages":[{"title":"10.34.3","href":"/windows/10.34.3"}]},{"version":"10.34.2","pages":[{"title":"10.34.2","href":"/windows/10.34.2"}]},{"version":"10.34.1","pages":[{"title":"10.34.1","href":"/windows/10.34.1"}]},{"version":"10.34.0","pages":[{"title":"10.34.0","href":"/windows/10.34.0"}]},{"version":"10.33.0","pages":[{"title":"10.33.0","href":"/windows/10.33.0"}]},{"version":"10.32.2","pages":[{"title":"10.32.2","href":"/windows/10.32.2"}]},{"version":"10.32.1","pages":[{"title":"10.32.1","href":"/windows/10.32.1"}]},{"version":"10.32.0","pages":[{"title":"10.32.0","href":"/windows/10.32.0"}]},{"version":"10.31.2","pages":[{"title":"10.31.2","href":"/windows/10.31.2"}]},{"version":"10.31.1","pages":[{"title":"10.31.1","href":"/windows/10.31.1"}]},{"version":"10.31.0","pages":[{"title":"10.31.0","href":"/windows/10.31.0"}]},{"version":"10.30.0","pages":[{"title":"10.30.0","href":"/windows/10.30.0"}]},{"version":"10.29.1","pages":[{"title":"10.29.1","href":"/windows/10.29.1"}]},{"version":"10.29","pages":[{"title":"10.29","href":"/windows/10.29"}]},{"version":"10.28","pages":[{"title":"10.28","href":"/windows/10.28"}]},{"version":"10.27.1","pages":[{"title":"10.27.1","href":"/windows/10.27.1"}]},{"version":"10.27","pages":[{"title":"10.27","href":"/windows/10.27"}]},{"version":"10.26","pages":[{"title":"10.26","href":"/windows/10.26"}]}]},{"product":"Linux","icon":"linux","directory":"card","pages":[{"title":"Linux","href":"/linux/overview"}]},{"product":"Mac","icon":"apple","directory":"card","pages":[{"title":"Mac","href":"/mac/overview"}]},{"product":"Cloud","icon":"cloud","directory":"card","pages":[{"title":"Cloud","href":"/cloud/overview"}]},{"product":"Incredibuild Console","icon":"gauge","directory":"card","pages":[{"title":"Incredibuild Console","href":"/console/overview"}]}]},"title":"Build Cache - New Project Playbook - IncrediBuild Documentation","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":[],"chunks":[]}