OoklaServer is our TCP based server daemon that provides standalone testing. The following instructions are for Unix/Linux server platforms.

Download the install script

  1. 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.
  2. Download the script
    • Linux 
      wget https://install.speedtest.net/ooklaserver/ooklaserver.sh
    • OS X 
      curl -O https://install.speedtest.net/ooklaserver/ooklaserver.sh
  3. 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 

You should now be able to use the Server Tester to verify your OoklaServer installation is working properly. For more information on testing your server review our "Using the Server Tester" article. Your OoklaServer URL should use the following format:
 
speedtest.mycompany.com:8080
 
For more information on why OoklaServer testing might fail please review our "Why is OoklaServer testing failing on my server?" article.
 
Once testing passes you can proceed with settings up and submitting your server.

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.
 
4. Start OoklaServer in daemon mode by running the following command:
 
"./OoklaServer –daemon"
 
5. Follow the steps above for "Ensure server daemon starts automatically"
 
6. Following the steps above for "Verify Installation"
 
Note: You can start OoklaServer without the –daemon flag to get log output to the console for troubleshooting.