A comprehensive automation suite for setting up Windows Subsystem for Linux (WSL2) with a complete development environment. This repository provides scripts to install WSL2 on Windows and configure a fully-featured Ubuntu development environment with modern CLI tools, Docker, AWS tools, and more.
- ✅ Enterprise-grade error handling with comprehensive logging
- ✅ Intelligent Winget installation with proper download mechanism
- ✅ WSL2 feature enablement with verification and restart detection
- ✅ Virtual Machine Platform configuration with status checking
- ✅ Progress tracking with 5-step installation process
- ✅ Detailed logging to timestamped log files
- ✅ Colorful console output with success/warning/error indicators
- ✅ Automatic verification of each installation step
- 🔧 System Packages: Essential development tools and utilities
- 🛠️ Modern CLI Tools: bat, exa/eza, fd-find, ripgrep, fzf, tree, htop, neofetch
- 🐍 Python Environment: pip, ansible, boto3, and development packages
- ☁️ Cloud Tools: AWS CLI, Session Manager plugin
- 🐳 Containerization: Docker CE with proper user configuration
- 🌍 Infrastructure: Terraform environment manager (tfenv)
- 📝 Version Control: Git with useful aliases and configurations
- 🔐 Security: SSH key management with keychain
- 🎨 Shell Enhancement: Custom prompt with git integration and modern aliases
SetupWSL2.ps1- Enhanced PowerShell script v2.0 for Windows WSL2 installation with enterprise-grade error handlingwsl2_basic_config/- Complete WSL environment configuration suiteconfig.sh- Main configuration script with robust error handling.bashrc_extra- Enhanced shell configuration with modern aliasesREADME.md- Detailed WSL configuration documentation
- Windows 10 version 2004+ or Windows 11
- PowerShell 5.1 or higher
- Administrative privileges
- Active internet connection
-
Clone the repository:
git clone https://github.com/solarekm/wsl2.git cd wsl2
-
Run PowerShell as Administrator and execute:
.\SetupWSL2.ps1
Enhanced PowerShell Features:
- 🔄 Progress tracking: Visual 5-step installation process
- 📝 Comprehensive logging: Timestamped logs saved to
%USERPROFILE%\WSL2_Setup_[timestamp].log - ✅ Smart verification: Checks if features are already enabled to avoid redundant operations
- 🛡️ Robust error handling: Continues installation even if some steps fail, with detailed error reporting
- 🎨 Professional UI: Color-coded console output with emoji indicators
-
Restart your computer when prompted.
-
Open WSL terminal (search "Ubuntu" in Start Menu)
-
Navigate to configuration directory:
cd /path/to/wsl2/wsl2_basic_config -
Run the configuration script:
chmod +x config.sh ./config.sh
-
Verify installation (optional):
# Check installation status without installing ./config.sh --check # Fix only missing components (quick repair) ./config.sh --fix # Fix optional warnings (SSH, tfenv, tool alternatives) ./config.sh --fix-warnings
-
Follow interactive prompts for Git configuration
-
Restart WSL to apply all changes:
# In PowerShell as Administrator wsl -t <your-distro-name> wsl
Note: Replace
<your-distro-name>with your actual WSL distribution name. The script will show the exact command at the end of installation.
- Package Managers: apt, pip, winget integration
- Network Tools: curl, wget, wslu (WSL utilities)
- Development: git, unzip, keychain
bat/batcat→ Enhancedcatwith syntax highlightingexa/eza→ Modernlswith git integrationfd-find→ Fast and user-friendlyfindreplacementripgrep→ Ultra-fast text search toolfzf→ Command-line fuzzy findertree→ Directory structure visualizationhtop→ Interactive process viewerneofetch→ System information displaygh→ GitHub CLI for repository management
- Docker: Container platform with user permissions
- AWS CLI: Command-line interface for Amazon Web Services
- Session Manager: Secure shell access to EC2 instances
- Terraform: Infrastructure as code via tfenv manager
- ansible → Infrastructure automation
- boto3 → AWS SDK for Python
- requests → HTTP library
- argcomplete → Command completion
- pywinrm → Windows Remote Management
- 🔄 Idempotent: Run multiple times safely
- 🛡️ Error Resilient: Robust error handling and recovery
- 📝 Comprehensive Logging: All operations logged to
~/wsl2_setup.log - 🔍 Package Fallbacks: Automatic alternatives for unavailable packages
- 🌐 Network Retry: Automatic retry for network operations
- ⚡ Smart Detection: Skips already installed components
- ✅ Installation Verification: Automatic post-install status checking with detailed reports
./config.sh # Full installation with verification
./config.sh --check # Only run verification checks
./config.sh --fix # Fix only missing components (quick repair)
./config.sh --fix-warnings # Fix optional warnings (SSH, tfenv, alternatives)
./config.sh --help # Show help and usage informationThe verification and repair system provides:
- ✅ Visual Status: Color-coded success/warning/error indicators
- 📊 Detailed Reports: Component-by-component installation status
- 🎯 Success Rate: Overall installation percentage
- 🔍 Failure Analysis: Specific failed components highlighted
- 🔧 Smart Repair: Install only missing components without full reinstall
For detailed configuration options and troubleshooting, see:
- WSL Configuration Guide
- Installation Log (created during setup)
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Microsoft WSL team for the amazing Windows Subsystem for Linux
- Ubuntu team for the excellent Ubuntu distribution
- All maintainers of the CLI tools and packages included in this setup
- Issues: GitHub Issues
- Project: GitHub Repository