Git Product home page Git Product logo

venomwsl's Introduction

VenomWSL

Venom Linux on WSL2 (Windows 10 FCU or later) based on wsldl.

PRs Welcome License

Disclaimer

THIS REPO IS NOT AFFILIATE TO THE OFFICIAL "VENOM LINUX" DISTRIBUTION IN ANY WAY!

Requirements

  • Windows 10 1803 April 2018 Update x64 or later.
  • Windows Subsystem for Linux feature is enabled.
  • Latest WSL recommended.

Install

  1. Download installer zip from release or action build (recommended)
  2. Extract all files in zip file to same directory (e.g. C:\WSL\Venom)
  3. Run Venom.exe to Extract rootfs and Register to WSL

Exe filename is using to the instance name to register. If you rename it, you can register with a different name and have multiple installs.

Init

# Update system to latest as it's rolling release
scratch sync
scratch outdate
scratch sysup -y
# Check integrity just in case
scratch integrity
# Check broken packages
revdep

Then follow Configuring system on Venom Linux wiki. Skip things like fstab, kernel and bootloader as WSL covers that already. You don't need to enter chroot environment as well since the installation (importing the tarball) is done during #Install.

You may also want to enable nonfree repo in /etc/scratch.repo and setup package aliases in /etc/scratchpkg.alias to avoid compiling certain packages from source.

For example, use rust binary as compiling is resource consuming.

echo 'rust rust-bin' | sudo tee -a /etc/scratchpkg.alias

How-to-Use (for Installed Instance)

Usage

Usage :
    <no args>
      - Open a new shell with your default settings.
    run <command line>
      - Run the given command line in that distro. Inherit current directory.
    config [setting [value]]
      - `--default-user <user>`: Set the default user for this distro to <user>
      - `--default-uid <uid>`: Set the default user uid for this distro to <uid>
      - `--append-path <on|off>`: Switch of Append Windows PATH to $PATH
      - `--mount-drive <on|off>`: Switch of Mount drives
    get [setting]
      - `--default-uid`: Get the default user uid in this distro
      - `--append-path`: Get on/off status of Append Windows PATH to $PATH
      - `--mount-drive`: Get on/off status of Mount drives
      - `--lxuid`: Get LxUID key for this distro
    backup
      - Output backup.tar.gz to the current directory using tar command.
      
    clean
      - Uninstall the distro.
    help
      - Print this usage message.

Uninstall

.\Venom.exe clean

How-to-Build

VenomWSL can be built on GNU/Linux or WSL.

curl, bsdtar, jq and unzip is required for build.

By default it builds s6 variant. Change $(BASE_URL_S6) to BASE_URL_SYSV in Makefile if you prefer SysV variant.

# Install build tools
sudo apt install -y curl libarchive-tools jq unzip
# Make release
# Use of `sudo` recommended to avoid weird file permission in rootfs
sudo make
# Clean-up using `sudo` as some files are owned by root
sudo make clean

MIT

venomwsl's People

Contributors

vinfall avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.