4.8 KiB
Windows installation
Download the Windows package
Open the muSRFlow Releases
page and download muSRFlow-<version>-x64.exe plus
its .sha256 file. Verify the checksum, then keep the
installer available while enabling WSL below. The installer contains the
ROOT and musrfit runtime; do not download a separate Linux runtime
package for Windows.
The Windows installer includes muSRFlow, ROOT, and musrfit. Install WSL2 first; muSRFlow prepares its own Linux runtime on first launch. You do not need Node.js, npm, Ubuntu, or a separate ROOT/musrfit installation.
Already installed muSRFlow? Read Existing installations as well: updating the application does not update an already imported WSL runtime.
Before you start
- Use a 64-bit Intel/AMD PC. The current package is x64.
- Windows 11 is recommended. Windows 10 requires build 19044 or newer for WSLg, which displays the musrview spectrum windows.
- Administrator access is needed to enable the Windows virtualization features.
See Microsoft's WSL GUI requirements for the Windows prerequisites.
Install step by step
Install WSL. Open PowerShell as Administrator and run:
wsl --install --no-distributionRestart Windows afterwards. Skip this step if WSL is already installed. muSRFlow supplies its own distribution, so Ubuntu is not required.
Update and check WSL. In administrator PowerShell, run:
wsl --update wsl --versionFollow any restart instructions. The output should include WSL and WSLg. These commands are described in the Microsoft WSL command reference.
Install muSRFlow. Double-click the Windows installer and complete setup. The runtime archive
muSRFlow-runtime-rootfs.tar.gzis included; do not extract or import it manually for a normal installation.Launch muSRFlow from the Start menu using your normal Windows account. First launch imports the runtime as
muSRFlow-runtimeand can take several minutes. Fit and Plot wait until preparation finishes. Afterwards, verify in PowerShell:wsl --list --verboseThe list should contain
muSRFlow-runtimewith VERSION 2.RunningandStoppedare both normal when idle. The runtime is stored under%LOCALAPPDATA%\muSRFlow\muSRFlow-runtimefor this account.Choose work and data folders before fitting. Create folders such as:
C:\Users\<your-name>\muSRFlow\work C:\Users\<your-name>\muSRFlow\dataIn File / Preferences, select them as Work directory and Data directory. Leave musrfit binaries and musrfit startup XML on automatic detection, then save. Enter normal Windows paths; muSRFlow translates them for WSL.
Use a work folder outside the application installation directory. The default
.can resolve to the installation folder and place your results among files managed by the installer.Try Plot, then Fit. Select a known instrument, year, and run. Click Plot and confirm that the spectrum window opens. Missing run data can be downloaded from
musruser.psi.chafter confirmation when the server is reachable. Then click Fit, check that the parameter table updates, and inspect the generated files in your work directory.
Existing installations
Preserve any MSR/data/result files currently stored inside the muSRFlow installation folder: move them to a separate work folder before upgrading.
Close muSRFlow and install the refreshed Windows application.
If your runtime was imported from an older bundle, add the missing Boost headers from PowerShell:
wsl -d muSRFlow-runtime -- dnf -y install boost-develThis needs access to the distribution's package repositories. ROOT uses these headers when loading musrview plotting classes. Fresh runtimes from the corrected installer already include them.
Reopen muSRFlow, select your work directory in Preferences, and retry Plot and Fit.
Reinstalling the application preserves an existing
muSRFlow-runtime distribution, so the application update
alone does not add those headers. The command above repairs it in place;
do not unregister the distribution as part of this update. The Linux
Install runtime... preference is not used on
Windows.
For WSL startup, runtime-library, or spectrum-window problems,
continue with the Windows section of troubleshooting.