From 01f0d97c48064a2c541ac07acc4de05a06ee8b87 Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 20 Oct 2026 08:37:42 -0300 Subject: [PATCH 01/10] build(installer): add KLayout checksum for Ubuntu 26.04 The amd64 KLayout install stopped on Ubuntu 26.04 because no checksum was set for it. The checksum is the md5 of the Ubuntu-26 release package on klayout.org. The error text now lists 24.04 and 26.04 as supported. The 22.04 path stays, but it is not supported. Signed-off-by: Vitor Bandeira --- etc/DependencyInstaller.sh | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/etc/DependencyInstaller.sh b/etc/DependencyInstaller.sh index 3b8c2ac218..158742acfa 100755 --- a/etc/DependencyInstaller.sh +++ b/etc/DependencyInstaller.sh @@ -421,8 +421,10 @@ _installUbuntuPackages() { klayoutChecksum=6dfffa50f385881768dee30bdc759608 elif [[ $1 == 24.04 ]]; then klayoutChecksum=0181713e60891e461d6d1664c1b8e213 + elif [[ $1 == 26.04 ]]; then + klayoutChecksum=904f60fd05c3a5029cab8a2840029f49 else - echo "Unsupported Ubuntu version $1. Supported versions: 22.04, 24.04. Please upgrade to a supported LTS release or install KLayout ${klayoutVersion} manually from https://www.klayout.org/build.html" + echo "Unsupported Ubuntu version $1. Supported versions: 24.04, 26.04. Please upgrade to a supported LTS release or install KLayout ${klayoutVersion} manually from https://www.klayout.org/build.html" exit 1 fi wget https://www.klayout.org/downloads/Ubuntu-${1%.*}/klayout_${klayoutVersion}-1_amd64.deb From c72e07489671b8a5e09874deac3fb66472817571 Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 20 Oct 2026 08:37:45 -0300 Subject: [PATCH 02/10] build(docker): accept ubuntu24.04 and ubuntu26.04 as OS DockerHelper.sh accepted only ubuntu22.04, so CI could not build images on newer Ubuntu releases. The default stays ubuntu22.04. Signed-off-by: Vitor Bandeira --- build_openroad.sh | 3 ++- etc/DockerHelper.sh | 9 ++++++++- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/build_openroad.sh b/build_openroad.sh index b6d26dc754..2a33438e5d 100755 --- a/build_openroad.sh +++ b/build_openroad.sh @@ -101,7 +101,8 @@ Options: Options valid only for Docker builds: -c, --copy-platforms Copy platforms to inside docker image. - --os=DOCKER_OS_NAME Use ubuntu22.04 (default). + --os=DOCKER_OS_NAME Use ubuntu22.04 (default), ubuntu24.04 or + ubuntu26.04. This script builds the OpenROAD tools: openroad, yosys and yosys plugins. By default, the tools will be built from the linked submodule hashes. diff --git a/etc/DockerHelper.sh b/etc/DockerHelper.sh index 69da539cc1..d2498cd30c 100755 --- a/etc/DockerHelper.sh +++ b/etc/DockerHelper.sh @@ -21,7 +21,8 @@ usage: $0 [CMD] [OPTIONS] push Push the docker image to Docker Hub OPTIONS: - -os=OS_NAME Use ubuntu22.04 (default). + -os=OS_NAME Use ubuntu22.04 (default), ubuntu24.04 or + ubuntu26.04. -target=TARGET Choose target for the Docker image: 'dev': os + packages to compile app 'builder': os + packages to compile app + @@ -48,6 +49,12 @@ _setup() { "ubuntu22.04") osBaseImage="ubuntu:22.04" ;; + "ubuntu24.04") + osBaseImage="ubuntu:24.04" + ;; + "ubuntu26.04") + osBaseImage="ubuntu:26.04" + ;; *) echo "Target OS ${os} not supported" >&2 _help From 33bb7fb274424c387514e6d0c0583a8fa226c62d Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 20 Oct 2026 08:37:48 -0300 Subject: [PATCH 03/10] ci: build and test images on Ubuntu 26.04 and 24.04 Ubuntu 22.04 is not supported now. The image publish and installer test jobs now use the two supported Ubuntu releases. Signed-off-by: Vitor Bandeira --- .github/workflows/github-actions-cron-test-installer.yml | 2 +- .github/workflows/github-actions-publish-docker-images.yml | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/github-actions-cron-test-installer.yml b/.github/workflows/github-actions-cron-test-installer.yml index d63c0f7d86..604824eab3 100644 --- a/.github/workflows/github-actions-cron-test-installer.yml +++ b/.github/workflows/github-actions-cron-test-installer.yml @@ -29,7 +29,7 @@ jobs: strategy: fail-fast: false matrix: - os: ["ubuntu22.04"] + os: ["ubuntu26.04", "ubuntu24.04"] runs-on: ${{ vars.USE_SELF_HOSTED == 'true' && 'self-hosted-ubuntu-26.04' || 'ubuntu-26.04' }} env: INSTALLER_TAG: installer-${{ github.run_id }}-${{ github.run_attempt }} diff --git a/.github/workflows/github-actions-publish-docker-images.yml b/.github/workflows/github-actions-publish-docker-images.yml index 5e65289756..5b493560ba 100644 --- a/.github/workflows/github-actions-publish-docker-images.yml +++ b/.github/workflows/github-actions-publish-docker-images.yml @@ -53,7 +53,7 @@ jobs: strategy: fail-fast: false matrix: - os: [["ubuntu22.04", "ubuntu:22.04"]] + os: [["ubuntu26.04", "ubuntu:26.04"], ["ubuntu24.04", "ubuntu:24.04"]] runs-on: ${{ vars.USE_SELF_HOSTED == 'true' && 'self-hosted-ubuntu-26.04' || 'ubuntu-26.04' }} steps: - name: Check out repository code @@ -97,7 +97,7 @@ jobs: strategy: fail-fast: false matrix: - os: ["ubuntu22.04"] + os: ["ubuntu26.04", "ubuntu24.04"] runs-on: ${{ vars.USE_SELF_HOSTED == 'true' && 'self-hosted-ubuntu-26.04' || 'ubuntu-26.04' }} steps: - name: Free Disk Space From 557dd5adad9ea03b1978aed5de4e818184592da8 Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 20 Oct 2026 08:37:50 -0300 Subject: [PATCH 04/10] docs: list Ubuntu 26.04 and 24.04 as supported Ubuntu 22.04 is not supported now. The examples use Ubuntu 26.04, and the Docker guide lists the valid -os values. Signed-off-by: Vitor Bandeira --- docs/user/BuildLocally.md | 2 +- docs/user/BuildWithDocker.md | 12 +++++++----- docs/user/BuildWithWSL.md | 2 +- 3 files changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/user/BuildLocally.md b/docs/user/BuildLocally.md index c04d55d8eb..15ccf7ff9c 100644 --- a/docs/user/BuildLocally.md +++ b/docs/user/BuildLocally.md @@ -4,7 +4,7 @@ The `setup.sh` script installs all of the dependencies, including OpenROAD dependencies, if they are not already installed. -Supported configurations are: Ubuntu 22.04, RHEL 8 and RockyLinux 9. +Supported configurations are: Ubuntu 26.04, Ubuntu 24.04, RHEL 8 and RockyLinux 9. ``` shell git clone --recursive https://github.com/The-OpenROAD-Project/OpenROAD-flow-scripts diff --git a/docs/user/BuildWithDocker.md b/docs/user/BuildWithDocker.md index adbe6ae92e..04357e719b 100644 --- a/docs/user/BuildWithDocker.md +++ b/docs/user/BuildWithDocker.md @@ -25,7 +25,7 @@ then is recommended that you restrict the number of CPUs used by the scripts ::: ``` shell -docker run --rm ubuntu:22.04 nproc +docker run --rm ubuntu:26.04 nproc ``` ### Build Using Docker from pre-built binaries @@ -42,7 +42,7 @@ You can start the container in an interactive mode using the command below. ```shell -docker run -it ubuntu:22.04 +docker run -it ubuntu:26.04 ``` Now you are ready to install the prebuilt binaries. @@ -57,13 +57,13 @@ do follow the instructions below. #### Clone and Build -The following instructions build the docker image with Ubuntu 22.04 as the base OS: +The following instructions build the docker image with Ubuntu 26.04 as the base OS: ``` shell git clone --recursive https://github.com/The-OpenROAD-Project/OpenROAD-flow-scripts cd OpenROAD-flow-scripts -./build_openroad.sh +./build_openroad.sh --os=ubuntu26.04 ``` You can restrict the number of CPUs with the `-t|--threads N` argument: @@ -145,7 +145,7 @@ Do refer to the documentation [here](./DockerShell.md). The following instructions build the docker image with a parameterized OS in two stages. These are for CI and developers that wish to use an OS other -than Ubuntu 22.04; regular users should use the steps from previous sections. +than Ubuntu 26.04; regular users should use the steps from previous sections. The dev stage installs all dependencies and packages required to run OpenROAD and OpenROAD Flow Scripts. The build stage generates all binaries needed to run the flow (i.e., `openroad` and `yosys`). @@ -156,3 +156,5 @@ cd OpenROAD-flow-scripts ./etc/DockerHelper.sh create -target=dev -os=$OS_NAME ./etc/DockerHelper.sh create -target=builder -os=$OS_NAME ``` + +Valid values for `$OS_NAME` are `ubuntu26.04` and `ubuntu24.04`. diff --git a/docs/user/BuildWithWSL.md b/docs/user/BuildWithWSL.md index 752343bbe0..73f1ef17e2 100644 --- a/docs/user/BuildWithWSL.md +++ b/docs/user/BuildWithWSL.md @@ -2,7 +2,7 @@ Windows Subsystem for Linux, or WSL for short is a way for you to mount a Linux-based OS onto your Windows machine, allowing you to build OpenROAD-flow-scripts both locally and via Docker. ## Install WSL -Instructions to install WSL can be found [here](https://learn.microsoft.com/en-us/windows/wsl/install). You may use any kernel supported, such as: Ubuntu 22.04, RHEL 8, RockyLinux 9. +Instructions to install WSL can be found [here](https://learn.microsoft.com/en-us/windows/wsl/install). You may use any kernel supported, such as: Ubuntu 26.04, Ubuntu 24.04, RHEL 8, RockyLinux 9. We recommend that users follow the Docker build by continuing onto the guide below. However, if you wish to install locally, you may follow the build locally instructions [here](./BuildLocally.md). From 98a4631cd79f73cfd19c3c8f6a9f1f14f6eced1e Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 20 Oct 2026 08:53:23 -0300 Subject: [PATCH 05/10] build(installer): install the apt Python packages with -base On Ubuntu 23.04 and later, _installPipSystem ran only when the option was both common and base, so only -all reached it. Dockerfile.dev runs -base and -common as two calls, so the 24.04 and 26.04 images had no pandas, numpy, click, or yaml. These packages come from apt, so install them with the other system packages in -base. Signed-off-by: Vitor Bandeira --- etc/DependencyInstaller.sh | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/etc/DependencyInstaller.sh b/etc/DependencyInstaller.sh index 158742acfa..9eaa6bcbf5 100755 --- a/etc/DependencyInstaller.sh +++ b/etc/DependencyInstaller.sh @@ -721,13 +721,15 @@ case "${os}" in _installCmake fi if [[ $version != "rodete" ]]; then - if [[ "${option}" == "common" || "${option}" == "all" ]]; then - if _versionCompare ${version} -lt 23.04 ; then + if _versionCompare ${version} -lt 23.04 ; then + if [[ "${option}" == "common" || "${option}" == "all" ]]; then _installPipCommon - else - if [[ "${option}" == "base" || "${option}" == "all" ]]; then - _installPipSystem - fi + fi + else + # Python packages come from apt (PEP 668), so they belong + # with the other system packages in -base. + if [[ "${option}" == "base" || "${option}" == "all" ]]; then + _installPipSystem fi fi else From 6dc58463326990c8f55eb2175916e84eb89cb676 Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 20 Oct 2026 08:53:27 -0300 Subject: [PATCH 06/10] build(installer): name the CI Ubuntu releases in the warning Signed-off-by: Vitor Bandeira --- etc/DependencyInstaller.sh | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/etc/DependencyInstaller.sh b/etc/DependencyInstaller.sh index 9eaa6bcbf5..490fb7ab43 100755 --- a/etc/DependencyInstaller.sh +++ b/etc/DependencyInstaller.sh @@ -658,7 +658,7 @@ case "${os}" in "CentOS Linux" | "Red Hat Enterprise Linux"* | "AlmaLinux" | "Rocky Linux") # Enterprise Linux support - dispatch based on specific version if [[ ${CI} == "yes" ]]; then - echo "WARNING: Installing CI dependencies is only supported on Ubuntu 22.04" >&2 + echo "WARNING: Installing CI dependencies is only supported on Ubuntu 24.04 and 26.04" >&2 fi # Detect EL version to choose appropriate functions @@ -738,7 +738,7 @@ case "${os}" in ;; "Darwin" ) if [[ ${CI} == "yes" ]]; then - echo "WARNING: Installing CI dependencies is only supported on Ubuntu 22.04" >&2 + echo "WARNING: Installing CI dependencies is only supported on Ubuntu 24.04 and 26.04" >&2 fi _installORDependencies if [[ "${option}" == "base" || "${option}" == "all" ]]; then From 114238a6c25d79b4f453585f3abef8930a7c95fc Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 20 Oct 2026 08:53:32 -0300 Subject: [PATCH 07/10] docs: fix the Docker threads example and the WSL image break The threads example now selects Ubuntu 26.04 like the main example. A blank line restores the break before the second WSL image. Signed-off-by: Vitor Bandeira --- docs/user/BuildWithDocker.md | 2 +- docs/user/BuildWithWSL.md | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/user/BuildWithDocker.md b/docs/user/BuildWithDocker.md index 04357e719b..78b85e029b 100644 --- a/docs/user/BuildWithDocker.md +++ b/docs/user/BuildWithDocker.md @@ -69,7 +69,7 @@ cd OpenROAD-flow-scripts You can restrict the number of CPUs with the `-t|--threads N` argument: ``` shell -./build_openroad.sh --threads N +./build_openroad.sh --os=ubuntu26.04 --threads N ``` ## Verify Installation diff --git a/docs/user/BuildWithWSL.md b/docs/user/BuildWithWSL.md index 73f1ef17e2..374157946a 100644 --- a/docs/user/BuildWithWSL.md +++ b/docs/user/BuildWithWSL.md @@ -17,11 +17,12 @@ You need to enable the following options to allow WSL to use Docker. General > Use the WSL 2 Based engine (should be default selection) ![WSL1](../images/wsl_1.webp) -Resources > WSL integration > Enable integration with my default WSL distro and select "Ubuntu-22.04", or the distribution you installed. +Resources > WSL integration > Enable integration with my default WSL distro and select "Ubuntu-26.04", or the distribution you installed. + ![WSL2](../images/wsl_2.webp) ## Accessing WSL -You may access WSL from the app named "Ubuntu 22.04 LTS". Run the following: +You may access WSL from the app named "Ubuntu 26.04 LTS". Run the following: ``` sudo apt-get update; sudo apt-get upgrade; sudo apt install -y build-essential python3 python3-venv python3-pip make ``` From 75f39f3cae56bdbf2aef39feb63fb0f69137e780 Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 20 Oct 2026 08:56:24 -0300 Subject: [PATCH 08/10] build(docker): default to Ubuntu 26.04 and drop the 22.04 option Local Docker builds now use Ubuntu 26.04 by default, and Ubuntu 22.04 is no longer an option. The publish and installer-test workflows pass the OS for each matrix entry, and Jenkins builds its images without these scripts, so only local builds change. Signed-off-by: Vitor Bandeira --- build_openroad.sh | 5 ++--- docker/Dockerfile.dev | 2 +- docs/user/BuildWithDocker.md | 4 ++-- etc/DockerHelper.sh | 8 ++------ 4 files changed, 7 insertions(+), 12 deletions(-) diff --git a/build_openroad.sh b/build_openroad.sh index 2a33438e5d..0eef046bd5 100755 --- a/build_openroad.sh +++ b/build_openroad.sh @@ -26,7 +26,7 @@ YOSYS_ARGS="" OPENROAD_APP_USER_ARGS=() OPENROAD_APP_ARGS=() -DOCKER_OS_NAME="ubuntu22.04" +DOCKER_OS_NAME="ubuntu26.04" PROC=-1 WITH_VERIFIC=0 @@ -101,8 +101,7 @@ Options: Options valid only for Docker builds: -c, --copy-platforms Copy platforms to inside docker image. - --os=DOCKER_OS_NAME Use ubuntu22.04 (default), ubuntu24.04 or - ubuntu26.04. + --os=DOCKER_OS_NAME Use ubuntu26.04 (default) or ubuntu24.04. This script builds the OpenROAD tools: openroad, yosys and yosys plugins. By default, the tools will be built from the linked submodule hashes. diff --git a/docker/Dockerfile.dev b/docker/Dockerfile.dev index b92bec521d..df31e072e7 100644 --- a/docker/Dockerfile.dev +++ b/docker/Dockerfile.dev @@ -1,7 +1,7 @@ # create image with dependencies needed to compile openroad app and run openroad flow scripts # NOTE: don't use this file directly unless you know what you are doing, # instead use etc/DockerHelper.sh -ARG fromImage=ubuntu:22.04 +ARG fromImage=ubuntu:26.04 FROM $fromImage diff --git a/docs/user/BuildWithDocker.md b/docs/user/BuildWithDocker.md index 78b85e029b..8a7af11776 100644 --- a/docs/user/BuildWithDocker.md +++ b/docs/user/BuildWithDocker.md @@ -63,13 +63,13 @@ The following instructions build the docker image with Ubuntu 26.04 as the base ``` shell git clone --recursive https://github.com/The-OpenROAD-Project/OpenROAD-flow-scripts cd OpenROAD-flow-scripts -./build_openroad.sh --os=ubuntu26.04 +./build_openroad.sh ``` You can restrict the number of CPUs with the `-t|--threads N` argument: ``` shell -./build_openroad.sh --os=ubuntu26.04 --threads N +./build_openroad.sh --threads N ``` ## Verify Installation diff --git a/etc/DockerHelper.sh b/etc/DockerHelper.sh index d2498cd30c..0576d711af 100755 --- a/etc/DockerHelper.sh +++ b/etc/DockerHelper.sh @@ -21,8 +21,7 @@ usage: $0 [CMD] [OPTIONS] push Push the docker image to Docker Hub OPTIONS: - -os=OS_NAME Use ubuntu22.04 (default), ubuntu24.04 or - ubuntu26.04. + -os=OS_NAME Use ubuntu26.04 (default) or ubuntu24.04. -target=TARGET Choose target for the Docker image: 'dev': os + packages to compile app 'builder': os + packages to compile app + @@ -46,9 +45,6 @@ EOF _setup() { case "${os}" in - "ubuntu22.04") - osBaseImage="ubuntu:22.04" - ;; "ubuntu24.04") osBaseImage="ubuntu:24.04" ;; @@ -190,7 +186,7 @@ if [[ -z $(command -v "${_rule}") ]]; then fi # default values, can be overwritten by command line arguments -os="ubuntu22.04" +os="ubuntu26.04" target="dev" numThreads="-1" tag="" From a143ae553d7d4bcb4fc2ee57587ec52c8445f7e9 Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 20 Oct 2026 08:56:29 -0300 Subject: [PATCH 09/10] docs: match the prebuilt Docker example to the packages The prebuilt binaries page lists Ubuntu 22.04 packages only, so the container for that path must stay on Ubuntu 22.04. Signed-off-by: Vitor Bandeira --- docs/user/BuildWithDocker.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user/BuildWithDocker.md b/docs/user/BuildWithDocker.md index 8a7af11776..0b79b8c45f 100644 --- a/docs/user/BuildWithDocker.md +++ b/docs/user/BuildWithDocker.md @@ -42,7 +42,7 @@ You can start the container in an interactive mode using the command below. ```shell -docker run -it ubuntu:26.04 +docker run -it ubuntu:22.04 ``` Now you are ready to install the prebuilt binaries. From 5175efa21be44acb6b891e9261c751be4eb0b74f Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Sat, 24 Oct 2026 06:04:27 -0300 Subject: [PATCH 10/10] build(installer): list every pinned KLayout Ubuntu release The unsupported-version message listed only 24.04 and 26.04. The code above it still has a 22.04 checksum, so the message did not match the code. Signed-off-by: Vitor Bandeira --- etc/DependencyInstaller.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/etc/DependencyInstaller.sh b/etc/DependencyInstaller.sh index 490fb7ab43..dc3cb17cb3 100755 --- a/etc/DependencyInstaller.sh +++ b/etc/DependencyInstaller.sh @@ -424,7 +424,7 @@ _installUbuntuPackages() { elif [[ $1 == 26.04 ]]; then klayoutChecksum=904f60fd05c3a5029cab8a2840029f49 else - echo "Unsupported Ubuntu version $1. Supported versions: 24.04, 26.04. Please upgrade to a supported LTS release or install KLayout ${klayoutVersion} manually from https://www.klayout.org/build.html" + echo "Unsupported Ubuntu version $1. KLayout ${klayoutVersion} packages are pinned for 22.04, 24.04, and 26.04. Please upgrade to a supported LTS release or install KLayout ${klayoutVersion} manually from https://www.klayout.org/build.html" exit 1 fi wget https://www.klayout.org/downloads/Ubuntu-${1%.*}/klayout_${klayoutVersion}-1_amd64.deb