Linux installation

Download the Linux packages

Open the muSRFlow Releases page and choose the application RPM or AppImage for x86_64 Linux. Also download a musrflow-runtime package if the computer does not already have a working ROOT and musrfit installation. Verify the accompanying checksums before installation.

Install the muSRFlow application, then select a working ROOT + musrfit installation. The Linux application package does not include the scientific runtime. The application bundles no musrfit binaries; use an existing ROOT + musrfit installation, install the separate runtime (AppImage/RPM or the offline bundle in Preferences), or provide tools via the configured binaries directory. Node.js and npm are not needed on the target PC.

The current application packages are for x86_64 Linux. Commands below use 1.0.3 as an example; replace it with the downloaded release. Run the commands from the folder containing the downloaded files.

Install the application

Choose one application format.

RPM

On an RPM-based distribution with dnf:

VERSION=1.0.3
sudo dnf install "./musrflow-${VERSION}-x86_64.rpm"
musrflow

On other RPM systems, use the distribution’s package manager. The application RPM filename starts with lowercase musrflow.

AppImage

VERSION=1.0.3
chmod +x "muSRFlow-${VERSION}-x86_64.AppImage"
"./muSRFlow-${VERSION}-x86_64.AppImage"

The application AppImage filename starts with muSRFlow. It requires a compatible Linux desktop and AppImage/FUSE support. If it cannot start, check the terminal output or use the RPM on a supported RPM distribution.

Set up ROOT and musrfit

Use an existing installation

Open File / Preferences. Leave musrfit binaries on automatic detection for a standard installation, or choose the directory containing musrfit, musrview, msr2data, musrt0, and dump_header. Save your settings, then use Check tools to verify the saved selection.

Install the separate runtime from a local bundle

  1. Obtain the runtime bundle for your architecture. Keep runtime-download.json and its matching musrflow-runtime-*.tar.gz archive in the same folder. You do not need to unpack it.

  2. Open File / Preferences / Install runtime… and select runtime-download.json.

  3. Review the versions and destination, then select Install and use. muSRFlow validates the archive, installs it in your personal application data directory, and selects its tools.

  4. Use Check tools to confirm the selected runtime starts.

This installation does not require administrator access. Runtime downloads are not automatic: obtain the bundle separately before opening the installer. A compatible Linux system and desktop/display services are still required.

Alternative: system runtime RPM

VERSION=1.0.3
sudo dnf install "./musrflow-runtime-${VERSION}-x86_64.rpm"

This installs the runtime into /opt/musrflow/runtime, which muSRFlow recognizes automatically when no explicit tool directory takes precedence.

Alternative: runtime AppImage

For a user-writable runtime location:

VERSION=1.0.3
chmod +x "musrflow-runtime-${VERSION}-x86_64.AppImage"
"./musrflow-runtime-${VERSION}-x86_64.AppImage" --install "$HOME/.local/share/musrflow/runtime"

Launch the application with the installed runtime selected:

MUSRFLOW_RUNTIME_ROOT="$HOME/.local/share/musrflow/runtime" musrflow

For the application AppImage, replace musrflow in that command with its path. Leave musrfit binaries on automatic detection so the selected runtime is used. Without a custom destination, the runtime AppImage installs to /opt/musrflow/runtime and needs permission to write there. Its filename is lowercase musrflow-runtime, unlike the application AppImage.

Choose folders and test

  1. In File / Preferences, choose a writable Work directory outside the application installation folder, for example ~/muSRFlow/work. Use Browse… to select it.

  2. Set Data directory to the root of your instrument data tree, or to a writable folder such as ~/muSRFlow/data for downloaded runs.

  3. Leave musrfit startup XML on automatic detection unless you have a specific installation configuration, then save.

  4. Select a known instrument, year, and run. Click Plot, then Fit. Confirm the spectrum opens, fitted parameters update, and output files appear in your work directory. Missing runs can be downloaded from musruser.psi.ch after confirmation when the server is reachable.

Updating and troubleshooting

  • Upgrade the application RPM with your package manager, or replace the application AppImage. The separate runtime is not updated by an app upgrade.

  • Preserve work files outside the application/runtime installation directories.

  • For missing tools or shared libraries, run Check tools and inspect the reported executable paths. A configured binaries directory overrides automatic detection; clear an obsolete selection or choose the correct one.

  • If fitting works but no spectrum window opens, inspect the run log and confirm your desktop session can display native musrview windows.

  • If data are missing, check the instrument, year, run number, and data root. Downloaded files use the selected writable data root or the personal fallback folder reported in Preferences.

Include the application version and run log when reporting a problem.