Installation - Q-FRC/QDash GitHub Wiki
All release builds can be found in the releases tab.
To install QFRCDashboard, please go to your respective platform below.
Linux
Linux has two options: AppImage (recommended), and binary (for package managers).
AppImage
Download the AppImage from the releases tab, and allow executable permissions on it:
chmod a+x QFRCDashboard-Linux-2025.0.0-beta2-x86_64.AppImage
Then, you can run it from your favorite file manager, pin it to the desktop/start menu, or from the command line:
./QFRCDashboard-Linux-2025.0.0-beta2-x86_64.AppImage
Binary
Download the binary tarball from the releases tab and extract it:
tar xf QFRCDashboard-Linux-Binary-2025.0.0-beta2.tar.gz
From here, you can install it to your system (/usr/local), or install it to a package directory to create a package (e.g. .deb, .pkg.tar.zst). Note that Arch Linux will not work properly due to an inconsistency in their build from Ubuntu's builds (used by the Actions runner).
macOS
macOS builds are provided via a .app. Download the macOS zip from the releases tab, and Safari should automatically extract it into an application. If not using Safari, double-click the downloaded zip and macOS will automatically extract the application. Move this to your Applications directory if desired.
If you see a warning such as the following:
Then you will need to enter System Settings -> Privacy & Security -> Security, and "Open Anyway" where prompted for QFRCDashboard.
Windows
Windows builds come in two forms: a portable app, and an installer.
Portable
Download the portable Windows zip from the releases tab. Extract the directory and move it to your desired location. If the application fails to launch, launch the vc_redist.exe executable found in the same folder.
Installer
Download the Windows setup EXE from the releases tab. Run the executable and follow the instructions. If prompted to install Visual C++, proceed to do so, as this is required to run the app.