====== PWstudio CPU version - Windows 11 (WSL2) installation guide ======

Applies to: Windows 11\\

<wrap important>
Before you start, we strongly recommend reading [[en:pwstudio:readme|Read this before installing PWstudio]] first to get the big picture.
</wrap>

----

===== 1. Install WSL Ubuntu 24.04 LTS =====

**Method 1:**

Follow Microsoft's official guide: https://learn.microsoft.com/en-us/windows/wsl/install

**Method 2:** You can also install it graphically:

If you prefer a graphical interface, you can install it from the Microsoft Store:

a. Open the Microsoft Store;

b. Search for "Ubuntu 24.04 LTS";

c. Click "Get" or "Install".

Pick either of the two methods above — you don't need to do both. Once installed, the first time you open the Ubuntu app it will ask you to set up a Linux username and password. Set these up normally, and remember to note them down — you may need them later.

===== 2. Install Docker =====

The Docker installation steps for the CPU version are the same as for the GPU version — just jump straight over there.

Click the link to jump to the <wrap em>Install Docker</wrap> section: [[en:pwstudio:ubuntu_gpu#Install Docker|Go to "Install Docker"]], follow the guide up through that section, then come back to this page.

===== 3. Install the PWstudio CPU version =====

Click the link to jump to the <wrap em>Import the image</wrap> section: [[en:pwstudio:quickstart_cpu#Import the image|Go to "Import the image"]] and follow the guide through to the end.

----

<wrap em>Starting the PWstudio CPU container with wslc</wrap>

<wrap tip>
The section below is an alternative way to start the PWstudio CPU container using wslc (the container tool built into WSL) — it's a different path from steps 2 and 3 above. Pick one path and follow it through — **don't do both**. If you've already completed the install by following steps 2 and 3 above, you can skip the rest of this page.
</wrap>

===== 1. Install/update WSL =====

All the commands below are run in **PowerShell**:

  - Open PowerShell as administrator: search for ''PowerShell'' in the Start menu, right-click it, and choose "Run as administrator"

  - Update to the WSL pre-release build: run the following command

<code powershell>
wsl --update --pre-release
</code>

  - Restart the WSL service: after the update finishes, run this command to apply the change

<code powershell>
wsl --shutdown
</code>

  - Verify that wslc is available: close and reopen your terminal (PowerShell or Windows Terminal)

<code powershell>
wslc --version
</code>

If you see output with a version number (e.g. 2.9.3.0), you're good to continue to the next step.

===== 2. Install the server.py service on the host machine =====

Installation instructions: click the link, [[en:pwstudio:serverwin|Installing the server.py service on Windows]], and follow the guide to set up the license service before moving to the next step.

===== 3. Import the image =====

<code powershell>
wslc pull ccr.ccs.tencentyun.com/lxkt/qflowcpu:latest
</code>

This step downloads the PWstudio CPU image, which is fairly large — depending on your network speed it may take anywhere from a few minutes to over ten minutes, so please be patient.

===== 4. Start the container =====

In PowerShell:

<code powershell>
wslc run -d --name qflowcpu `
  -v $env:TEMP\pwmat:/var/tmp/pwmat_host_secret:ro `
  --ulimit memlock=-1:-1 --ulimit stack=-1:-1 --shm-size=128G `
  -e SELINUX=disabled -p 80:80 -p 81:81 -p 2297:2297 -p 5010:5010 `
  --hostname=mstation ccr.ccs.tencentyun.com/lxkt/qflowcpu:latest
</code>

In cmd:

<code powershell>
wslc run -d --name qflowcpu ^
  -v %TEMP%\pwmat:/var/tmp/pwmat_host_secret:ro ^
  --ulimit memlock=-1:-1 --ulimit stack=-1:-1 --shm-size=128G ^
  -e SELINUX=disabled -p 80:80 -p 81:81 -p 2297:2297 -p 5010:5010 ^
  --hostname=mstation ccr.ccs.tencentyun.com/lxkt/qflowcpu:latest
</code>

Pick one of the two blocks above depending on which terminal you're using — don't run both. If there's no error, it will usually print a long string of characters (the container ID), meaning the container has started.
===== Logging in and using PWstudio =====

Jump to: [[en:pwstudio:quickstart_cpu|5. Logging into the container, uploading/downloading files]] and follow the guide to the end. If you don't yet know how to log in with an SSH tool, read [[en:pwstudio:mobaxterm|the MobaXterm beginner tutorial]] first.

~~DISCUSSION:off~~