https://docs.rancherdesktop.io/assets/js/74ed284a.4743dc25.js

1"use strict";(self.webpackChunkdocs_rancherdesktop_io=self.webpackChunkdocs_rancherdesktop_io||[]).push([[2866],{28453:(e,s,n)=>{n.d(s,{R:()=>l,x:()=>r});var i=n(96540);const a={},t=i.createContext(a);function l(e){const s=i.useContext(t);return i.useMemo((function(){return"function"==typeof e?e(s):{...s,...e}}),[s,e])}function r(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:l(e.components),i.createElement(t.Provider,{value:s},e.children)}},41669:(e,s,n)=>{n.d(s,{A:()=>l});var i=n(38193);const a=!!i.A.canUseDOM&&navigator.platform.startsWith("Mac"),t=!!i.A.canUseDOM&&navigator.platform.startsWith("Win"),l={defaultGuide:"quickstart",defaultOs:a?"macOS":t?"Windows":"Linux",defaultPackageManager:"npm",defaultPlatform:a?"ios":"android",defaultSyntax:"functional",defaultAndroidLanguage:"java",defaultJavaScriptSpecLanguages:"typescript",getDevNotesTabs:(e=["android","ios","web","windows"])=>[e.includes("android")?{label:"Android",value:"android"}:void 0,e.includes("ios")?{label:"iOS",value:"ios"}:void 0,e.includes("web")?{label:"Web",value:"web"}:void 0,e.includes("windows")?{label:"Windows",value:"windows"}:void 0].filter(Boolean),guides:[{label:"Expo Go Quickstart",value:"quickstart"},{label:"React Native CLI Quickstart",value:"native"}],oses:[{label:"macOS",value:"macOS"},{label:"Windows",value:"Windows"},{label:"Linux",value:"Linux"}],packageManagers:[{label:"npm",value:"npm"},{label:"Yarn",value:"yarn"}],platforms:[{label:"Android",value:"android"},{label:"iOS",value:"ios"}],syntax:[{label:"Function Component",value:"functional"},{label:"Class Component",value:"classical"}],androidLanguages:[{label:"Java",value:"java"},{label:"Kotlin",value:"kotlin"}],javaScriptSpecLanguages:[{label:"TypeScript",value:"typescript"},{label:"Flow",value:"flow"}],snackLanguages:[{label:"TypeScript",value:"typescript"},{label:"JavaScript",value:"javascript"}],defaultSnackLanguage:"typescript"}},61186:(e,s,n)=>{n.r(s),n.d(s,{assets:()=>o,contentTitle:()=>r,default:()=>u,frontMatter:()=>l,metadata:()=>i,toc:()=>c});const i=JSON.parse('{"id":"ui/preferences/virtual-machine/volumes","title":"Volumes (macOS & Linux)","description":"Mount Type","source":"@site/versioned_docs/version-1.15/ui/preferences/virtual-machine/volumes.md","sourceDirName":"ui/preferences/virtual-machine","slug":"/ui/preferences/virtual-machine/volumes","permalink":"/1.15/ui/preferences/virtual-machine/volumes","draft":false,"unlisted":false,"tags":[],"version":"1.15","frontMatter":{"sidebar_label":"Volumes","title":"Volumes (macOS & Linux)"},"sidebar":"tutorialSidebar","previous":{"title":"Hardware","permalink":"/1.15/ui/preferences/virtual-machine/hardware"},"next":{"title":"Emulation","permalink":"/1.15/ui/preferences/virtual-machine/emulation"}}');var a=n(74848),t=n(28453);n(41669);const l={sidebar_label:"Volumes",title:"Volumes (macOS & Linux)"},r=void 0,o={},c=[{value:"Mount Type",id:"mount-type",level:2},{value:"reverse-sshfs",id:"reverse-sshfs",level:3},{value:"9p",id:"9p",level:3},{value:"virtiofs",id:"virtiofs",level:3}];function d(e){const s={a:"a",admonition:"admonition",code:"code",h2:"h2",h3:"h3",img:"img",li:"li",p:"p",strong:"strong",ul:"ul",...(0,t.R)(),...e.components},{TabItem:n,Tabs:i}=s;return n||p("TabItem",!0),i||p("Tabs",!0),(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(s.h2,{id:"mount-type",children:"Mount Type"}),"\n",(0,a.jsx)(s.h3,{id:"reverse-sshfs",children:"reverse-sshfs"}),"\n",(0,a.jsxs)(i,{groupId:"os",children:[(0,a.jsx)(n,{value:"macOS",children:(0,a.jsx)(s.p,{children:(0,a.jsx)(s.img,{src:"https://suse-rancher-media.s3.amazonaws.com/desktop/v1.15/preferences/macOS_virtualMachine_tabVolumes.png",alt:""})})}),(0,a.jsx)(n,{value:"Linux",children:(0,a.jsx)(s.p,{children:(0,a.jsx)(s.img,{src:"https://suse-rancher-media.s3.amazonaws.com/desktop/v1.15/preferences/Linux_virtualMachine_tabVolumes.png",alt:""})})})]}),"\n",(0,a.jsxs)(s.p,{children:['Users can enable the "',(0,a.jsx)(s.a,{href:"https://lima-vm.io/docs/config/mount/#reverse-sshfs",children:"reverse-sshfs"}),'" mount type from the ',(0,a.jsx)(s.code,{children:"Volumes"}

1)," tab. This exposes the filesystem by running an SFTP server on the host. The host instance will then intitiate an SSH connection into the guest allowing it to connect to the SFTP server. This is the default mount type used in the application."]}),"\n",(0,a.jsx)(s.h3,{id:"9p",children:"9p"}),"\n",(0,a.jsxs)(i,{groupId:"os",children:[(0,a.jsx)(n,{value:"macOS",children:(0,a.jsx)(s.p,{children:(0,a.jsx)(s.img,{src:"https://suse-rancher-media.s3.amazonaws.com/desktop/v1.15/preferences/macOS_virtualMachine_tabVolumes_9P.png",alt:""})})}),(0,a.jsx)(n,{value:"Linux",children:(0,a.jsx)(s.p,{children:(0,a.jsx)(s.img,{src:"https://suse-rancher-media.s3.amazonaws.com/desktop/v1.15/preferences/Linux_virtualMachine_tabVolumes_9P.png",alt:""})})})]}),"\n",(0,a.jsx)(s.admonition,{title:"warning",type:"caution",children:(0,a.jsxs)(s.p,{children:["This is an ",(0,a.jsx)(s.strong,{children:"experimental"})," setting."]})}),"\n",(0,a.jsxs)(s.p,{children:['Users can enable the "',(0,a.jsx)(s.a,{href:"https://www.kernel.org/doc/Documentation/filesystems/9p.txt",children:"9p"}),'" mount type from the ',(0,a.jsx)(s.code,{children:"Volumes"})," tab. This will expose the filesystem by using QEMU's ",(0,a.jsx)(s.code,{children:"virtio-9p-pci"})," devices."]}),"\n",(0,a.jsxs)(s.ul,{children:["\n",(0,a.jsxs)(s.li,{children:["\n",(0,a.jsxs)(s.p,{children:["Cache Mode:\nSpecifies a caching policy that has a default setting as ",(0,a.jsx)(s.code,{children:"mmap"}),". The caching options are ",(0,a.jsx)(s.code,{children:"[none, loose, fscache, mmap]"}),"."]}),"\n"]}),"\n",(0,a.jsxs)(s.li,{children:["\n",(0,a.jsx)(s.p,{children:'Memory Size In KiB:\nUsers can specify the number of bytes to use for the "9p" packet size. The minimum value is 4 KiB and the default size is 128 KiB.'}),"\n"]}),"\n",(0,a.jsxs)(s.li,{children:["\n",(0,a.jsxs)(s.p,{children:['Protocol Version:\nUsers can select the "9p" protocol version. The options include ',(0,a.jsx)(s.code,{children:"[9p2000, 9p2000.u, 9p2000.L]"})," and the default protocol setting is ",(0,a.jsx)(s.code,{children:"9p200.L"}),"."]}),"\n"]}),"\n",(0,a.jsxs)(s.li,{children:["\n",(0,a.jsxs)(s.p,{children:["Security Model:\nUsers can select a supported security model with options being ",(0,a.jsx)(s.code,{children:"[passthrough, mapped-xattr, mapped-file, none]"}),". The default security setting value is ",(0,a.jsx)(s.code,{children:"none"}),"."]}),"\n"]}),"\n"]}),"\n",(0,a.jsx)(s.h3,{id:"virtiofs",children:"virtiofs"}),"\n",(0,a.jsxs)(i,{groupId:"os",children:[(0,a.jsx)(n,{value:"macOS",children:(0,a.jsx)(s.p,{children:(0,a.jsx)(s.img,{src:"https://suse-rancher-media.s3.amazonaws.com/desktop/v1.15/preferences/macOS_virtualMachine_tabVolumes.png",alt:""})})}),(0,a.jsx)(n,{value:"Linux",children:(0,a.jsx)(s.p,{children:(0,a.jsx)(s.img,{src:"https://suse-rancher-media.s3.amazonaws.com/desktop/v1.15/preferences/Linux_virtualMachine_tabVolumes.png",alt:""})})})]}),"\n",(0,a.jsx)(s.admonition,{title:"warning",type:"caution",children:(0,a.jsxs)(s.p,{children:["This is an ",(0,a.jsx)(s.strong,{children:"experimental"})," setting."]})}),"\n",(0,a.jsxs)(s.p,{children:["Users can enable the ",(0,a.jsx)(s.a,{href:"https://virtio-fs.gitlab.io/",children:(0,a.jsx)(s.code,{children:"virtiofs"})})," mount type from the ",(0,a.jsx)(s.code,{children:"Volumes"})," tab. This is implemented using the Apple ",(0,a.jsx)(s.code,{children:"Virtualization.Framework"})," shared directory device."]})]})}function u(e={}){const{wrapper:s}={...(0,t.R)(),...e.components};return s?(0,a.jsx)(s,{...e,children:(0,a.jsx)(d,{...e})}):d(e)}function p(e,s){throw new Error("Expected "+(s?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}}}]);