Skip to content
This repository was archived by the owner on Apr 7, 2026. It is now read-only.

windows.md

Latest commit

 

History

History
65 lines (46 loc) · 2.92 KB

windows.md

File metadata and controls

65 lines (46 loc) · 2.92 KB

Ubuntu packages on WSL

Octez binaries do not support Windows systems natively, however it's possible to use Linux binaries with the Windows Subsystem for Linux.

The simplest option with tezos-packaging is to use Ubuntu on WSL by following these step-by-step instructions.

Once this setup is complete, you can add the launchpad PPA and install packages in the same way as described in our documentation for Ubuntu.

Please note: this setup at this point has some limitation, keep reading below for more info on how to take better advantage of the Ubuntu packages on Windows.

Ledger devices with WSL

In order to use a ledger device on WSL some additional preparation steps are needed.

We recommed to use the usbipd-win tool and follow this guide about connecting usb devices to WSL.

Systemd units on WSL

Ubuntu packages include services to manage tezos software more effectively, which are necessary for the baking and voting wizards. These services are using systemd and you can read more in the dedicated doc.

systemd is supported on WSL starting from version 0.67.6 and higher. You can check your version by running the wsl --version command.

If that command fails then you need to upgrade your WSL to the Store version. You can read how to do it there. Note that you need to have Windows 11 to install the required version.

After you have installed the required version of WSL along with the distribution (we recommend using Ubuntu), you need to launch it and configure systemd. The configuration steps are described below.

To enable systemd startup on boot you need to follow these steps:

  1. Run sudo nano /etc/wsl.conf
  2. In the nano editor add the following lines to the wsl.conf file:
[boot]
systemd=true
  1. Close the editor and save your changes using the ctrl + x keyboard shortcut.
  2. Restart your machine to apply the WSL configuration changes.

To make sure systemd is running on your machine use the systemctl list-unit-files --type=service command which should show your services' status.

You can read more about installing and using systemd on WSL in this article.

After you have configured WSL with systemd, the the relative documentation should apply to your system as well.