1"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[2753],{42950:(n,t,s)=>{s.r(t),s.d(t,{assets:()=>a,contentTitle:()=>o,default:()=>d,frontMatter:()=>l,metadata:()=>r,toc:()=>u});var e=s(74848),i=s(28453);const l={sidebar_position:4},o="Windows Subsystem for Linux (WSL2)",r={id:"quick-start/installation/wsl",title:"Windows Subsystem for Linux (WSL2)",description:"Run Tabby on Windows using Ubuntu via WSL2 for a native Linux experience with full GPU support and advanced developer control.",source:"@site/docs/quick-start/installation/wsl.mdx",sourceDirName:"quick-start/installation",slug:"/quick-start/installation/wsl",permalink:"/docs/quick-start/installation/wsl",draft:!1,unlisted:!1,editUrl:"https://github.com/TabbyML/tabby/edit/main/website/docs/quick-start/installation/wsl.mdx",tags:[],version:"current",sidebarPosition:4,frontMatter:{sidebar_position:4},sidebar:"tutorialSidebar",previous:{title:"Windows",permalink:"/docs/quick-start/installation/windows/"},next:{title:"Step 2 - Register Account",permalink:"/docs/quick-start/register-account/"}},a={},u=[{value:"1. Install WSL2 and Ubuntu",id:"1-install-wsl2-and-ubuntu",level:2},{value:"2. Follow the Linux installation guide",id:"2-follow-the-linux-installation-guide",level:2},{value:"3. Access Tabby from Windows",id:"3-access-tabby-from-windows",level:2}];function c(n){const t={a:"a",blockquote:"blockquote",code:"code",h1:"h1",h2:"h2",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,i.R)(),...n.components};return(0,e.jsxs)(e.Fragment,{children:[(0,e.jsx)(t.h1,{id:"windows-subsystem-for-linux-wsl2",children:"Windows Subsystem for Linux (WSL2)"}),"\n",(0,e.jsxs)(t.p,{children:["Run Tabby on Windows using ",(0,e.jsx)(t.strong,{children:"Ubuntu via WSL2"})," for a native Linux experience with full GPU support and advanced developer control."]}),"\n",(0,e.jsx)(t.h2,{id:"1-install-wsl2-and-ubuntu",children:"1. Install WSL2 and Ubuntu"}),"\n",(0,e.jsxs)(t.p,{children:["You can install either ",(0,e.jsx)(t.strong,{children:"Ubuntu 22.04"})," or ",(0,e.jsx)(t.strong,{children:"Ubuntu 24.04"})," \u2014 both work with Tabby."]}),"\n",(0,e.jsxs)(t.blockquote,{children:["\n",(0,e.jsx)(t.p,{children:(0,e.jsx)(t.strong,{children:"Which version should I choose?"})}),"\n",(0,e.jsxs)(t.ul,{children:["\n",(0,e.jsxs)(t.li,{children:["Ubuntu ",(0,e.jsx)(t.strong,{children:"22.04"})," is the default and used in Tabby\u2019s Docker image"]}),"\n",(0,e.jsxs)(t.li,{children:["Ubuntu ",(0,e.jsx)(t.strong,{children:"24.04"})," is newer and confirmed to work well with this guide"]}),"\n"]}),"\n",(0,e.jsxs)(t.p,{children:["To install WSL2: ",(0,e.jsx)(t.a,{href:"https://learn.microsoft.com/en-us/windows/wsl/install",children:"https://learn.microsoft.com/en-us/windows/wsl/install"})]}),"\n"]}),"\n",(0,e.jsx)(t.p,{children:"Install your preferred Ubuntu version:"}),"\n",(0,e.jsx)(t.pre,{children:(0,e.jsx)(t.code,{className:"language-powershell",children:"wsl --install -d Ubuntu # for Ubuntu 22.04\nwsl --install -d Ubuntu-24.04 # for Ubuntu 24.04\n"})}),"\n",(0,e.jsx)(t.p,{children:"After installation, reboot if required, then launch Ubuntu and set up your UNIX user."}),"\n",(0,e.jsx)(t.h2,{id:"2-follow-the-linux-installation-guide",children:"2. Follow the Linux installation guide"}),"\n",(0,e.jsxs)(t.p,{children:["Once inside your Ubuntu WSL terminal, just follow the ",(0,e.jsx)(t.a,{href:"../linux/",children:"Linux instructions"}),". No extra steps\nneeded \u2014 Tabby will run locally and privately, with GPU passthrough handled by WSL2 and Windows."]}),"\n",(0,e.jsx)(t.h2,{id:"3-access-tabby-from-windows",children:"3. Access Tabby from Windows"}),"\n",(0,e.jsx)(t.p,{children:"Once Tabby is running in Ubuntu, it will usually be available at:"}),"\n",(0,e.jsxs)(t.p,{children:[(0,e.jsx)(t.code,{children:"http://localhost:8080"})," (or your chosen port)"]})]})}function d(n={}){const{wrapper:t}={...(0,i.R)(),...n.components};return t?(0,e.jsx)(t,{...n,children:(0,e.jsx)(c,{...n})}):c(n)}},28453:(n,t,s)=>{s.d(t,{R:()=>o,x:()=>r});var e=s(96540);const i={},l=e.createContext(i);function o(n){const t=e.useContext(l);return e.useMemo((function(){return"function"==typeof n?n(t):{...t,...n}}),[t,n])}function r(n){let t;return t=n.disableParentContext?"function"==typeof n.components?n.components(i):n.components||i:o(n.components),e.createElement(l.Provider,{value:t},n.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.