Use capy transport and capy pair to move machine-held Capy key material through a signed-in browser.
Capy keeps your wrapped key material on your machines. Moving to another computer is therefore an explicit transfer, not a normal sign-in restoring a server-side key backup.
Move keys with a browser transport
On a machine that already has your keys, run capy transport.
Open or scan the QR code in a browser you can access later. Sign in with the same Capy account. The browser activates the one-time transport.
On the new machine, run capy pair. Open or scan its QR code and approve the device grant in a browser.
Read the account Capy shows and explicitly confirm it. The default is No. Only then does the new machine install its session and the key entries activated for that account.
The transport link expires at the time Capy prints. It is one-time: activation deletes the server-side transport record.
The full transport link is sensitive. Its fragment contains a fresh one-time key that is deliberately not sent to the service. Do not share or log the link, QR code, or --json output.
How the transfer protects keys
For Transport v4, the original machine encrypts a package containing its local key material with a fresh random key. The service stores the encrypted package. The browser link holds the transport id and random key separately, so the service cannot decrypt the stored package from its own data alone.The browser requires a sign-in to activate the transport. capy pair uses a separate browser device grant and confirms the returned account before installing anything. That confirmation protects against silently attaching a shared machine to the wrong account.
Other recovery paths
If you own the organization and retained its 24-word recovery phrase, use capy recover on the new machine. The phrase re-derives the organization key locally; Capy cannot reconstruct a lost phrase.If you do not have that phrase or another paired device, ask an admin to issue a fresh invite. Run capy redeem <code> on the new machine. Invite codes and browser transports are different flows: do not use capy redeem for a Transport v4 link.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Capy","colors":{"primary":"#111827","light":"#F3F4F6","dark":"#1F2937"},"logo":{"light":"https://mintcdn.com/capy-c95c79c0/0lifWkS5AhgCAL5O/logo/light.svg?fit=max\u0026auto=format\u0026n=0lifWkS5AhgCAL5O\u0026q=85\u0026s=6dbaa69a4097411658ee2d1f2f0742d5","dark":"https://mintcdn.com/capy-c95c79c0/0lifWkS5AhgCAL5O/logo/dark.svg?fit=max\u0026auto=format\u0026n=0lifWkS5AhgCAL5O\u0026q=85\u0026s=051c89470aaa2b19badeeb3b1963c140"},"favicon":"https://mintcdn.com/capy-c95c79c0/0lifWkS5AhgCAL5O/favicon.svg?fit=max\u0026auto=format\u0026n=0lifWkS5AhgCAL5O\u0026q=85\u0026s=e9e83bcf39f9961c84f829fe4ffbd771","navbar":{"links":[{"href":"https://github.com/capysc/capy-cli/releases","label":"Releases"}],"primary":{"type":"github","href":"https://github.com/capysc/capy-cli"}},"footer":{"socials":{"github":"https://github.com/capysc"}},"seo":{"metatags":{"og:site_name":"Capy","og:image:width":"1200","og:image:height":"630","twitter:card":"summary_large_image","robots":"index, follow"}},"integrations":{"amplitude":{"apiKey":"cc149792a0bc4296a9cfbab10a095306"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"capy-c95c79c0","hasAudioNarration":false,"actualSubdomain":"capy-c95c79c0","customDomains":["capy.sc"],"gitSource":{"type":"github","owner":"capysc","repo":"docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afff0c410972e65991ee1b3","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"CLI reference","count":37},{"language":"default","tag":"Deploying","count":9},{"language":"default","tag":"Getting started","count":8},{"language":"default","tag":"Using Capy","count":7},{"language":"default","tag":"Comparisons","count":6},{"language":"default","tag":"Under the hood","count":3},{"language":"default","tag":"Organizations","count":3},{"language":"default","tag":"Team","count":3},{"language":"default","tag":"Branches","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"using/organizations/switching-computers","slug":"/using/organizations/switching-computers","pageMetadata":{"title":"Move Your Capy Identity to a New Computer","sidebarTitle":"Switching computers","description":"Use capy transport and capy pair to move machine-held Capy key material through a signed-in browser.","icon":"laptop","href":"/using/organizations/switching-computers"},"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: \"Use capy transport and capy pair to move machine-held Capy key material through a signed-in browser.\"\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`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Capy keeps your wrapped key material on your machines. Moving to another computer is therefore an explicit transfer, not a normal sign-in restoring a server-side key backup.`}),`\n`,_jsx(Heading,{level:`2`,id:`move-keys-with-a-browser-transport`,children:`Move keys with a browser transport`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`On a machine that already has your keys, run `,_jsx(_components.code,{children:`capy transport`}),`.`]}),`\n`,_jsx(_components.li,{children:`Open or scan the QR code in a browser you can access later. Sign in with the same Capy account. The browser activates the one-time transport.`}),`\n`,_jsxs(_components.li,{children:[`On the new machine, run `,_jsx(_components.code,{children:`capy pair`}),`. Open or scan its QR code and approve the device grant in a browser.`]}),`\n`,_jsxs(_components.li,{children:[`Read the account Capy shows and explicitly confirm it. The default is `,_jsx(_components.strong,{children:`No`}),`. Only then does the new machine install its session and the key entries activated for that account.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`The transport link expires at the time Capy prints. It is one-time: activation deletes the server-side transport record.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The full transport link is sensitive. Its fragment contains a fresh one-time key that is deliberately not sent to the service. Do not share or log the link, QR code, or `,_jsx(_components.code,{children:`--json`}),` output.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`how-the-transfer-protects-keys`,children:`How the transfer protects keys`}),`\n`,_jsx(_components.p,{children:`For Transport v4, the original machine encrypts a package containing its local key material with a fresh random key. The service stores the encrypted package. The browser link holds the transport id and random key separately, so the service cannot decrypt the stored package from its own data alone.`}),`\n`,_jsxs(_components.p,{children:[`The browser requires a sign-in to activate the transport. `,_jsx(_components.code,{children:`capy pair`}),` uses a separate browser device grant and confirms the returned account before installing anything. That confirmation protects against silently attaching a shared machine to the wrong account.`]}),`\n`,_jsx(Heading,{level:`2`,id:`other-recovery-paths`,children:`Other recovery paths`}),`\n`,_jsxs(_components.p,{children:[`If you own the organization and retained its 24-word recovery phrase, use `,_jsx(_components.code,{children:`capy recover`}),` on the new machine. The phrase re-derives the organization key locally; Capy cannot reconstruct a lost phrase.`]}),`\n`,_jsxs(_components.p,{children:[`If you do not have that phrase or another paired device, ask an admin to issue a fresh invite. Run `,_jsx(_components.code,{children:`capy redeem \u003ccode>`}),` on the new machine. Invite codes and browser transports are different flows: do not use `,_jsx(_components.code,{children:`capy redeem`}),` for a Transport v4 link.`]}),`\n`,_jsx(Heading,{level:`2`,id:`see-also`,children:`See also`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/cli/transport`,children:_jsx(_components.code,{children:`capy transport`})}),` — create a browser transport`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/cli/pair`,children:_jsx(_components.code,{children:`capy pair`})}),` — add the new machine`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/internals/zero-trust`,children:`Zero trust`}),` — custody and revocation model`]}),`\n`]})]})}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":"Move Your Capy Identity to a New Computer","sidebarTitle":"Switching computers","description":"Use capy transport and capy pair to move machine-held Capy key material through a signed-in browser.","icon":"laptop","href":"/using/organizations/switching-computers"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Move keys with a browser transport","slug":"move-keys-with-a-browser-transport","depth":2,"children":[]},{"title":"How the transfer protects keys","slug":"how-the-transfer-protects-keys","depth":2,"children":[]},{"title":"Other recovery paths","slug":"other-recovery-paths","depth":2,"children":[]},{"title":"See also","slug":"see-also","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"capy-c95c79c0","siteName":"Capy","title":"Move Your Capy Identity to a New Computer - Capy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-02T02:54:00.901Z","gitLastModified":"2026-10-02T02:52:41.000Z","originalFileLocation":"using/organizations/switching-computers.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=\"description\" content=\"Use capy transport and capy pair to move machine-held Capy key material through a signed-in browser.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Capy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/capy-c95c79c0/PO8F9vHytDqmbRar/_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/capy-c95c79c0/PO8F9vHytDqmbRar/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/capy-c95c79c0/PO8F9vHytDqmbRar/_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/capy-c95c79c0/PO8F9vHytDqmbRar/_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/capy-c95c79c0/PO8F9vHytDqmbRar/_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/capy-c95c79c0/PO8F9vHytDqmbRar/_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/capy-c95c79c0/PO8F9vHytDqmbRar/_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/capy-c95c79c0/PO8F9vHytDqmbRar/_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/capy-c95c79c0/PO8F9vHytDqmbRar/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Move Your Capy Identity to a New Computer - Capy\">\u003cmeta data-mint-head property=\"og:description\" content=\"Use capy transport and capy pair to move machine-held Capy key material through a signed-in browser.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Capy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://capy.sc/docs/using/organizations/switching-computers\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://capy-c95c79c0.mintlify.site/docs/_mintlify/api/og/v2?division=Organizations\u0026amp;title=Move+Your+Capy+Identity+to+a+New+Computer\u0026amp;description=Use+capy+transport+and+capy+pair+to+move+machine-held+Capy+key+material+through+a+signed-in+browser.\u0026amp;theme=f09b04d0a98ab37048027f8b\u0026amp;signature=fb112b1b6afb85da29e36d3615d71026dbc11c6d7625be56a9e3c4196f656b58\">\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=\"Move Your Capy Identity to a New Computer - Capy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Use capy transport and capy pair to move machine-held Capy key material through a signed-in browser.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://capy-c95c79c0.mintlify.site/docs/_mintlify/api/og/v2?division=Organizations\u0026amp;title=Move+Your+Capy+Identity+to+a+New+Computer\u0026amp;description=Use+capy+transport+and+capy+pair+to+move+machine-held+Capy+key+material+through+a+signed-in+browser.\u0026amp;theme=f09b04d0a98ab37048027f8b\u0026amp;signature=fb112b1b6afb85da29e36d3615d71026dbc11c6d7625be56a9e3c4196f656b58\">\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/capy-c95c79c0/PO8F9vHytDqmbRar/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Capy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#111827\">\u003clink data-mint-head rel=\"canonical\" href=\"https://capy.sc/docs/using/organizations/switching-computers\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/using/organizations/switching-computers.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://capy.sc/#organization\",\"name\":\"Capy\",\"url\":\"https://capy.sc\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/capy-c95c79c0/0lifWkS5AhgCAL5O/logo/light.svg?fit=max\u0026auto=format\u0026n=0lifWkS5AhgCAL5O\u0026q=85\u0026s=6dbaa69a4097411658ee2d1f2f0742d5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://capy.sc/docs#website\",\"name\":\"Capy\",\"url\":\"https://capy.sc/docs\",\"publisher\":{\"@id\":\"https://capy.sc/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://capy.sc/docs/using/organizations/switching-computers#webpage\",\"url\":\"https://capy.sc/docs/using/organizations/switching-computers\",\"name\":\"Move Your Capy Identity to a New Computer\",\"description\":\"Use capy transport and capy pair to move machine-held Capy key material through a signed-in browser.\",\"dateModified\":\"2026-10-02T02:52:41.000Z\",\"isPartOf\":{\"@id\":\"https://capy.sc/docs#website\"},\"breadcrumb\":{\"@id\":\"https://capy.sc/docs/using/organizations/switching-computers#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://capy.sc/docs/using/organizations/switching-computers#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Organizations\",\"item\":\"https://capy.sc/docs/using/organizations/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Move Your Capy Identity to a New Computer\",\"item\":\"https://capy.sc/docs/using/organizations/switching-computers\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://capy.sc/docs/using/organizations/switching-computers#article\",\"headline\":\"Move Your Capy Identity to a New Computer\",\"name\":\"Move Your Capy Identity to a New Computer\",\"description\":\"Use capy transport and capy pair to move machine-held Capy key material through a signed-in browser.\",\"url\":\"https://capy.sc/docs/using/organizations/switching-computers\",\"mainEntityOfPage\":{\"@id\":\"https://capy.sc/docs/using/organizations/switching-computers#webpage\"},\"dateModified\":\"2026-10-02T02:52:41.000Z\",\"publisher\":{\"@id\":\"https://capy.sc/#organization\"},\"isPartOf\":{\"@id\":\"https://capy.sc/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Capy\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Capy\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/using/organizations/switching-computers.md","siteName":"Capy","nav":{"global":null,"groups":[{"group":" ","pages":[{"title":"Capy: Git-Native Secrets Manager for Engineering Teams","sidebarTitle":"Overview","href":"/index"}]},{"group":"Getting started","pages":[{"title":"Install the Capy CLI","sidebarTitle":"Install","icon":"download","href":"/getting-started/install"},{"title":"Manage Node.js Environment Variables Securely (Capy)","sidebarTitle":"Node.js","icon":"node-js","href":"/getting-started/nodejs"},{"title":"Next.js Environment Variables: Encrypted Secrets","sidebarTitle":"Next.js","icon":"react","href":"/getting-started/nextjs"},{"title":"Python Secrets Management: Encrypted .env Files","sidebarTitle":"Python","icon":"python","href":"/getting-started/python"},{"title":"Go Environment Variables: Secrets Manager for Go Apps","sidebarTitle":"Go","icon":"golang","href":"/getting-started/go"},{"title":"Ruby \u0026 Rails Secrets Management with Capy","sidebarTitle":"Ruby","icon":"gem","href":"/getting-started/ruby"},{"title":"Rust Secrets Management: Encrypted Env for Cargo","sidebarTitle":"Rust","icon":"rust","href":"/getting-started/rust"},{"title":"Encrypted Secrets for PHP, Java, Elixir, Deno \u0026 More","sidebarTitle":"Other runtimes","icon":"terminal","href":"/getting-started/other-runtimes"}]},{"group":"Using Capy","pages":[{"title":"Sync Encrypted .env Across Your Team (Capy)","sidebarTitle":"Syncing secrets","icon":"arrows-rotate","href":"/using/syncing-secrets"},{"title":"Questions Capy Asks Agents: Elicitations","sidebarTitle":"Agent questions","icon":"robot","href":"/using/agent-questions"},{"title":"Adding secrets","sidebarTitle":"Adding secrets","icon":"plus","href":"/using/adding-secrets"},{"title":"Edit Secrets: Capy TUI vs. Editing .env Directly","sidebarTitle":"Editing secrets","icon":"pen-to-square","href":"/using/editing-secrets"},{"title":"Removing secrets","sidebarTitle":"Removing secrets","icon":"minus","href":"/using/removing-secrets"},{"title":"How capy run Decrypts Secrets at Runtime","sidebarTitle":"Running your app","icon":"play","href":"/using/running-your-app"},{"title":"Capy CLI license","sidebarTitle":"License \u0026 AGPL","href":"/using/license"}]},{"group":"Deploying","pages":[{"title":"Deploy Encrypted Secrets to Production with Capy","sidebarTitle":"Overview","icon":"rocket","href":"/using/deploying"},{"title":"Vercel","sidebarTitle":"Vercel","icon":"triangle","href":"/using/deploying/vercel"},{"title":"Cloudflare Workers and Pages","sidebarTitle":"Cloudflare","icon":"cloudflare","href":"/using/deploying/cloudflare"},{"title":"Docker and containers","sidebarTitle":"Docker","icon":"docker","href":"/using/deploying/docker"},{"title":"VPS and self-managed servers","sidebarTitle":"VPS / droplet","icon":"server","href":"/using/deploying/vps"},{"title":"Fly.io","sidebarTitle":"Fly.io","icon":"plane","href":"/using/deploying/fly"},{"title":"Railway, Render, and Heroku","sidebarTitle":"Railway / Render / Heroku","icon":"server","href":"/using/deploying/railway-render-heroku"},{"title":"GitHub Actions","sidebarTitle":"GitHub Actions","icon":"github","href":"/using/deploying/github-actions"},{"title":"AWS Lambda","sidebarTitle":"AWS Lambda","icon":"aws","href":"/using/deploying/aws-lambda"}]},{"group":"Organizations","pages":[{"title":"Capy Organizations: Cryptographic Tenant Boundary","sidebarTitle":"Organizations","icon":"building","href":"/using/organizations/overview"},{"title":"Switch Between Capy Organizations on One Machine","sidebarTitle":"Switching organizations","description":"Use capy org to move between the Capy organizations you belong to. Picking an org re-points the current directory's keep.lock at that org and one of its projects.","icon":"arrows-left-right","href":"/using/organizations/switching"},{"title":"Move Your Capy Identity to a New Computer","sidebarTitle":"Switching computers","icon":"laptop","href":"/using/organizations/switching-computers"}]},{"group":"Branches","pages":[{"title":"Branch-Aware Secrets: Per-Environment .env Files","sidebarTitle":"Branches","description":"Capy branches give each environment — dev, staging, prod — its own encrypted secret set, pinned by the committed keep.lock manifest. Switch with capy checkout.","icon":"code-branch","href":"/using/branches/overview"},{"title":"Protected Branches: Lock Down Production Secrets","sidebarTitle":"Protected branches","icon":"shield","href":"/using/branches/protected"}]},{"group":"Team","pages":[{"title":"Invite Teammates to Capy: Share Encrypted Access","sidebarTitle":"Inviting users","icon":"user-plus","href":"/using/team/inviting"},{"title":"Capy Roles: Owner, Admin, Project Admin, Member","sidebarTitle":"Roles","icon":"user-shield","href":"/using/team/roles"},{"title":"Remove a Teammate: O(1) Revocation in Capy","sidebarTitle":"Kicking users","icon":"user-minus","href":"/using/team/kicking"}]},{"group":"CLI reference","pages":[{"title":"capy Command: Sync Encrypted Secrets","sidebarTitle":"capy","href":"/cli/capy"},{"title":"capy run: Inject Decrypted Secrets at Runtime","sidebarTitle":"capy run","href":"/cli/run"},{"title":"capy status: Show Drift Between Local \u0026 Remote","sidebarTitle":"capy status","href":"/cli/status"},{"title":"capy edit: Interactive TUI for Secret Editing","sidebarTitle":"capy edit","href":"/cli/edit"},{"title":"capy add: Add Secrets","sidebarTitle":"capy add","href":"/cli/add"},{"title":"capy remove: Delete Secrets","sidebarTitle":"capy remove","href":"/cli/remove"},{"title":"capy list: List Variables on a Branch","sidebarTitle":"capy list","href":"/cli/list"},{"title":"capy push: Publish Local Secret Changes","sidebarTitle":"capy push","href":"/cli/push"},{"title":"capy connect: Link a Credential Provider","sidebarTitle":"capy connect","href":"/cli/connect"},{"title":"capy rotate: Rotate Managed Credentials","sidebarTitle":"capy rotate","href":"/cli/rotate"},{"title":"capy deploy: Set Up Encrypted Production Secrets","sidebarTitle":"capy deploy","href":"/cli/deploy"},{"title":"capy agents: Add Capy Instructions for Coding Agents","sidebarTitle":"capy agents","href":"/cli/agents"},{"title":"capy help: Inspect the Command Reference","sidebarTitle":"capy help","href":"/cli/help"},{"title":"capy transport: Send Keys to a Browser","sidebarTitle":"capy transport","href":"/cli/transport"},{"title":"capy pair: Pair This Machine Through a Browser","sidebarTitle":"capy pair","href":"/cli/pair"},{"title":"capy lock: Lock a Local-Only Key","sidebarTitle":"capy lock","href":"/cli/lock"},{"title":"capy invite: Add a Teammate to Your Organization","sidebarTitle":"capy invite","href":"/cli/invite"},{"title":"capy redeem: Accept an Invite to a Capy Org","sidebarTitle":"capy redeem","href":"/cli/redeem"},{"title":"capy kick: Remove a Teammate from Your Org","sidebarTitle":"capy kick","href":"/cli/kick"},{"title":"capy users: Interactive Team \u0026 Role Management","sidebarTitle":"capy users","href":"/cli/users"},{"title":"capy projects: List Organization Projects","sidebarTitle":"capy projects","href":"/cli/projects"},{"title":"capy project: Create, Delete, and Restore Projects","sidebarTitle":"capy project","href":"/cli/project"},{"title":"capy secrets: Inspect Secret Names Across an Organization","sidebarTitle":"capy secrets","href":"/cli/secrets"},{"title":"capy grant-branch: Scriptable Branch Access","sidebarTitle":"capy grant-branch","href":"/cli/grant-branch"},{"title":"capy revoke-branch: Scriptable Branch Revoke","sidebarTitle":"capy revoke-branch","href":"/cli/revoke-branch"},{"title":"capy branch: List, Delete, Switch Secret Branches","sidebarTitle":"capy branch","href":"/cli/branch"},{"title":"capy checkout: Switch or Create a Secret Branch","sidebarTitle":"capy checkout","href":"/cli/checkout"},{"title":"capy org: Switch Your Active Organization","sidebarTitle":"capy org","href":"/cli/org"},{"title":"capy info: Show Current Session \u0026 Project","sidebarTitle":"capy info","href":"/cli/info"},{"title":"capy byoc: Connect to a Self-Hosted Capy Instance","sidebarTitle":"capy byoc","href":"/cli/byoc"},{"title":"capy profile and use: Manage CLI Profiles","sidebarTitle":"capy profile","href":"/cli/profile"},{"title":"capy logout: End Session and Clear Cached Keys","sidebarTitle":"capy logout","href":"/cli/logout"},{"title":"capy recover: Restore a Lost Master Key","sidebarTitle":"capy recover","href":"/cli/recover"},{"title":"capy decrypt: Decrypt Secrets During Recovery","sidebarTitle":"capy decrypt","href":"/cli/decrypt"},{"title":"capy end-recover: Clean Up Recovery Files","sidebarTitle":"capy end-recover","href":"/cli/end-recover"},{"title":"capy system: Manage Connector Credentials","sidebarTitle":"capy system","href":"/cli/system"},{"title":"capy cleanup: Remove Capy Git Hooks","sidebarTitle":"capy cleanup","href":"/cli/cleanup"}]},{"group":"Under the hood","pages":[{"title":"Capy Architecture: How CLI and Service Fit Together","sidebarTitle":"Architecture","icon":"sitemap","href":"/internals/architecture"},{"title":"Zero-Trust Secrets Management: How Capy Works","sidebarTitle":"Zero trust","icon":"shield-halved","href":"/internals/zero-trust"},{"title":"Capy Cryptography: BIP-39 to AES-256-GCM","sidebarTitle":"Cryptography","icon":"shield-halved","href":"/internals/cryptography"}]},{"group":"Comparisons","pages":[{"title":"Best Secrets Manager: Capy vs. Doppler, 1Password \u0026 More","sidebarTitle":"Choosing a secrets tool","href":"/comparisons/index"},{"title":"Capy vs. 1Password CLI: Secrets for Developers","sidebarTitle":"Capy and 1Password CLI","href":"/comparisons/1password"},{"title":"Capy vs. Doppler: Secrets Management Comparison","sidebarTitle":"Capy and Doppler","href":"/comparisons/doppler"},{"title":"Capy vs. Infisical: Client- vs. Server-Side E2EE","sidebarTitle":"Capy and Infisical","href":"/comparisons/infisical"},{"title":"Capy vs. AWS Secrets Manager: Different Jobs","sidebarTitle":"Capy and AWS Secrets Manager","href":"/comparisons/aws-secrets-manager"},{"title":"Capy vs. SOPS: Productized vs. DIY Secret Encryption","sidebarTitle":"Capy and SOPS","href":"/comparisons/sops"}]}]},"basePath":"","title":"Move Your Capy Identity to a New Computer - Capy","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":[],"chunks":[]}