Skip to content
Newquantumcoderxyz v2 is now available

Windows (WSL)

Run quantumcoderxyz on Windows using WSL for the best experience.

While quantumcoderxyz can run directly on Windows, we recommend using Windows Subsystem for Linux (WSL) for the best experience. WSL provides a Linux environment that works seamlessly with quantumcoderxyz’s features.


Setup

  1. Install WSL

    If you haven’t already, install WSL using the official Microsoft guide.

  2. Install quantumcoderxyz in WSL

    Once WSL is set up, open your WSL terminal and install quantumcoderxyz using one of the installation methods.

    Terminal window
    curl -fsSL https://api.quantumcoder.xyz/install | bash
  3. Use quantumcoderxyz from WSL

    Navigate to your project directory (access Windows files via /mnt/c/, /mnt/d/, etc.) and run quantumcoderxyz.

    Terminal window
    cd /mnt/c/Users/YourName/project
    quantumcoderxyz

Desktop App + WSL Server

If you prefer using the quantumcoderxyz Desktop app but want to run the server in WSL:

  1. Start the server in WSL with --hostname 0.0.0.0 to allow external connections:

    Terminal window
    quantumcoderxyz serve --hostname 0.0.0.0 --port 4096
  2. Connect the Desktop app to http://localhost:4096

Terminal window
quantumcoderxyz_SERVER_PASSWORD=your-password quantumcoderxyz serve --hostname 0.0.0.0

Web Client + WSL

For the best web experience on Windows:

  1. Run quantumcoderxyz web in the WSL terminal rather than PowerShell:

    Terminal window
    quantumcoderxyz web --hostname 0.0.0.0
  2. Access from your Windows browser at http://localhost:<port> (quantumcoderxyz prints the URL)

Running quantumcoderxyz web from WSL ensures proper file system access and terminal integration while still being accessible from your Windows browser.


Accessing Windows Files

WSL can access all your Windows files through the /mnt/ directory:

  • C: drive → /mnt/c/
  • D: drive → /mnt/d/
  • And so on…

Example:

Terminal window
cd /mnt/c/Users/YourName/Documents/project
quantumcoderxyz

Tips

  • Keep quantumcoderxyz running in WSL for projects stored on Windows drives - file access is seamless
  • Use VS Code’s WSL extension alongside quantumcoderxyz for an integrated development workflow
  • Your quantumcoderxyz config and sessions are stored within the WSL environment at ~/.local/share/quantumcoderxyz/