Ubuntu WSL Development Environment via wsmaker

This repository provides an Ubuntu 24.04-based WSL environment pre-configured for development. Instead of building the Docker image manually, you can easily install and mount this image using wsmaker, a tool that simplifies the installation process for WSL images.

Overview

This image is designed for developers who need a robust WSL environment featuring:

• WSL-Ready Configuration: Systemd enabled with customized networking.
• Essential Utilities: Tools like sudo, nano, nmap, net-tools, snap, git, curl, wget, and more.
• Google Chrome: Installed for web browsing.
• Multi-Language Support: Programming languages (Python, Node.js, Go, Rust, Zig, and ZLS) are installed and activated globally via the Mise tool.

Features

• Base Image: Ubuntu 24.04.
• Pre-installed Utilities: Including but not limited to:
  • sudo, nano, nmap, net-tools
  • snap & snapd, git, curl, wget
  • gcc, build-essential
  • alsa-base, alsa-utils, pulseaudio, pulseaudio-utils
  • apt-transport-https, lsb-release, ca-certificates, gnupg
  • podman
• WSL Configuration:
  • Enables systemd support.
  • Sets a custom default user and hostname via build arguments.
  • Uses a mirrored networking mode for WSL2.
• Google Chrome: Installed from the official .deb package.
• Development Environments: Uses the Mise tool to install and globally configure:
  • Python, Node.js, Go, Rust, Zig, and ZLS

Getting Started with wsmaker

Prerequisites

• wsmaker: Download and install wsmaker (visit the official documentation or website for instructions).
• WSL: Ensure WSL is installed and configured on your system.
• Docker: wsmaker may require Docker to manage images. Check the Docker documentation for installation details.

Installing and Mounting the Image

Use the following command to install and mount the image with wsmaker:

.\wslmaker.exe install --name=<name> --distro=zpaceway/ubuntux:latest --build-arg-WSL_USERNAME=<username> --build-arg-WSL_HOSTNAME=<hostname>

Replace <username> and <hostname> with your desired WSL username and hostname. This command does the following:

• Image Installation: Downloads and installs the pre-configured Ubuntu 24.04 image from the zpaceway/ubuntux:latest repository.
• Customization: Applies the provided build arguments to set up the default user and hostname.
• Mounting: Integrates the image into your WSL environment, providing an interactive shell.

Post-Installation Configuration

After the installation is complete, launch your new WSL environment using the appropriate wsmaker or WSL commands. You will have an interactive bash shell with:

• All essential development tools installed.
• Google Chrome pre-installed.
• Programming environments set up via Mise.

Detailed Configuration

WSL Settings

The image configures /etc/wsl.conf with the following settings to ensure a smooth WSL experience:

[boot]
systemd=true

[user]
default=${WSL_USERNAME}

[wsl2]
networkingMode=mirrored

[network]
hostname=${WSL_HOSTNAME}
generateHosts=false

These settings ensure:

• Systemd Support: Allows for proper service management.
• Custom User and Hostname: Based on the provided WSL_USERNAME and WSL_HOSTNAME build arguments.
• Mirrored Networking: Optimized networking for WSL2 environments.

Mise Tool Integration

Once the specified user is activated, the image installs the Mise tool, which then installs and globally configures the following programming languages:

• Python
• Node.js
• Go
• Rust
• Zig
• ZLS (Zig Language Server)

The Mise tool automates the installation and configuration of these environments, appending necessary activation commands to the user's .bashrc.

License

This project is licensed under the MIT License.

Acknowledgements

• Ubuntu
• wsmaker (insert actual link if available)
• Docker
• Mise

Feel free to modify this README.md to suit your specific requirements or to add any additional details you might have.