Google logo

Google Earth Enterprise Documentation Home | Troubleshooting and error messages

Geecheck: test your GEE Server status

Geecheck is a tool that checks the health and status of a GEE Server installation. With GEE 5.1.x, you can use geecheck to run tests and then view the results in a browser-based dashboard. Results are organized into suites of results so that you can quickly review the status of Fusion, GEE Server, as well as see the output of other tests that you write.

You can also run geecheck from the command line. In GEE 4.4 and earlier versions, geecheck runs from the command line only.

How geecheck works

Geecheck is a Python application,, and is installed in the following location:


Access test results from GEE Server Admin console

To access geecheck from GEE Server Admin console:

  1. Go to, replacing myserver and mydomainname with your server and domain.
  2. Sign in with the default credentials:
    • Username: geapacheuser
    • Password: geeadmin

    To reset the username and password:

    sudo /opt/google/gehttpd/bin/htpasswd -c

    /opt/google/gehttpd/conf.d/.htpasswd geapacheuser

  3. Click the Settings icon gear icon and select Diagnostics from the menu to display the Geecheck page.
  4. View the Test Summary and Test Details sections to verify the results of the tests that geecheck ran.

Run the tests again

If you find you need to perform some troubleshooting based on the results of any of your tests and you need to run the tests again to confirm whether you’ve fixed the issue, simply restart GEE Server, then open the Geecheck page again.

Create your own tests

GEE 5.1 includes some basic tests that you can run but geecheck is a framework that lets you easily plug in your own tests and view the results in a browser or on the command line. Tests should be Python unit tests and must be copied to one of the three test subfolders to be run from geecheck:


To get some idea of how you can write your own test, you can study the structure of the sample test,, provided in the user_tests subfolder. Use the code as a guide or simply copy and edit it if you are unfamiliar with Python unit tests.

Run geecheck on the command line

You can run from the command line with options to exclude tests and specify the output. The default settings includes all tests and output text.

Exclude tests:

Specify format:

For example, to output results in JSON format, excluding /user_tests:

$ /opt/google/gehttpd/cgi-bin python --no_user_tests json

Run geecheck in a browser

To provide browser-based output, geecheck uses a wrapper: /opt/google/gehttpd/cgi-bin/, which runs the script and makes the output available to browsers here: http://MY_SERVER/cgi-bin/

The JSON response is used with the following page to make those results readable: http://MY_SERVER/admin/geecheck.html, which is the page that displays from the Diagnostics selection in the Settings menu icon gear icon of the GEE Server Admin console.

About moving tests

You may want to run geecheck from a different location, for example, if you’ve already created a large number of tests in a different directory. Geecheck can be run successfully from a different location with a few simple rules:

  1. You can move geecheck_tests but you need to maintain the subfolder structure for geecheck to run:


  2. and must be moved with geecheck_tests/:


  • looks for test scripts to run. It should not be moved. Once test scripts have been moved, should be run:

    $ ./

    This action updates the configuration found at /opt/google/geecheck/conf, which tells where to look for tests.