R3dFruitRollUp / LxRunOffline

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

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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 cover the cost of my dev machine hosted on Vultr.

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 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: All Windows 10 versions with the Linux subsystem support.
  • 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)

License:MIT License


Languages

Language:C++ 94.8%Language:C 2.7%Language:PowerShell 1.5%Language:Makefile 1.0%