{"id":15059233,"url":"https://github.com/sileshn/fedorawsl2","last_synced_at":"2025-10-04T18:31:39.734Z","repository":{"id":201117225,"uuid":"626213747","full_name":"sileshn/FedoraWSL2","owner":"sileshn","description":"Fedora rawhide wsl2 using wsldl","archived":true,"fork":false,"pushed_at":"2024-07-31T22:57:02.000Z","size":1450,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-19T00:38:18.033Z","etag":null,"topics":["bash-on-windows","fedora","fedora-linux","fedora-project","windows-subsystem-for-linux","wsl2","wsldl"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sileshn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-11T02:52:22.000Z","updated_at":"2024-09-10T14:36:18.000Z","dependencies_parsed_at":"2024-01-01T23:58:32.654Z","dependency_job_id":"d1aaa4c2-4e0b-4640-ae3d-ac3525599da8","html_url":"https://github.com/sileshn/FedoraWSL2","commit_stats":null,"previous_names":["sileshn/fedorawsl2"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sileshn%2FFedoraWSL2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sileshn%2FFedoraWSL2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sileshn%2FFedoraWSL2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sileshn%2FFedoraWSL2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sileshn","download_url":"https://codeload.github.com/sileshn/FedoraWSL2/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235289301,"owners_count":18965918,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash-on-windows","fedora","fedora-linux","fedora-project","windows-subsystem-for-linux","wsl2","wsldl"],"created_at":"2024-09-24T22:39:42.271Z","updated_at":"2025-10-04T18:31:34.424Z","avatar_url":"https://github.com/sileshn.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Disclaimer\n\nThis project is in no way related to or created by the official Fedora team or its members. It is solely a project of mine.\n\n# FedoraWSL2\nFedora rawhide on WSL2 (Windows 10 FCU or later) based on [wsldl](https://github.com/yuk7/wsldl).\n\n[![Screenshot-2023-04-11-114235.png](https://i.postimg.cc/YCs4DwY4/Screenshot-2023-04-11-114235.png)](https://postimg.cc/5X8NjTP1)\n[![Github All Releases](https://img.shields.io/github/downloads/sileshn/FedoraWSL2/total.svg?style=flat-square)](https://github.com/sileshn/FedoraWSL2/releases)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n[![License](https://img.shields.io/github/license/sileshn/FedoraWSL2.svg?style=flat-square)](https://raw.githubusercontent.com/sileshn/FedoraWSL2/master/LICENSE?token=GHSAT0AAAAAACA2QMWW7BDABA5NM5RE3ADYZBXNQ5A)\n\n## Features and important information\nFedoraWSL2 has the following features during the installation stage.\n* Increase virtual disk size from the default 256GB\n* Create a new user and set the user as default\n* FedoraWSL2 Supports systemd natively if you are running wsl v0.67.6 (more details [here](https://devblogs.microsoft.com/commandline/systemd-support-is-now-available-in-wsl/)) and above. For earlier versions of wsl, systemd is supported using diddledani's [one-script-wsl2-systemd](https://github.com/diddledani/one-script-wsl2-systemd). This is done automatically during initial setup.\n* FedoraWSL2 includes a wsl.conf file which only has section headers. Users can use this to configure the distro to their liking. You can read more about wsl.conf and its configuration settings [here](https://docs.microsoft.com/en-us/windows/wsl/wsl-config).\n\n## Requirements\n* For x64 systems: Version 1903 or higher, with Build 18362 or higher.\n* For ARM64 systems: Version 2004 or higher, with Build 19041 or higher.\n* Builds lower than 18362 do not support WSL 2.\n* If you are running Windows 10 version 2004 or higher, you can install all components required to run wsl2 with a single command. This will install ubuntu by default. More details are available [here](https://devblogs.microsoft.com/commandline/install-wsl-with-a-single-command-now-available-in-windows-10-version-2004-and-higher/).\n\t```cmd\n\twsl.exe --install\n\t```\n* If you are running Windows 10 lower then version 2004, follow the steps below to install requirements manually. For more details, check [this](https://docs.microsoft.com/en-us/windows/wsl/install-manual) microsoft document.\n\t* Enable Windows Subsystem for Linux feature.\n\t```cmd\n\tdism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart\n\t```\n\t* Enable Virtual Machine feature\n\t```cmd\n\tdism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart\n\t```\n\t* Download and install the latest Linux kernel update package from [here](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi).\n\n## Install\n* Make sure all the steps mentioned under \"Requirements\" are completed.\n* [Download](https://github.com/sileshn/FedoraWSL2/releases/latest) installer zip\n* Extract all files in zip file to same directory\n* Set version 2 as default. Note that this step is required only for manual installation.\n  ```dos\n  wsl --set-default-version 2\n  ```\n* Run Fedora.exe to extract rootfs and register to WSL\n\n**Note:**\nExe filename is using the instance name to register. If you rename it you can register with a diffrent name and have multiple installs.\n\n## How-to-Use(for Installed Instance)\n#### exe Usage\n```\nUsage :\n    \u003cno args\u003e\n      - Open a new shell with your default settings.\n\n    run \u003ccommand line\u003e\n      - Run the given command line in that instance. Inherit current directory.\n\n    runp \u003ccommand line (includes windows path)\u003e\n      - Run the given command line in that instance after converting its path.\n\n    config [setting [value]]\n      - `--default-user \u003cuser\u003e`: Set the default user of this instance to \u003cuser\u003e.\n      - `--default-uid \u003cuid\u003e`: Set the default user uid of this instance to \u003cuid\u003e.\n      - `--append-path \u003ctrue|false\u003e`: Switch of Append Windows PATH to $PATH\n      - `--mount-drive \u003ctrue|false\u003e`: Switch of Mount drives\n      - `--default-term \u003cdefault|wt|flute\u003e`: Set default type of terminal window.\n\n    get [setting]\n      - `--default-uid`: Get the default user uid in this instance.\n      - `--append-path`: Get true/false status of Append Windows PATH to $PATH.\n      - `--mount-drive`: Get true/false status of Mount drives.\n      - `--wsl-version`: Get the version os the WSL (1/2) of this instance.\n      - `--default-term`: Get Default Terminal type of this instance launcher.\n      - `--lxguid`: Get WSL GUID key for this instance.\n\n    backup [contents]\n      - `--tar`: Output backup.tar to the current directory.\n      - `--reg`: Output settings registry file to the current directory.\n\t  - `--tgz`: Output backup.tar.gz to the current directory.\n      - `--vhdx`: Output backup.ext4.vhdx to the current directory.\n      - `--vhdxgz`: Output backup.ext4.vhdx.gz to the current directory.\n\n    clean\n      - Uninstall that instance.\n\n    help\n      - Print this usage message.\n```\n\n#### Just Run exe\n```cmd\n\u003e{InstanceName}.exe\n[root@PC-NAME user]#\n```\n\n#### Run with command line\n```cmd\n\u003e{InstanceName}.exe run uname -r\n4.4.0-43-Microsoft\n```\n\n#### Run with command line with path translation\n```cmd\n\u003e{InstanceName}.exe runp echo C:\\Windows\\System32\\cmd.exe\n/mnt/c/Windows/System32/cmd.exe\n```\n\n#### Change Default User(id command required)\n```cmd\n\u003e{InstanceName}.exe config --default-user user\n\n\u003e{InstanceName}.exe\n[user@PC-NAME dir]$\n```\n\n#### Set \"Windows Terminal\" as default terminal\n```cmd\n\u003e{InstanceName}.exe config --default-term wt\n```\n\n## How to setup\n\nFedoraWSL2 will ask you to create a new user during its first run. If you chose to create a new user during initial setup, the steps below are not required unless you want to create additional users.\n```dos\npasswd\nuseradd -m -g users -G wheel -s /bin/bash \u003cusername\u003e\necho \"%sudo ALL=(ALL) ALL\" \u003e/etc/sudoers.d/wheel\npasswd \u003cusername\u003e\nexit\n```\n\nYou can set the user you created as default user using 2 methods.\n\nOpen Fedora.exe, run the following command (replace username with the actual username you created).\n```dos\nsed -i '/\\[user\\]/a default = username' /etc/wsl.conf\n```\n\nShutdown and restart the distro (this step is important).\n\n(or)\n\nExecute the command below in a windows cmd terminal from the directory where Fedora.exe is installed.\n```dos\n\u003eFedora.exe config --default-user \u003cusername\u003e\n```\n\n## How to uninstall instance\n```dos\n\u003eFedora.exe clean\n\n```\n\n## How to backup instance\nexport to backup.tar.gz\n```cmd\n\u003eFedora.exe backup --tgz\n```\nexport to backup.ext4.vhdx.gz\n```cmd\n\u003eFedora.exe backup --vhdxgz\n```\n\n## How to restore instance\n\nThere are 2 ways to do it. \n\nRename the backup to rootfs.tar.gz and run Fedora.exe\n\n(or)\n\n.tar(.gz)\n```cmd\n\u003eFedora.exe install backup.tar.gz\n```\n.ext4.vhdx(.gz)\n```cmd\n\u003eFedora.exe install backup.ext4.vhdx.gz\n```\n\nYou may need to run the command below in some circumstances.\n```cmd\n\u003eFedora.exe --default-uid 1000\n```\n\n## How to build\n\n#### Prerequisites\n\nDocker, tar, zip, unzip, bsdtar need to be installed.\n\n```dos\ngit clone git@gitlab.com:sileshn/FedoraWSL2.git\ncd FedoraWSL2\nmake\n\n```\nCopy the FedoraRawhide.zip file to a safe location and run the command below to clean.\n```dos\nmake clean\n\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsileshn%2Ffedorawsl2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsileshn%2Ffedorawsl2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsileshn%2Ffedorawsl2/lists"}