Install and update Chromium for Linux

  • Latest Dynatrace
  • How-to guide
  • Published Sep 10, 2025

If the web UI–guided installation fails or you prefer to prepare the host for the Synthetic engine yourself, you can install Chromium and other dependencies manually or from a custom repository.

Install Chromium and dependencies manually from S3

This section is not relevant for browserless locations.

Amazon Linux 2023, Ubuntu 24, and Oracle Linux 9

Manual installation isn't supported for Amazon Linux 2023, Ubuntu 24, or Oracle Linux 9. For those operating systems, follow the steps in the Install a Synthetic-enabled ActiveGate section to ensure compatibility. Amazon Linux 2023, Ubuntu 24, and Oracle Linux 9 use Chrome for Testing instead of Chromium. The browser is updated by the Synthetic installer. Chrome for Testing doesn't require a package manager, however the dependencies required by the browser are managed by a package manager.

Ensure that you can connect to https://synthetic-packages.s3.amazonaws.com to access Chromium and dependencies. For security reasons, public access to the S3 bucket is enabled only for specific files; trying anything else will result in a 403 error.

Also see Install Chromium from a custom repository below.

See how to update Chromium manually. We strongly recommend that you keep your Linux-based Synthetic-enabled ActiveGates and Chromium versions updated—Dynatrace supports Chromium versions that are no more than two versions behind the latest Dynatrace-supported version for a specific ActiveGate release.

Ubuntu Server

  1. Install Synthetic engine dependencies:

    Synthetic engine dependencies:

    sudo apt-get update && sudo apt-get -y install xvfb x11-xkb-utils xfonts-100dpi xfonts-75dpi xfonts-scalable libnss3-tools auditd

    Chromium dependencies:

    sudo apt-get -y install fonts-dejavu-core
    sudo snap install gnome-3-38-2004 gtk-common-themes
  2. Download and install Chromium.

    • Download the snap (Ubuntu 20.04 and 22.04) package archive. This is a safe and verified archive hosted by Dynatrace.

      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-138.0.7204.100-3199.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-137.0.7151.103-3169.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-136.0.7103.59-3121.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-135.0.7049.95-3110.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-134.0.6998.35-3060.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-132.0.6834.159-3036.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-131.0.6778.85-3002.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-130.0.6723.69-2985.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-129.0.6668.89-2965.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-128.0.6613.113-2940.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-128.0.6613.113-2940.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-126.0.6478.126-2897.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-125.0.6422.60-2859.tgz
      Ubuntu 20.04 and 22.04
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-125.0.6422.60-2859.tgz

      You can verify the authenticity of the packages using the signature files stored together with the package archives.

    • Extract the installation packages. Go to the directory where you saved the archive and run the following command:

      mkdir /tmp/chromium ; tar xzf chromium.tgz -C /tmp/chromium

      This creates a /tmp/chromium directory and extracts the packages into it.

    • Install the extracted packages.

      sudo chown -R root:root /tmp/snap-private-tmp
      sudo snap ack /tmp/chromium/chromium.assert
      sudo snap install --devmode /tmp/chromium/chromium.snap

      Substitute dtuserag with the names of the ActiveGate service user and group if they differ from the default values.

      sudo chown -R dtuserag:dtuserag /tmp/snap-private-tmp

      This installs all the packages extracted to the /tmp/chromium/ directory. You can delete the /tmp/chromium/ directory and the downloaded chromium.tgz archive after successful Chromium installation.

  3. After you satisfy the dependencies, run the ActiveGate installer with root rights with the --enable-synthetic parameter set to manual. For example:

    /bin/bash ./Dynatrace-ActiveGate-Linux.sh --enable-synthetic=manual

Red Hat Enterprise Linux, Oracle Linux, and Rocky Linux

  • Chromium development for Red Hat/CentOS 7 and Amazon Linux 2 stopped at version 126.
  • Chromium installation when a proxy is required for internet access.
    • If you need to download and install Chromium, and your system requires a proxy for internet access, you should configure curlto use the correct proxy. Specify your proxy and port details by running the commands as in this example:
      vi /root/.curlrc
      proxy=http://proxy.example.com:8080
  1. Set up repositories and install dependencies.

    Deprecated operating system: ActiveGate version 1.305 is the last Synthetic-enabled ActiveGate to support Red Hat 7.

    • Register the Red Hat instance.
      sudo subscription-manager register --auto-attach
    • Enable the Red Hat Extras and Optional repositories as well as EPEL (Extra Packages for Enterprise Linux ).
      sudo subscription-manager repos --enable rhel-7-server-extras-rpms
      sudo subscription-manager repos --enable rhel-7-server-optional-rpms
      sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
    • Install Synthetic engine dependencies.
      sudo yum install -y xorg-x11-server-Xvfb xorg-x11-xkb-utils xorg-x11-server-utils xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 libwayland-server mesa-libgbm curl nss-tools
  2. Download and install Chromium.

    • Download the rpm package archive. This is a safe and verified archive hosted by Dynatrace.

      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-138.0.7204.100-1.el9.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-137.0.7151.103-1.el9.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-136.0.7103.59-1.el9.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-135.0.7049.95-1.el9.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-133.0.6943.141-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-134.0.6998.35-1.el9.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-132.0.6834.159-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-132.0.6834.159-1.el9.tgz
      Amazon Linux 2
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-126.0.6478.114-1.el7.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-131.0.6778.204-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-131.0.6778.204-1.el9.tgz
      Red Hat Enterprise Linux/CentOS 7, Amazon Linux 2
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-126.0.6478.114-1.el7.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-130.0.6723.69-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-130.0.6723.116-1.el9.tgz
      Red Hat Enterprise Linux/CentOS 7, Amazon Linux 2
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-126.0.6478.114-1.el7.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-129.0.6668.89-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9

      Requires Chromium 130, previous version 129.0.6668.89-1.el9 cannot be installed anymore, please refer to troubleshooting guide for details.

      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-130.0.6723.116-1.el9.tgz
      Red Hat Enterprise Linux/CentOS 7, Amazon Linux 2
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-126.0.6478.114-1.el7.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-128.0.6613.119-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9

      Requires Chromium 130, previous version 128.0.6613.119-1.el9 cannot be installed anymore, please refer to troubleshooting guide for details.

      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-130.0.6723.116-1.el9.tgz
      Red Hat Enterprise Linux/CentOS 7, Amazon Linux 2
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-126.0.6478.114-1.el7.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-127.0.6533.88-2.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9

      Requires Chromium 130, previous version 127.0.6533.88-2.el9 cannot be installed anymore, please refer to troubleshooting guide for details.

      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-130.0.6723.116-1.el9.tgz
      Red Hat Enterprise Linux/CentOS 7, Amazon Linux 2
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-126.0.6478.114-1.el7.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-126.0.6478.126-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9

      Requires Chromium 130, previous version 126.0.6478.126-1.el9 cannot be installed anymore, please refer to troubleshooting guide for details.

      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-130.0.6723.116-1.el9.tgz
      Red Hat Enterprise Linux/CentOS 7, Amazon Linux 2
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-125.0.6422.141-1.el7.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-125.0.6422.141-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9

      Requires Chromium 130, previous version 125.0.6422.141-1.el9 cannot be installed anymore, please refer to troubleshooting guide for details.

      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-130.0.6723.116-1.el9.tgz
      Red Hat Enterprise Linux/CentOS 7, Amazon Linux 2
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-125.0.6422.141-1.el7.tgz
      Red Hat Enterprise Linux/Oracle/Rocky Linux 8
      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-125.0.6422.141-1.el8.tgz
      Red Hat Enterprise Linux/Rocky Linux 9

      Requires Chromium 130, previous version 125.0.6422.141-1.el9 cannot be installed anymore, please refer to troubleshooting guide for details.

      curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-130.0.6723.116-1.el9.tgz

      You can verify the authenticity of the packages using the signature files stored together with the package archives.

    • Extract the installation packages. Go to the directory where you saved the archive and run the following command:

      mkdir /tmp/chromium ; tar xzf chromium.tgz -C /tmp/chromium

      This creates a /tmp/chromium directory and extract the packages into it.

    • Install extracted packages.

      sudo yum install -y /tmp/chromium/*.rpm

      This installs all the packages extracted to the /tmp/chromium/ directory. You can delete the /tmp/chromium/ directory and the downloaded chromium.tgz archive after successful Chromium installation.

  3. Disable automatic update of Chromium packages:

    sudo yum -y install yum-plugin-versionlock
    sudo yum versionlock chromium
    sudo yum versionlock chromium-common
  4. optional Install non-Latin TrueType fonts:

    sudo yum install dejavu-fonts-common.noarch dejavu-sans-fonts.noarch
  5. After you satisfy the dependencies, run the ActiveGate installer with root rights with the --enable-synthetic parameter set to manual. For example:

    /bin/bash ./Dynatrace-ActiveGate-Linux.sh --enable-synthetic=manual

Update Chromium manually from S3

You might want to update Chromium and dependencies manually if you have an offline environment. If you've installed an ActiveGate manually, say, for manual dependency management because of constraints in accessing the Amazon S3 service, you'll want to update Chromium manually.

You need to update Chromium manually per ActiveGate, and the process varies slightly based on the operating system. Note that manual update of Chromium only applies to Linux-based ActiveGates; on Windows-based ActiveGates, Chromium is automatically updated during Synthetic engine updates.

Prerequisites:

  • Ensure that Enable Chromium auto-update is turned off for your private location. If you disable autoupdate for a location, you need to update Chromium manually on every ActiveGate assigned to that location.
  • Ensure that you can connect to https://synthetic-packages.s3.amazonaws.com to access Chromium and dependencies.
  • The Synthetic engine will use the new Chromium version after the update is complete—note that the status is updated once every hour, so it may take up to an hour to refresh the Chromium version displayed for your ActiveGate in Deployment Status.
  • We strongly recommend that you keep your ActiveGates and Chromium versions updated—Dynatrace supports Chromium versions that are no more than two versions behind the latest Dynatrace-supported version for a specific ActiveGate release.
  • We strongly recommend updating all ActiveGates per location to the same version.
  • See also Chromium autoupdate from a custom repository.
  1. If your ActiveGate and Chromium versions haven't been updated in a while, you might want to check and install Synthetic engine and Chromium dependencies again. See the manual installation instructions for Ubuntu Server.

  2. Download the snap (Ubuntu 20.04 and 22.04) package archive. This is a safe and verified archive hosted by Dynatrace at https://synthetic-packages.s3.amazonaws.com. Be sure to use the specific command provided for your ActiveGate and Ubuntu Server versions in the manual installation instructions for Ubuntu Server.

  3. Extract and install the downloaded packages. Be sure to use the correct installation command for your Ubuntu Server version (check the manual installation instructions for Ubuntu Server).

  4. Verify Chromium update by running the following command from the default installation directory. Command output should match the Chromium version you installed.

    /opt/dynatrace/synthetic/browser --version

Install Chromium from a custom repository

ActiveGate version 1.243+ In addition to web UI-guided ActiveGate installation and manual installation of Chromium and dependencies, you can also install ActiveGate by pointing to a custom, local repository for Chromium components. As this repository is an HTTP server that you set up within your network, the advantage of this method is that it can be used in environments with intranet-only or limited network access.

This method of installing Chromium broadly consists of:

  • Downloading the required Dynatrace-hosted deb, snap, or rpm package archives and their corresponding signature files.
  • Installing and running a locally hosted web server where the downloaded Chromium components reside.
  • Downloading and running the ActiveGate installer on the target host with an environment variable pointing to the location of the custom repository on the HTTP server.
  • A custom Chromium repository can be used only for Chromium components, not their dependencies. Installing Chromium from a custom repository will only work if all dependencies have been resolved before installation.
  • Custom repositories can only be used for Chromium installation and autoupdate—see Chromium autoupdate from a custom repository for details.
  1. Download the Chromium components—the package archive and signature file—from the safe and verified archive hosted by Dynatrace. See Requirements for private Synthetic locations for links to the latest supported and provided Chromium versions.

    We recommend keeping your Linux-based Synthetic-enabled ActiveGates and Chromium versions up to date; choose the latest provided Chromium version for ActiveGate.

    For example, for ActiveGate version 1.255 on Ubuntu 22. the required files are:

    • Package archive—https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-107.0.5304.87-2168.tgz
    • Signature file—https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-107.0.5304.87-2168.tgz.sig

    The corresponding download commands are:

    curl -o chromium-107.0.5304.87-2168.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-107.0.5304.87-2168.tgz
    curl -o chromium-107.0.5304.87-2168.tgz.sig https://synthetic-packages.s3.amazonaws.com/Chromium/snap/chromium-107.0.5304.87-2168.tgz.sig
  2. Install a web server of your choice and create a directory, for example, chromium-repo, to serve the Chromium components to the ActiveGate host. Copy the downloaded Chromium components to this directory.

  3. Download the ActiveGate installer from Dynatrace Hub.

  4. Resolve all dependencies and enable repositories as required as shown in Install Chromium and dependencies manually from S3 above. The custom repository can be used only for Chromium packages, not their dependencies.

  5. Install the ActiveGate with the Synthetic module enabled (--enable-synthetic) and the DYNATRACE_SYNTHETIC_CUSTOM_CHROMIUM_REPO environment variable pointing to the location of the custom repository (https://172.18.0.100/chromium-repo in this example).

    sudo DYNATRACE_SYNTHETIC_CUSTOM_CHROMIUM_REPO=http://172.18.0.100:8000/chromium-repo /bin/bash Dynatrace-ActiveGate-Linux-x86-1.257.0.20221129-155835.sh --enable-synthetic

    You can use the hostname of the HTTP server instead of the IP address so long as the ActiveGate host can resolve the hostname.

Once you've installed Chromium in this way from a custom repository, it can only be autoupdated. See Chromium autoupdate from a custom repository for details and update alternatives.

Chromium autoupdate from a custom repository

If you've enabled a custom, local repository for Chromium installation, Chromium can only be autoupdated. Follow this procedure to autoupdate Chromium via the same custom repository.

  1. After ActiveGate installation, specify the custom repository of the ActiveGate in the [synthetic] section of the custom.properties file in the /var/lib/dynatrace/gateway/config directory. This allows for automatic Chromium updates from the custom repository during manual or automatic Synthetic engine updates.

    [synthetic]
    chromium_repo = https://172.18.0.100/chromium-repo
  2. Turn on Enable Chromium auto-update for your private location.

    Note that the Chromium autoupdate UI setting applies to all ActiveGates assigned to your private location.

  3. Ensure that the Chromium components required for update are available at the custom repository location. Chromium is then automatically updated from the custom repository during ActiveGate and Synthetic engine updates.

Chromium autoupdate option

If you do not specify the custom repository in custom.properties, Chromium is downloaded and updated from S3 during a manual or automatic ActiveGate and Synthetic engine update.

Custom Chromium version

You can install a custom Chromium version, that is, override the Chromium version that the ActiveGate installer looks for. This is applicable for manual ActiveGate installation, as described in Chromium installation via S3 or via a custom repository.

In this command for manual ActiveGate installation via S3, an environment variable points to an explicit Chromium version number 107.0.5304.87-2168, which is part of the package archive for Ubuntu 20 or 22.

sudo /bin/bash -c "export DYNATRACE_SYNTHETIC_EXPLICIT_CHROMIUM_VERSION=107.0.5304.87-2168; /bin/bash Dynatrace-ActiveGate-Linux-x86-1.257.0.20221129-155835.sh --enable-synthetic"

This command searches for the Chromium version 107.0.5304.87-2168 in the custom repository https://172.18.0.100/chromium-repo.

sudo DYNATRACE_SYNTHETIC_EXPLICIT_CHROMIUM_VERSION=107.0.5304.87-2168 DYNATRACE_SYNTHETIC_CUSTOM_CHROMIUM_REPO=http://172.18.0.100:8000/chromium-repo /bin/bash Dynatrace-ActiveGate-Linux-x86-1.257.0.20221129-155835.sh --enable-synthetic
Related tags
Digital Experience