Add Vivado 2025.2 support for Apple Silicon M3/M4 on Ubuntu 24.04

## Summary
Extends support to Vivado 2025.2 (latest as of 2025) running on Apple
Silicon M3/M4 Macs via Docker with Rosetta 2 emulation.  Upgrades the
container base image from Ubuntu 22.04 to Ubuntu 24.04 (the officially
supported platform for 2025.x) and fixes several compatibility issues
introduced by Docker Desktop 4.x and Ubuntu 24.04 package changes.

## Changes

### New: Vivado 2025.2 installer support
- scripts/hashes.sh: add MD5 hash for 2025.2 full installer
  (abe838aa2e2d3d9b10fea94165e9a303) and 2025.2.1 patch
  (85ac3a5975ec7906224896fdce842f21), both mapped to version 202520
- scripts/install_configs/202520.txt: new batch install config for
  Vivado ML Standard 2025.2 including new 2025.2 device families
  (Versal AI Edge Series Gen 2, Versal Prime Series Gen 2,
  Spartan UltraScale+).  Module names verified directly from the
  2025.2 installer binary via xsetup ConfigGen; notably 'Vitis Model
  Composer' description changed in 2025.2 and is explicitly disabled
  with the correct new name to suppress the post-install warning.

### Fix: Docker container base image → Ubuntu 24.04
- scripts/Dockerfile: full rewrite targeting Ubuntu 24.04 LTS:
  - gnome-themes-standard → gnome-themes-extra (removed upstream)
  - libtinfo5/libncursesw5 → libtinfo6/libncursesw6 + compat symlinks
    so Vivado's bundled binaries that hardcode .so.5 still load
  - libgtk2.0-0 → libgtk2.0-0t64 (64-bit time_t transition package)
  - libjpeg62-dev → libjpeg-dev
  - libswt-gtk-4-jni removed (now bundled inside Vivado 2025.x)
  - tigervnc-tools added explicitly (vncpasswd moved out of
    tigervnc-common in Ubuntu 24.04; --no-install-recommends skips it)
  - All apt layers merged into a single RUN to minimise image size
  - ENV JAVA_TOOL_OPTIONS="-Xmx4096m -Xms512m" caps JVM heap at 4 GiB
    for both the xsetup installer and Vivado runtime, preventing OOM
    on systems with constrained Docker swap

### Fix: Docker Desktop 4.x settings file location and key names
- scripts/configure_docker.sh: complete rewrite of settings update logic:
  - Docker Desktop 4.x moved settings from settings.json to
    settings-store.json with PascalCase key names
    (UseVirtualizationFramework, UseVirtualizationFrameworkRosetta,
    SwapMiB) — the old sed-based approach silently did nothing
  - Now searches settings-store.json first, falls back to settings.json
  - Uses Python 3 to safely parse and update JSON regardless of key
    casing, and adds UseVirtualizationFrameworkRosetta if the key does
    not exist yet (new Docker Desktop installations omit it)
  - Minimum swap raised from 4096 to 8192 MiB for 2025.x synthesis
  - Friendly manual-steps message shown if auto-config fails

### Fix: libgdk path change in Ubuntu 24.04
- scripts/de_start.sh: LD_PRELOAD path for libgdk-x11-2.0.so.0 moved
  from /lib/x86_64-linux-gnu/ to /usr/lib/x86_64-linux-gnu/ in Ubuntu
  24.04; now resolved dynamically with 'find' so both layouts work

### Fix: cleanup.sh silent exit and missing artifacts
- scripts/cleanup.sh: was completely silent — users had no indication
  whether anything was cleaned; now prints each item removed and a
  final count (or 'nothing to clean' if the directory is fresh)
- Also cleans scripts/install_bin and scripts/vnc_resolution which
  are written by setup.sh but were previously left behind, causing
  confusing state on re-runs

### Fix: install_bin removed from git tracking
- scripts/install_bin was accidentally committed; it is already listed
  in .gitignore (since commit 9238bc6) — removed from the index so
  git stops tracking it

### Improvement: installer cleanup after successful install
- scripts/install_vivado.sh: automatically removes the extracted
  installer directory (~1 GB) after a successful install; Vivado
  itself lives in the bind-mounted Xilinx/ folder on the host and
  persists across container restarts with no re-download required

### Improvement: macOS 14 warning in setup
- scripts/setup.sh: warns and prompts for confirmation when running
  on macOS 14, which has known Rosetta 2 emulation bugs that can
  cause installation failures; macOS 15+ recommended for M3/M4

### Docs: README updated
- Added Vivado 2025.2 to supported versions table
- Added M3/M4 compatibility notes and macOS 15 recommendation
- Documented Java heap cap (JAVA_TOOL_OPTIONS) and why it matters
- Documented Docker swap requirement (8 GiB)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: FlutterOTA Setup

.gitignore

@@ -14,3 +14,4 @@ installer/
 .vnc/
 .xsession-errors
 scripts/install_bin
+.flexlmrc

README.md

@@ -1,16 +1,21 @@
 # vivado-on-silicon-mac
 This is a tool for installing [Vivado™](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools.html) on Arm®-based Apple Silicon Macs in a Rosetta-enabled virtual machine. It is in no way associated with Xilinx or AMD.
 
-*Updated for 2024!*
+*Updated for 2025.2!*
 
 The supported versions are:
 - 2021.1
 - 2022.2
 - 2023.1
 - 2023.2
 - 2024.1
+- **2025.2** (and 2025.2.1 patch)
 
-Due to unexpected behaviour in Rosetta emulation, most versions of macOS 14 (including 14.5) are not supported. macOS 13 may work, but the above versions were tested on macOS 15.
+## Compatibility
+- **Apple Silicon**: M1, M2, M3, M4 and later chips are all supported.
+- **macOS**: macOS 15 (Sequoia) is recommended and tested. macOS 13 may work.  
+  ⚠️ Most versions of macOS 14 (Sonoma) are **not supported** due to Rosetta emulation bugs — the installer will warn you if you are on macOS 14.
+- The Docker container image is kept well under **8 GiB** (Vivado itself is installed to a bind-mounted folder, not inside the image).
 
 ## How to install
 Expect the installation process to last about one to two hours and download ~20 GB for the web installer.
@@ -66,7 +71,12 @@ If you want to use additional Ubuntu packages, specify them in the Dockerfile. I
 
 ## How it works
 ### Docker, Rosetta & VNC
-This collection of scripts creates an x64 Docker container running Linux® that is accelerated by [Rosetta 2](https://developer.apple.com/documentation/apple-silicon/about-the-rosetta-translation-environment) via the Apple Virtualization framework. The container has all the necessary libraries preinstalled for running Vivado. It is installed automatically given an installer file that the user must provide. GUI functionality is provided via VNC and the built-in "Screen Sharing" app.
+This collection of scripts creates an x64 Docker container running **Ubuntu 24.04** Linux that is accelerated by [Rosetta 2](https://developer.apple.com/documentation/apple-silicon/about-the-rosetta-translation-environment) via the Apple Virtualization framework. The container has all the necessary libraries preinstalled for running Vivado. It is installed automatically given an installer file that the user must provide. GUI functionality is provided via VNC and the built-in "Screen Sharing" app.
+
+The Docker container image is kept under **8 GiB** — Vivado itself is installed to the host-side bind-mounted folder (`/home/user/Xilinx`) and is therefore not part of the image.
+
+### Java heap limit
+Vivado and its installer are Java-based. The container sets `JAVA_TOOL_OPTIONS="-Xmx4096m -Xms512m"` so that the JVM heap is capped at **4 GiB**. This prevents out-of-memory kills during large syntheses and keeps overall memory consumption within the Docker resource limits you configure.
 
 ### USB connection
 A drawback of the Apple Virtualization framework is that there is no implementation for USB forwarding as of when I'm writing this. Therefore, these scripts set up the [Xilinx Virtual Cable protocol](https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/644579329/Xilinx+Virtual+Cable). Intended to let a computer connect to an FPGA plugged into a remote computer, it allows for the host system to run an XVC server (in this case a software called [xvcd](https://github.com/tmbinc/xvcd) by Felix Domke), to which the docker container can connect.

scripts/Dockerfile

@@ -1,59 +1,94 @@
-# Container for running Vivado on M1/M2 macs
-# though it should work equally on Intel macs
-FROM --platform=linux/amd64 ubuntu:22.04
-RUN apt-get update && apt-get upgrade -y
-
-# Fix the error of build failing due to not having the frontend installed
-# This enviroment auto fallbacks to noninteractive mode, with the declaration following this guidance:
-# https://bobcares.com/blog/debian_frontendnoninteractive-docker/
-# https://github.com/moby/moby/issues/4032#issuecomment-34597177
+# Container for running Vivado on Apple Silicon (M1/M2/M3/M4) Macs.
+# Uses linux/amd64 platform accelerated by Rosetta 2 via the Apple Virtualization Framework.
+FROM --platform=linux/amd64 ubuntu:24.04
+
+# Prevent interactive prompts during package installation
 ARG DEBIAN_FRONTEND=noninteractive
 
-# Check and install ca-certificates earlier if Rosetta gets broken
-RUN apt -y install ca-certificates
-
-# install gui
-RUN apt-get install -y --no-install-recommends \
-    dbus dbus-x11 x11-utils xorg alsa-utils mesa-utils net-tools \
-    libgl1-mesa-dri gtk2-engines lxappearance fonts-droid-fallback sudo firefox \
-    ubuntu-gnome-default-settings curl gnupg lxde arc-theme \
-    gtk2-engines-murrine gtk2-engines-pixbuf gnome-themes-standard nano xterm
-
-# install dependencies for Vivado
-RUN apt-get install -y --no-install-recommends \
-    python3-pip python3-dev build-essential git gcc-multilib g++ \
-    ocl-icd-opencl-dev libjpeg62-dev libc6-dev-i386 graphviz make \
-    unzip libtinfo5 xvfb libncursesw5 locales libswt-gtk-4-jni
-
-# install vnc server (with recommended installs)
-RUN apt-get install -y \
-    tigervnc-standalone-server tigervnc-xorg-extension
-
-# create user "user" with password "password"
-RUN useradd --create-home --shell /bin/bash --user-group --groups adm,sudo user
-RUN sh -c 'echo "user:password" | chpasswd'
-# RUN cp -r /root/{.config,.gtkrc-2.0,.asoundrc} /home/user
-RUN chown -R user:user /home/user
-# setup LXDE
-RUN mkdir -p /home/user/.config/pcmanfm/LXDE/
-RUN ln -sf /usr/local/share/doro-lxde-wallpapers/desktop-items-0.conf \
-    /home/user/.config/pcmanfm/LXDE/
-RUN mv /usr/bin/lxpolkit /usr/bin/lxpolkit.bak
-#RUN echo "" >> /etc/xdg/lxsession/LXDE/autostart
-#RUN echo "@lxterminal -e /home/user/scripts/de_start.sh" >> /etc/xdg/lxsession/LXDE/autostart
-# setup TigerVNC
-RUN sed -i 's/-iconic/-nowin/g' /etc/X11/Xtigervnc-session
-RUN mkdir /home/user/.vnc
-RUN echo "password" | vncpasswd -f > /vncpasswd
-RUN chown user /vncpasswd
-RUN chmod 600 /vncpasswd
-
-# Set the locale, because Vivado crashes otherwise
-RUN sed -i '/en_US.UTF-8/s/^# //g' /etc/locale.gen && \
-    locale-gen
+# Install ALL packages in a single layer and clean up immediately to keep the
+# image well under 8 GiB.  Package notes for Ubuntu 24.04:
+#   - libtinfo5 / libncursesw5 are gone → replaced by libtinfo6 / libncursesw6
+#     (backward-compat symlinks are created in the next step)
+#   - libjpeg62-dev is gone → replaced by libjpeg-dev
+#   - libgtk2.0-0 is now libgtk2.0-0t64 (64-bit time_t transition)
+#   - firefox removed (large, not needed inside the container)
+#   - libswt-gtk-4-jni removed (bundled inside Vivado 2025.x)
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+        # Core utilities
+        ca-certificates curl gnupg sudo nano \
+        # D-Bus and X11 infrastructure
+        dbus dbus-x11 x11-utils xorg xvfb net-tools \
+        # OpenGL / display
+        libgl1-mesa-dri libglu1-mesa \
+        # Lightweight desktop (LXDE) and supporting themes/tools
+        lxde lxappearance lxterminal xterm \
+        gtk2-engines-murrine gtk2-engines-pixbuf \
+        gnome-themes-extra \
+        # Audio support
+        alsa-utils \
+        # Vivado build and runtime dependencies
+        python3-pip python3-dev build-essential git \
+        gcc-multilib g++ \
+        ocl-icd-opencl-dev libjpeg-dev libc6-dev-i386 \
+        graphviz make unzip \
+        # ncurses / terminal libs (Ubuntu 24.04 names)
+        libtinfo6 libncurses6 libncursesw6 \
+        # GTK2 runtime required by Vivado GUI (t64 transition package in 24.04)
+        libgtk2.0-0t64 \
+        # Locale support (Vivado crashes without a proper locale)
+        locales \
+        # TigerVNC server for remote GUI access
+        # tigervnc-tools is required explicitly — it provides vncpasswd in Ubuntu 24.04
+        tigervnc-standalone-server tigervnc-xorg-extension tigervnc-tools \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create backward-compatible symlinks so that Vivado binaries that reference
+# the old .so.5 names still resolve correctly under Ubuntu 24.04.
+RUN ln -sf /lib/x86_64-linux-gnu/libtinfo.so.6    /lib/x86_64-linux-gnu/libtinfo.so.5 && \
+    ln -sf /lib/x86_64-linux-gnu/libncursesw.so.6 /lib/x86_64-linux-gnu/libncursesw.so.5
+
+# Create user "user" with password "password".
+# The password is intentionally weak — the VNC server only accepts connections
+# from the macOS host (127.0.0.1 binding in the docker run command).
+RUN useradd --create-home --shell /bin/bash --user-group --groups adm,sudo user && \
+    echo "user:password" | chpasswd && \
+    chown -R user:user /home/user
+
+# Setup LXDE desktop configuration
+RUN mkdir -p /home/user/.config/pcmanfm/LXDE/ && \
+    if [ -f /usr/local/share/doro-lxde-wallpapers/desktop-items-0.conf ]; then \
+        ln -sf /usr/local/share/doro-lxde-wallpapers/desktop-items-0.conf \
+               /home/user/.config/pcmanfm/LXDE/; \
+    fi && \
+    # Disable lxpolkit to prevent authentication pop-ups on desktop start
+    if [ -f /usr/bin/lxpolkit ]; then mv /usr/bin/lxpolkit /usr/bin/lxpolkit.bak; fi
+
+# Setup TigerVNC
+RUN sed -i 's/-iconic/-nowin/g' /etc/X11/Xtigervnc-session && \
+    mkdir -p /home/user/.vnc && \
+    echo "password" | vncpasswd -f > /vncpasswd && \
+    chown user /vncpasswd && \
+    chmod 600 /vncpasswd
+
+# Generate locale — Vivado crashes at startup without en_US.UTF-8
+RUN sed -i '/en_US.UTF-8/s/^# //g' /etc/locale.gen && locale-gen
 ENV LANG=en_US.UTF-8
 ENV LANGUAGE=en_US:en
 ENV LC_ALL=en_US.UTF-8
 
-# Without this, Vivado will crash when synthesizing
-ENV LD_PRELOAD="/lib/x86_64-linux-gnu/libudev.so.1 /lib/x86_64-linux-gnu/libselinux.so.1 /lib/x86_64-linux-gnu/libz.so.1 /lib/x86_64-linux-gnu/libgdk-x11-2.0.so.0"
+# Cap Java heap at 4 GiB.
+# Vivado and its installer are Java-based. Without a limit the JVM can
+# claim far more than available RAM, causing OOM kills inside the container.
+# JAVA_TOOL_OPTIONS is the portable, standard variable respected by all
+# JVM implementations (Java 8+).
+ENV JAVA_TOOL_OPTIONS="-Xmx4096m -Xms512m"
+
+# LD_PRELOAD workaround for Vivado stability under Rosetta 2.
+# - libudev / libselinux / libz: prevent crashes during synthesis
+# - libgdk-x11-2.0: prevents GUI crashes on startup
+# NOTE: libgdk moved to /usr/lib in Ubuntu 24.04 (libgtk2.0-0t64 package).
+# de_start.sh resolves the exact path at runtime to handle any layout variation.
+ENV LD_PRELOAD="/lib/x86_64-linux-gnu/libudev.so.1 /lib/x86_64-linux-gnu/libselinux.so.1 /lib/x86_64-linux-gnu/libz.so.1"
+

scripts/cleanup.sh

@@ -7,11 +7,33 @@ source $script_dir/header.sh
 validate_macos
 
 cd $script_dir/..
+
 to_remove=(".cache" ".dbus" ".local" ".vnc" "Xilinx" ".Xilinx"
 "Desktop" "installer" ".bash_history" ".lesshst" ".sudo_as_admin_successful"
 ".Xauthority" ".xsession-errors" ".XIC.lock" ".mozilla" ".java" ".config"
 ".fontconfig" )
+
+removed=0
 for file in ${to_remove[@]}
 do
-    rm -rf $file
-done
+    if [ -e "$file" ] || [ -L "$file" ]; then
+        f_echo "Removing: $file"
+        rm -rf "$file"
+        removed=$((removed + 1))
+    fi
+done
+
+# Also clean setup artifacts written by setup.sh
+for artifact in "scripts/install_bin" "scripts/vnc_resolution"; do
+    if [ -f "$artifact" ]; then
+        f_echo "Removing setup artifact: $artifact"
+        rm -f "$artifact"
+        removed=$((removed + 1))
+    fi
+done
+
+if [ "$removed" -eq 0 ]; then
+    f_echo "Nothing to clean — directory is already fresh."
+else
+    f_echo "Cleanup complete. Removed $removed item(s)."
+fi

scripts/configure_docker.sh

@@ -1,52 +1,88 @@
 #!/bin/zsh
 
-# Attempts to configure Docker by enabling Rosetta and increasing swap
+# Attempts to configure Docker by enabling Rosetta and increasing swap.
+# Tested on Apple Silicon (M1/M2/M3/M4) running macOS 13–15.
+#
+# Supports both Docker Desktop settings file formats:
+#   Legacy : settings.json      (keys: camelCase,  e.g. useVirtualizationFramework)
+#   Current: settings-store.json (keys: PascalCase, e.g. UseVirtualizationFramework)
 
 script_dir=$(dirname -- "$(readlink -nf $0)";)
 source "$script_dir/header.sh"
 validate_macos
 
 function cannot_setup_docker {
     f_echo "Unfortunately, the script could not configure Docker automatically."
-    f_echo "This means that you have to change the settings in the Docker Dashboard yourself:"
-    f_echo "Enable the Virtualization Framework, Rosetta emulation and set Swap to at least 2 GiB."
-    f_echo "Restart Docker after applying the changes and then continue with the installation."
+    f_echo "Please change the settings in Docker Desktop manually:"
+    f_echo "  Settings → General  → 'Use Virtualization Framework'  → ON"
+    f_echo "  Settings → Features → 'Use Rosetta for x86/amd64 emulation' → ON"
+    f_echo "  Settings → Resources → Swap → at least 8 GiB"
+    f_echo "Restart Docker after applying the changes, then continue."
     wait_for_user_input
     exit 1
 }
 
-docker_settings_file="$HOME/Library/Group Containers/group.com.docker/settings.json"
+# Locate the settings file — Docker Desktop 4.x moved to settings-store.json
+docker_settings_file=""
+for candidate in \
+    "$HOME/Library/Group Containers/group.com.docker/settings-store.json" \
+    "$HOME/Library/Group Containers/group.com.docker/settings.json"
+do
+    if [ -f "$candidate" ]; then
+        docker_settings_file="$candidate"
+        break
+    fi
+done
 
-stop_docker
-
-# check if the settings file is in the expected place
-if ! [ -f "$docker_settings_file" ]
-then
+if [ -z "$docker_settings_file" ]; then
     cannot_setup_docker
 fi
 
-# check if the attributes to be modified exist
-if grep "\"useVirtualizationFramework\":" "$docker_settings_file" > /dev/null \
-&& grep "\"useVirtualizationFrameworkRosetta\":" "$docker_settings_file" > /dev/null \
-&& grep "\"swapMiB\":" "$docker_settings_file" > /dev/null
-then
-    :
-else
-    cannot_setup_docker
-fi
+stop_docker
+
+# Use Python to safely update the JSON settings regardless of key casing.
+# This handles both the legacy camelCase format and the newer PascalCase format.
+python3 - "$docker_settings_file" <<'PYEOF'
+import sys, json
+
+path = sys.argv[1]
+with open(path, 'r') as f:
+    data = json.load(f)
 
-# enable Virtualization Framework
-sed -i "" "s/\"useVirtualizationFramework\": false/\"useVirtualizationFramework\": true/" "$docker_settings_file"
+min_swap = 8192
 
-# enable Rosetta emulation
-sed -i "" "s/\"useVirtualizationFrameworkRosetta\": false/\"useVirtualizationFrameworkRosetta\": true/" "$docker_settings_file"
+# Build a normalised key map so we can match regardless of case
+key_map = {k.lower(): k for k in data}
 
-# set swap to minimum 4 GiB
-minSwap=4096
-swapMiB=$(cat "$docker_settings_file" | grep "\"swapMiB\"" | sed "s/[^0-9]//g")
-if [ "$swapMiB" -lt "$minSwap" ]
-then
-    sed -i "" "s/\"swapMiB\": [0-9]*/\"swapMiB\": $minSwap/" "$docker_settings_file"
+def set_key(logical_lower, pascal_key, camel_key, value):
+    """Set a value using whichever key variant already exists, or add PascalCase."""
+    existing = key_map.get(logical_lower)
+    if existing:
+        data[existing] = value
+    else:
+        # Key doesn't exist yet — add it in PascalCase (current Docker format)
+        data[pascal_key] = value
+
+set_key('usevirtualizationframework',       'UseVirtualizationFramework',       'useVirtualizationFramework',       True)
+set_key('usevirtualizationframeworkrosetta','UseVirtualizationFrameworkRosetta', 'useVirtualizationFrameworkRosetta', True)
+
+# Only increase swap, never decrease
+swap_key = key_map.get('swapmib', 'SwapMiB')
+current_swap = data.get(swap_key, 0)
+if current_swap < min_swap:
+    data[swap_key] = min_swap
+
+with open(path, 'w') as f:
+    json.dump(data, f, indent=4)
+
+print(f"  UseVirtualizationFramework       = {data.get(key_map.get('usevirtualizationframework', 'UseVirtualizationFramework'))}")
+print(f"  UseVirtualizationFrameworkRosetta = {data.get(key_map.get('usevirtualizationframeworkrosetta', 'UseVirtualizationFrameworkRosetta'))}")
+print(f"  SwapMiB                           = {data.get(swap_key)}")
+PYEOF
+
+if [ $? -ne 0 ]; then
+    f_echo "Failed to update Docker settings automatically."
+    cannot_setup_docker
 fi
 
-f_echo "Configured Docker successfully"
+f_echo "Configured Docker successfully (file: $docker_settings_file)"

scripts/de_start.sh

@@ -7,7 +7,12 @@ script_dir=$(dirname -- "$(readlink -nf $0)";)
 source "$script_dir/header.sh"
 validate_linux
 
-export LD_PRELOAD="/lib/x86_64-linux-gnu/libudev.so.1 /lib/x86_64-linux-gnu/libselinux.so.1 /lib/x86_64-linux-gnu/libz.so.1 /lib/x86_64-linux-gnu/libgdk-x11-2.0.so.0"
+# Resolve the libgdk path at runtime — it moved from /lib to /usr/lib in
+# Ubuntu 24.04 (libgtk2.0-0t64 package from the 64-bit time_t transition).
+GDK_LIB=$(find /lib/x86_64-linux-gnu /usr/lib/x86_64-linux-gnu \
+               -name "libgdk-x11-2.0.so.0" 2>/dev/null | head -1)
+
+export LD_PRELOAD="/lib/x86_64-linux-gnu/libudev.so.1 /lib/x86_64-linux-gnu/libselinux.so.1 /lib/x86_64-linux-gnu/libz.so.1${GDK_LIB:+ $GDK_LIB}"
 
 # if Vivado is installed
 if [ -d "/home/user/Xilinx" ]

scripts/hashes.sh

@@ -14,6 +14,9 @@ declare -A web_hashes=(
     ["e47ad71388b27a6e2339ee82c3c8765f"]=202310
     ["b8c785d03b754766538d6cde1277c4f0"]=202320
     ["8b0e99a41b851b50592d5d6ef1b1263d"]=202410
+    ["abe838aa2e2d3d9b10fea94165e9a303"]=202520
+    # 2025.2.1 patch installer — maps to same install config as 2025.2
+    ["85ac3a5975ec7906224896fdce842f21"]=202520
 )
 # hashes for the full installer
 # not tested yet