OoklaServer is our TCP based server daemon that provides standalone testing. The following instructions are for Unix/Linux server platforms.
Download the install script
- Open terminal and navigate to your desired install directory. This directory should not be web accessible. We recommend using a non-root user to download and use this script.
- Download the script
- Linux
wget https://install.speedtest.net/ooklaserver/ooklaserver.sh
- OS X
curl -O https://install.speedtest.net/ooklaserver/ooklaserver.sh
- Linux
- Update script permissions to allow installation
chmod a+x ooklaserver.sh
If you have problems downloading or using the ooklaserver.sh script read the "Manual Installation" section at the end of this article.
Install the server daemon
./ooklaserver.sh install
The script will now automatically detect your server's OS and, after confirming your platform, download the appropriate version of the daemon. Once the daemon is installed, it will start running.
If you have problems downloading or using the ooklaserver.sh script read the "Manual Installation" section at the end of this article.
Note: We recommend installing and running OoklaServer as a non-root user for security purposes.
Ensure server daemon starts automatically
The OoklaServer Daemon can easily be configured to start automatically. CentOS, Fedora, Debian, and most distributions derived from any of the three, all execute a script called rc.local once all system processes have started. Editing this script to include a reference to the OoklaServer Daemon will cause the daemon to start automatically at boot.
CentOS/Fedora based systems:
/etc/rc.d/rc.local
Debian based systems:
/etc/rc.local
If you do not want to run OoklaServer as root (recommended) create a user to run OoklaServer.
Edit rc.local to include the following command to start the OoklaServer Daemon silently in the background. Change "ooklauser" to your non-root user that will run OoklaServer.
su ooklauser -c '/full_path_to_your_Ookla_Server_Daemon/OoklaServer --daemon'
Managing the daemon
To manage the OoklaServer Daemon, the following commands are available:
./ooklaserver.sh start
./ooklaserver.sh restart
./ooklaserver.sh stop
For more information on each command, please view the help prompt by running the following:
./ooklaserver.sh -h
Verify Installation
Manual Installation
Some server owners have issues using the install script due to firewalls or other limiting factors. You may download the OoklaServer files directly.
1. After downloading the files choose the appropriate platform files for your server.
2. You will need to make the OoklaServer binary executable:
chmod a+x OoklaServer
3. The OoklaServer.properties.default file should be renamed to OoklaServer.properties otherwise a built in default configuration will be used.install server: https://support.ookla.com/hc/en-us/articles/234578528-OoklaServer-Installation-Linux-Unix
install ssl: https://www.digitalocean.com/community/tutorials/how-to-use-certbot-standalone-mode-to-retrieve-let-s-encrypt-ssl-certificates-on-ubuntu-16-04