Support Warp for Linux on WSL (Windows Subsystem for Linux)

[dannyneira]

The issue for users to track and show support for running Warp for Linux on WSL.

To be clear, we are still working on making a native Warp for Windows (exe), which we will post about on #204 later this year so stay tuned!

We have a list of workarounds to issues running Linux here. If none of the workarounds help, please open a new GitHub issue and include logs along with your Linux distro, installation (WSL, Baremetal or VM, x86 or ARM), and the issue you had.

How important is this feature to you?

Please add a 👍 to the original post at the top to signal that you want this feature, and subscribe if you'd like to be notified. We'll be posting updates on this thread (if/when this is being worked on).

Please avoid comments with spam-like "+1" or 👍 .

Feb 2025 update:
Hey everyone, we're excited to announce that Warp on Windows is now generally available, which includes support for running your WSL distributions and switching between them!
Download today at https://www.warp.dev/windows-terminal 🥳 🚀

Please note we're tracking support for cmd.exe shell and fish shell seperately.

[cj81499]

@dannyneira I think you meant to link to this issue from your comment on #204, but made a typo (and accidentally linked to #424).

[dannyneira]

@dannyneira I think you meant to link to this issue from your comment on #204, but made a typo (and accidentally linked to #424).

@cj81499 thanks for catching that, fixed!

[JonParton]

Just to share, I've actually had success this morning just installing the linux .deb in an ubuntu WSL2 on windows 11 that allows GUI apps. Install the .deb and then just launch warp from the windows start menu!

Pretty much everything seems to be working really well, you just need to make sure you have Firefox installed to allow you to log in etc and I had to use the copy auth code method rather then being automatically logged in as the referral back to warp didn't function with wsl2 in the way.

It's not a perfect experience as things like maximising the window don't really work and the start menu icon is just linux instead of indicating it is warp, but its already soooo much better then any other terminal experience so far 🙌 Kudos 🤜

p.s. I had happened to be trying Git Butler too and hence knowing to install Firefox etc. Some useful git-butler install instructions that ended up being helpful for warp!

[WilsonCazarre]

Hi @JonParton. I tried earlier to run on wsl2, but I keep running into this error when trying to launch Warp. Any insight on how to work around it?

[Anidion]

Same issue as @WilsonCazarre, this time on an NVIDIA GPU. Firefox works fine in GUI.

Update: running it with the environment variable WARP_ENABLE_WAYLAND=1 opened the GUI, but now I'm having issues pasting the auth code in to activate, but that's a separate issue.

[WilsonCazarre]

@Anidion I forgot to mention that I'm also using an NVIDIA GPU (GTX 1050) but I think WSL is not detecting that, I'm not sure why.

[iambj]

I ended up with this command:
WARP_ENABLE_WAYLAND=1 MESA_D3D12_DEFAULT_ADAPTER_NAME=NVIDIA warp-terminal, and I get to the login screen but can't paste my token. However, it now detects my RTX 2070 Super. (source for the MESA variable: https://github.com/microsoft/wslg/wiki/GPU-selection-in-WSLg)

On a side note, I know this isn't the same issue, but I've been trying all day to get it to launch in my Ubuntu 20.04 VM (VMWare Player), and it launched with that command. I had tried with X11 and Wayland, and after both didn't work, I switched back to Wayland. On a whim, I tried the environment variable, and Warp launched.

[bedesv]

I've also got it running using WARP_ENABLE_WAYLAND=1 warp-terminal and am having trouble pasting my auth token. The Warp client says "An invalid auth token was entered into the modal. Not the first time? See our troubleshooting docs." I can paste the auth token into other WSL gui apps such as Firefox.

In the WSL terminal I can see that these events occur when I attempt to paste my auth token.

17:09:32 [INFO] dispatching typed action: PasteAuthUrl
17:09:32 [ERROR] Failed to parse AuthRedirectPayload from redirect URL: relative URL without a base

Any ideas on how to successfully login?

[joanalexisc]

I ended up with this command: WARP_ENABLE_WAYLAND=1 MESA_D3D12_DEFAULT_ADAPTER_NAME=NVIDIA warp-terminal, and I get to the login screen but can't paste my token. However, it now detects my RTX 2070 Super. (source for the MESA variable: https://github.com/microsoft/wslg/wiki/GPU-selection-in-WSLg)

On a side note, I know this isn't the same issue, but I've been trying all day to get it to launch in my Ubuntu 20.04 VM (VMWare Player), and it launched with that command. I had tried with X11 and Wayland, and after both didn't work, I switched back to Wayland. On a whim, I tried the environment variable, and Warp launched.

same for me... in the console is throwing this message: Failed to parse AuthRedirectPayload from redirect URL: relative URL without a base

[TechNerd8]

I've also got it running using WARP_ENABLE_WAYLAND=1 warp-terminal and am having trouble pasting my auth token. The Warp client says "An invalid auth token was entered into the modal. Not the first time? See our troubleshooting docs." I can paste the auth token into other WSL gui apps such as Firefox.

In the WSL terminal I can see that these events occur when I attempt to paste my auth token.

17:09:32 [INFO] dispatching typed action: PasteAuthUrl
17:09:32 [ERROR] Failed to parse AuthRedirectPayload from redirect URL: relative URL without a base

Any ideas on how to successfully login?

Looks like there are a few of us with this issue now. I'm in the same boat. I tried copying and pasting only specific sections of the full token length, but nothing has worked so far. Seems the parsing instructions aren't aligning with what the auth link actually spits out. I'll see if I can find where the faulty instructions are, unless one of the devs beats me to it (or identifies another issue I'm not considering).

[bedesv]

I’m away from my computer atm but I saw a few threads in the Warp Discord channel about both people successfully running Warp in WSL and other ways to pass the auth token into Warp. Haven’t got anything working yet

[eglove]

It's been awhile since I used warp because I don't use Linux. It is my favorite terminal though.

WSL support isn't terribly important. WSL virtual memory is too slow for things like simple web servers. So there's not much I'd ever use it for.

Definitely looking forward to the native windows support though. I'd love to get back to warp.