Skip to content

Commit 9a45326

Browse files
authored
Add versioned WSL for RL 9 (#2858)
* Add admonition at the top for those searching for other versions * Remove version 10 and 8 specific instructions and images * replace passive voice with active * fix admonition space issue
1 parent fb474e6 commit 9a45326

File tree

1 file changed

+11
-12
lines changed

1 file changed

+11
-12
lines changed

docs/guides/interoperability/import_rocky_to_wsl.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,13 @@ tags:
99
- interoperability
1010
---
1111

12-
# Import Rocky Linux to WSL
12+
!!! note "Images for other versions"
13+
14+
If you are looking for WSL instructions for another version of Rocky Linux, select the version you want from the top menu and then refer to the WSL instructions under "Interoperability."
1315

1416
## Prerequisites
1517

16-
The Windows-Subsystem for Linux feature has to be enabled. This is possible with one of these options:
18+
You must enable the Windows-Subsystem for Linux feature. Do this with one of these options:
1719

1820
- [A newer WSL version with extra features is available in the Microsoft Store](https://apps.microsoft.com/store/detail/windows-subsystem-for-linux/9P9TQF7MRM4R). Use this newer version whenever possible.
1921
- Open an administrative Terminal (either PowerShell or Command-Prompt) and
@@ -24,7 +26,7 @@ This feature should be available on every supported version of Windows 10 and 11
2426

2527
!!! tip "WSL version"
2628

27-
Ensure that your WSL version is up to date, as some features were only introduced in later versions. If you are unsure, run `wsl --update`.
29+
Ensure that your WSL version is up to date, as some features were only introduced in later versions. If you are unsure, run `wsl --update`.
2830

2931
## Steps
3032

@@ -33,45 +35,42 @@ This feature should be available on every supported version of Windows 10 and 11
3335
1. Download the WSL image from the CDN or another mirror closer to you:
3436

3537
- 9: [x86_64](https://dl.rockylinux.org/pub/rocky/9/images/x86_64/Rocky-9-WSL-Base.latest.x86_64.wsl) or [aarch64](https://dl.rockylinux.org/pub/rocky/9/images/aarch64/Rocky-9-WSL-Base.latest.aarch64.wsl)
36-
- 10: [x86_64](https://dl.rockylinux.org/pub/rocky/10/images/x86_64/Rocky-10-WSL-Base.latest.x86_64.wsl) or [aarch64](https://dl.rockylinux.org/pub/rocky/10/images/aarch64/Rocky-10-WSL-Base.latest.aarch64.wsl)
3738

3839
2. There are multiple options for installing a `.wsl` image:
3940

40-
- Double-click the image and it will be installed with the images default name
41+
- Double-click the image to install it with the images default name
4142
- Install the image via command line:
4243

4344
```sh
44-
wsl --install --from-file <path-to/Rocky-10-WSL-Base.latest.x86_64.wsl> <machine-name>
45+
wsl --install --from-file <path-to/Rocky-9-WSL-Base.latest.x86_64.wsl> --name <machine-name>
4546
```
4647

47-
### Conventional Container images
48+
### Conventional container images
4849

4950
1. Get the container rootfs. This is possible in multiple ways:
5051

5152
- Download the image from the CDN:
52-
- 8: [Base x86_64](https://dl.rockylinux.org/pub/rocky/8/images/x86_64/Rocky-8-Container-Base.latest.x86_64.tar.xz), [Minimal x86_64](https://dl.rockylinux.org/pub/rocky/8/images/x86_64/Rocky-8-Container-Minimal.latest.x86_64.tar.xz), [UBI x86_64](https://dl.rockylinux.org/pub/rocky/8/images/x86_64/Rocky-8-Container-UBI.latest.x86_64.tar.xz), [Base aarch64](https://dl.rockylinux.org/pub/rocky/8/images/aarch64/Rocky-8-Container-Base.latest.aarch64.tar.xz), [Minimal aarch64](https://dl.rockylinux.org/pub/rocky/8/images/aarch64/Rocky-8-Container-Minimal.latest.aarch64.tar.xz), [UBI aarch64](https://dl.rockylinux.org/pub/rocky/8/images/aarch64/Rocky-8-Container-UBI.latest.aarch64.tar.xz)
5353
- 9: [Base x86_64](https://dl.rockylinux.org/pub/rocky/9/images/x86_64/Rocky-9-Container-Base.latest.x86_64.tar.xz), [Minimal x86_64](https://dl.rockylinux.org/pub/rocky/9/images/x86_64/Rocky-9-Container-Minimal.latest.x86_64.tar.xz), [UBI x86_64](https://dl.rockylinux.org/pub/rocky/9/images/x86_64/Rocky-9-Container-UBI.latest.x86_64.tar.xz), [Base aarch64](https://dl.rockylinux.org/pub/rocky/9/images/aarch64/Rocky-9-Container-Base.latest.aarch64.tar.xz), [Minimal aarch64](https://dl.rockylinux.org/pub/rocky/9/images/aarch64/Rocky-9-Container-Minimal.latest.aarch64.tar.xz), [UBI aarch64](https://dl.rockylinux.org/pub/rocky/9/images/aarch64/Rocky-9-Container-UBI.latest.aarch64.tar.xz)
54-
- 10: [Base x86_64](https://dl.rockylinux.org/pub/rocky/10/images/x86_64/Rocky-10-Container-Base.latest.x86_64.tar.xz), [Minimal x86_64](https://dl.rockylinux.org/pub/rocky/10/images/x86_64/Rocky-10-Container-Minimal.latest.x86_64.tar.xz), [UBI x86_64](https://dl.rockylinux.org/pub/rocky/10/images/x86_64/Rocky-10-Container-UBI.latest.x86_64.tar.xz), [Base aarch64](https://dl.rockylinux.org/pub/rocky/10/images/aarch64/Rocky-10-Container-Base.latest.aarch64.tar.xz), [Minimal aarch64](https://dl.rockylinux.org/pub/rocky/10/images/aarch64/Rocky-10-Container-Minimal.latest.aarch64.tar.xz), [UBI aarch64](https://dl.rockylinux.org/pub/rocky/10/images/aarch64/Rocky-10-Container-UBI.latest.aarch64.tar.xz)
5554
- Extract the image from either Docker Hub or Quay.io ([ref.](https://docs.microsoft.com/en-us/windows/wsl/use-custom-distro#export-the-tar-from-a-container))
5655

5756
```sh
5857
<podman/docker> export rockylinux:10 > rocky-10-image.tar
5958
```
6059

61-
2. (optional) You will have to extract the .tar file from the .tar.xz file if you are using one of the latest WSL versions
60+
2. (optional) You will have to extract the .tar file from the `.tar.xz` file if you are using one of the latest WSL versions
6261
3. Create the directory where the WSL will store its files (mostly somewhere in the user profile)
6362
4. Finally, import the image into WSL ([ref.](https://docs.microsoft.com/en-us/windows/wsl/use-custom-distro#import-the-tar-file-into-wsl)):
6463

6564
- WSL:
6665

6766
```sh
68-
wsl --import <machine-name> <path-to-vm-dir> <path-to/rocky-10-image.tar.xz> --version 1
67+
wsl --import <machine-name> <path-to-vm-dir> <path-to/rocky-9-image.tar.xz> --version 1
6968
```
7069

7170
- WSL 2:
7271

7372
```sh
74-
wsl --import <machine-name> <path-to-vm-dir> <path-to/rocky-10-image.tar.xz> --version 2
73+
wsl --import <machine-name> <path-to-vm-dir> <path-to/rocky-9-image.tar.xz> --version 2
7574
```
7675

7776
!!! tip "WSL vs. WSL 2"

0 commit comments

Comments
 (0)