Skip to content

APT Repository Setup

The GetPageSpeed Extras APT repository hosts nginx-module-* packages for supported Debian and Ubuntu releases.

1. Install the APT keyring

Download the repository keyring and place it under /etc/apt/keyrings:

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://extras.getpagespeed.com/deb-archive-keyring.gpg \
  | sudo tee /etc/apt/keyrings/getpagespeed.gpg >/dev/null

2. Add the APT source

You can either use the interactive helper below or copy one of the static examples.

Interactive generator

Select your distribution, codename, and NGINX branch to generate both the sources.list entry and a ready-to-run shell command:

sources.list contents:

Shell command to create file:

Alternative: auto-detect distro and codename

If you prefer a single universal command that works on any supported Debian or Ubuntu system, you can use lsb_release to detect the distribution and codename automatically.

For the stable branch:

distro=$(lsb_release -is | tr '[:upper:]' '[:lower:]')
codename=$(lsb_release -cs)
echo "deb [signed-by=/etc/apt/keyrings/getpagespeed.gpg] https://extras.getpagespeed.com/${distro} ${codename} main" \
  | sudo tee /etc/apt/sources.list.d/getpagespeed-extras.list

For the mainline branch:

echo "deb [signed-by=/etc/apt/keyrings/getpagespeed.gpg] https://extras.getpagespeed.com/${distro} ${codename}-mainline main" \
  | sudo tee -a /etc/apt/sources.list.d/getpagespeed-extras.list

3. Pin GetPageSpeed nginx packages

If you have (or may later add) another nginx source such as the ondrej/nginx PPA or nginx.org packages, create an APT preferences file so that GetPageSpeed packages always take priority:

sudo tee /etc/apt/preferences.d/getpagespeed-nginx.pref > /dev/null <<'EOF'
Package: nginx nginx-common nginx-core nginx-full nginx-extras nginx-light nginx-module-* libnginx-mod-*
Pin: origin extras.getpagespeed.com
Pin-Priority: 1001
EOF

Priority 1001 tells APT to prefer these packages even if it means downgrading or replacing versions from other repositories. The pin is scoped to nginx-related packages only — no other system packages are affected.

Tip

This step is recommended for all installations and required if any other nginx repository is configured on the system.

4. Update and install

After adding the repository and pinning, run:

sudo apt-get update

You can then install modules such as:

sudo apt-get install nginx-module-brotli

Migrating from other nginx repositories

If you already have nginx installed from the ondrej PPA, nginx.org, or stock Debian/Ubuntu packages, follow these steps to switch to GetPageSpeed:

  1. Complete steps 1–3 above (keyring, source, pinning).

  2. Update the package index:

    sudo apt-get update

  3. Replace the existing nginx and install modules in one command:

    sudo apt-get install nginx nginx-module-geoip2

    APT will automatically replace conflicting packages (nginx-core, nginx-common, nginx-full, nginx-extras, nginx-light) with GetPageSpeed's transitional packages that depend on the unified nginx package.

  4. Verify the active source:

    apt-cache policy nginx

    The output should show extras.getpagespeed.com with priority 1001.