OpenROAD Docker & Self-Hosted Deployment

GitHub

OpenROAD's unified application implementing an RTL-to-GDS Flow. Documentation at

2,713 stars Verilog 1 file · ~4,558 tokens #cpp#def#eda#gdsii#lef#opendb-database#openroad#rtl
1. Pull Image (DOCKERHUB) docker pull The-OpenROAD-Project/OpenROAD:latest
2. Docker Run (1-Click Launch) docker run -d --name openroad --restart always the-openroad-project/openroad:latest
3. Podman Run podman run -d --name openroad --restart always the-openroad-project/openroad:latest
4. Skopeo Inspect (Zero-Pull Manifest) skopeo inspect docker://docker.io/the-openroad-project/openroad:latest
5. ORAS Pull (OCI Artifact) oras pull the-openroad-project/openroad:latest
Dockerfile 
################################################################################
#                        Install dependencies for dev                          #
################################################################################

# https://github.com/moby/moby/issues/38379#issuecomment-448445652
ARG fromImage=ubuntu:26.04
ARG devImage=dev

FROM $fromImage AS dev

ENV DEBIAN_FRONTEND=noninteractive
ENV TZ=America/Los_Angeles
ENV LANG=C.UTF-8
ENV LC_ALL=C.UTF-8

ARG INSTALLER_ARGS=""

COPY etc/DependencyInstaller.sh /tmp/.
RUN <<EOF
set -e
/tmp/DependencyInstaller.sh -cmake -ci -base
# Bazel is the default build system: this step installs bazelisk plus the
# libxml2 and X11/xcb runtime libraries the Bazel build needs, which on Ubuntu
# 26.04 include the libxml2.so.2 compatibility symlink without which the
# prebuilt LLVM lld cannot load. The -common step below installs the CMake
# dependencies, which stay for the deprecated CMake build. Run this step after
# the first -ci: -ci installs the latest bazelisk, which would replace the
# pinned one.
/tmp/DependencyInstaller.sh -bazel
/tmp/DependencyInstaller.sh -cmake -ci -common -save-deps-prefixes=/etc/openroad_deps_prefixes.txt $INSTALLER_ARGS
if echo "$fromImage" | grep -q "ubuntu"; then
    echo "fromImage contains 'ubuntu' — stripping section from libQt5Core.so"
    strip --remove-section=.note.ABI-tag /usr/lib/x86_64-linux-gnu/libQt5Core.so || true
else
    echo "Skipping strip command as fromImage does not contain 'ubuntu'"
fi
if command -v apt-get >/dev/null 2>&1; then
    rm -rf /var/lib/apt/lists/*
fi
rm -f /tmp/DependencyInstaller.sh
EOF

################################################################################
#                         Build OpenROAD from source                           #
################################################################################

FROM $devImage AS builder

ARG numThreads=NotSet
# Release builds pass the published version, for example
# --build-arg orVersion=2026-09-10. The build context has no .git directory,
# so the Bazel stamp cannot find the version by itself.
ARG orVersion=""

RUN <<EOF
set -e
groupadd user --gid 9000
useradd --create-home --uid 9000 -g user --skel /etc/skel --shell /bin/bash user
EOF

USER user
WORKDIR /OpenROAD
COPY --chown=user:user . .
# Keep Bazel's build cache out of the published builder image.
RUN --mount=type=cache,target=/home/user/.cache,uid=9000,gid=9000 <<EOF
set -e
OPENROAD_VERSION="${orVersion}" \
    bash ./etc/Build.sh -prefix=/OpenROAD/install -threads=${numThreads}
test -x /OpenROAD/install/bin/openroad
# Legacy builder-image path, the CMake binary location. Remove with CMake.
mkdir -p build/bin
ln -s ../../install/bin/openroad build/bin/openroad
rm -f bazel-OpenROAD bazel-bin bazel-out bazel-testlogs
EOF

COPY --chmod=775 --chown=user:user etc/docker-entrypoint.sh /usr/local/bin/.

################################################################################
#                                 Final Image                                  #
################################################################################

FROM $devImage AS final

COPY --chown=root:root --from=builder /OpenROAD/install/ /usr/
ENV OPENROAD_EXE=/usr/bin/openroad

RUN <<EOF
set -e
groupadd user --gid 9000
useradd --create-home --uid 9000 -g user --skel /etc/skel --shell /bin/bash user
EOF

USER user
WORKDIR /home/user

ENTRYPOINT [ "openroad" ]