Skip to content

A full-featured utility for managing Windows Subsystem for Linux (WSL)

License

Notifications You must be signed in to change notification settings

849029780/LxRunOffline

 
 

Repository files navigation

LxRunOffline

Build status Chocolatey

A full-featured utility for managing Windows Subsystem for Linux (WSL).

Donation

It would be greatly appreciated if you could make a donation to support development of this project.

Note: It's extremely difficult to withdraw from PayPal balance for a Chinese citizen like me, so if you want to donate 100$ or more, please either use Alipay or contact me via email for other donation options.

PayPal

Alipay

Alipay

Features

  • Install any Linux distro to any directory on your computer.
  • Move an existing installation to another directory.
  • Duplicate(copy) an existing installation.
  • Register an existing installation directory. This enables you to install to a USB stick and use it on different computers.
  • Run arbitrary Linux commands in a specified installation.
  • Configure default user, environment variables and various flags.
  • Export configuration to an XML file and import from the file.
  • Export an installation to a tar file.

Install

You can install via Chocolatey choco install lxrunoffline, Scoop scoop bucket add extras, scoop install lxrunoffline, or download the binaries directly:

Usage

See the Wiki to download tar files for different distros, which are used by the LxRunOffline install command.

Run LxRunOffline for available actions and run LxRunOffline <action-name> for available arguments/flags.

Build

Visual Studio

Visual Studio 2017 and Windows SDK 10.0.17134 are required.

Install vcpkg and its VS integration (if you haven't) and install dependencies.

vcpkg install --triplet x64-windows libarchive boost-program-options boost-format tinyxml2

Then build with Visual Studio or MSBuild.

MSYS2

Open the "MSYS2 MinGW 64-bit" shell, and install necessary packages.

pacman -Sy --needed --noconfirm base-devel mingw-w64-x86_64-toolchain mingw-w64-x86_64-libarchive mingw-w64-x86_64-boost mingw-w64-x86_64-tinyxml2

Then run make.

Compatibility

  • v1.x: Only Windows 10 Fall Creators Update (v1709) or earlier.
  • v2.x: Only Windows 10 Fall Creators Update (v1709) or later.
  • v3.x: Only Windows 10 April 2018 Update (v1803) or later.

It is strongly recommended to install the April 2018 Update and use v3.x releases.

About

A full-featured utility for managing Windows Subsystem for Linux (WSL)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 95.8%
  • C 2.1%
  • PowerShell 1.2%
  • Makefile 0.9%