Skip to content
Switch branches/tags
This branch is 9 commits ahead, 5 commits behind WPO-Foundation/wptagent-install:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Automated scripts for installing dedicated wptagent agents

For the script, there are several environment variables that can control the options:


WPT_SERVER="" WPT_LOCATION="Dulles" WPT_KEY="xxxSomeSecretKeyxxx" DISABLE_IPV6=y WPT_OPERA=y WPT_VIVALDI=y bash <(curl -s

Location config (these will prompt if not specified and not installing for cloud):

  • WPT_SERVER - WebPageTest server. i.e. WPT_SERVER=""
  • WPT_LOCATION - Location ID for the agent. i.e. WPT_LOCATION="Dulles"
  • WPT_KEY - Key for the location


  • WPT_CLOUD - blank (default) for no cloud. "ec2" or "gce" to get config dynamically from user data in Google or Amazon cloud.
  • AGENT_MODE - "desktop" (default), "ios" or "android".
  • WPT_UPDATE_AGENT - "y" (default) or "n" : automatically update the agent from GitHub's release branch hourly and Lighthouse daily.
  • WPT_BRANCH - "release" (default) : specify Github branch to sync


  • DISABLE_IPV6 - "y" or "n" (default) : disable IPv6 networking (recommended for systems without IPv6 connectivity).
  • WPT_UPDATE_OS - "y" (default) or "n" : Automatically apt dist-upgrade all packages daily after reboot.
  • WPT_UPDATE_OS_NOW - "y" (default) or "n" : apt dist-upgrade all packages as part of the initial agent setup.


  • WPT_UPDATE_BROWSERS - "y" (default) or "n" : Re-install the certificates for browser installers daily so they stay up to date and automatically update the browsers daily.
  • WPT_CHROME - "y" (default) or "n" : Install Google Chrome (stable, beta and dev channels)
  • WPT_FIREFOX - "y" (default) or "n" : Install Mozilla Firefox (Stable, ESR and Nightly)
  • WPT_EDGE - "y" (default) or "n" : Install Microsoft Edge (Dev)
  • WPT_BRAVE - "y" (default) or "n" : Install The Brave Browser (stable, beta and dev channels)
  • WPT_EPIPHANY - "y" (default) or "n" : Install Epiphany for WebKit testing (Requires Ubunto 20.04+)
  • WPT_OPERA - "y" or "n" (default) : Install Opera (stable, beta and dev channels)
  • WPT_VIVALDI - "y" or "n" (default) : Install Vivaldi


  • WPT_INTERACTIVE = "y" or "n" (default) : Install in a shared OS environment. "y" will expect to take over the whole machine, configure watchdog, cron, etc. "n" can be used for development installs (and will default to the master branch).

For convenience, the github url is also available shortened as

WPT_SERVER="" WPT_LOCATION="Dulles" WPT_KEY="xxxSomeSecretKeyxxx" DISABLE_IPV6=y WPT_OPERA=y WPT_VIVALDI=y bash <(curl -sL

Ubuntu 18.04+:

Tested on 18.04 LTS and 20.04 LTS

bash <(curl -s

on Google Cloud:

WPT_CLOUD=gce bash <(curl -s

on Amazon EC2:

WPT_CLOUD=ec2 bash <(curl -s

Raspberry Pi (Raspbian Stretch+):

Requires editing ~/ after install to configure tethering and traffic shaping.

Desktop testing works best with Raspbian Buster or later.

Warning: This takes a LONG time (several hours). For multiple devices it is generally best to get one configured and then just clone the SD card for other devices.

bash <(curl -s


Tested on MacOS 11 (x86 and ARM)

  • Configure MacOS to log in automatically (System Preferences->Users and Groups->Login Options)
  • Turn off the screen saver and configure power management to never put the display to sleep
  • Install Xcode manually from the app store. Launch it and accept the license.
    • If running on an M1 device, install rosetta when prompted (after accepting the license)
  • Run the agent install script from a Terminal shell:
bash <(curl -s
  • The install script should install all of the browsers and prompt for the necessary system permissions.
  • Configure the agent and watchdog to start automatically at startup.
    • System Preferences->Users and Groups->Login Items
    • Add ~/wptagent-install/macos/Agent and Watchdog
  • Reboot

Dev Setup on Ubuntu Desktop (18.04 LTS recommended)

Will not configure X, watchdog, cron or a startup script. There will be a master branch checkout in ~/wptagent/ and a script to run the agent at ~/

WPT_INTERACTIVE="y" bash <(curl -sL


Automated scripts for installing dedicated wptagent instances







No releases published