Install OONI Probe CLI

Once installed, OONI Probe runs tests automatically every day. For details, read the OONI Probe CLI user guide.

Debian / Ubuntu

  1. Install the GPG key:

    sudo apt-get install gnupg ca-certificates
gpg --keyserver hkps://keyserver.ubuntu.com --recv-keys B5A08F01796E7F521861B449372D1FF271F2DD50
gpg --export --armor B5A08F01796E7F521861B449372D1FF271F2DD50 > ooni-apt-keyring.asc
sudo install -D -m 0644 ooni-apt-keyring.asc /etc/apt/keyrings/ooni-apt-keyring.asc

    If you installed OONI Probe with older instructions, also remove the old key with sudo rm -f /etc/apt/keyrings/ooni-apt-keyring.gpg and redo step 2.

  2. You can choose how to fetch OONI Probe:

    A) Using HTTP. This is the recommended option.

    echo "deb [signed-by=/etc/apt/keyrings/ooni-apt-keyring.asc] https://deb.ooni.org/ unstable main" | sudo tee /etc/apt/sources.list.d/ooniprobe.list

    B) Using Tor. This is an alternative option in case the HTTP repository is not reachable. This requires running the tor daemon on your system.

    sudo apt-get install tor apt-transport-tor
echo "deb [signed-by=/etc/apt/keyrings/ooni-apt-keyring.asc] tor+http://deb.ooni.org/ unstable main" | sudo tee /etc/apt/sources.list.d/ooniprobe.list

  3. Finally, update the package list and install OONI Probe

    sudo apt-get update
sudo apt-get install ooniprobe-cli

macOS (Homebrew)

  1. Install Homebrew.

    Follow the instructions at brew.sh.

  2. Install ooniprobe.

    brew install ooniprobe

  3. Start automatic daily run.

    ooniprobe autorun start

← Back to all install options