website/docs/quick-start/installation/wsl.mdx
Run Tabby on Windows using Ubuntu via WSL2 for a native Linux experience with full GPU support and advanced developer control.
You can install either Ubuntu 22.04 or Ubuntu 24.04 — both work with Tabby.
Which version should I choose?
- Ubuntu 22.04 is the default and used in Tabby’s Docker image
- Ubuntu 24.04 is newer and confirmed to work well with this guide
To install WSL2: https://learn.microsoft.com/en-us/windows/wsl/install
Install your preferred Ubuntu version:
wsl --install -d Ubuntu # for Ubuntu 22.04
wsl --install -d Ubuntu-24.04 # for Ubuntu 24.04
After installation, reboot if required, then launch Ubuntu and set up your UNIX user.
Once inside your Ubuntu WSL terminal, just follow the Linux instructions. No extra steps needed — Tabby will run locally and privately, with GPU passthrough handled by WSL2 and Windows.
Once Tabby is running in Ubuntu, it will usually be available at:
http://localhost:8080 (or your chosen port)