User Guide Getting Started Help Center Documentation Community Training
Looker
  
English
Français
Deutsch
日本語
Downloading the Looker JAR File

You must download the Looker JAR file in order to install or upgrade the Looker application for a customer-hosted deployment. This page describes two methods for downloading the Looker JAR file:

  1. Using the Download Looker JAR file webpage
  2. Calling the API

Before you can download the JAR file, you must accept an End User License Agreement (EULA), which is available on the Download Looker JAR file webpage using the specifications below. Each user downloading the JAR file must accept this EULA; however, each user only needs to accept each version of the EULA once.

Using the Download Looker JAR file Webpage

You can access the Download Looker JAR file webpage at this link: https://download.looker.com/validate:

You will need to enter:

  1. Your Looker license number.
  2. Your email address. This must be a privately hosted email domain.
  3. The JAR file version you would like to download. If you select Latest Version, you will download the latest version of the Looker JAR file for the current Looker release. If you select Specific Version, you will need to enter the Looker JAR version filename exactly.

The naming convention of JAR files for each release includes the . in the version number and follows a set pattern. For example, the JAR filename for Looker 5.20 is looker-5.20-latest.jar.

After you enter this information, click Get Download.

If you have not already accepted the EULA, a EULA Acceptance form will appear. Click Read Terms and Conditions to view the EULA in its entirety. Then, enter your First Name and Last Name and check the check box next to I agree to the Terms and Conditions.

After you enter this information, click Get Download:

Click the green Get Download button to download the Looker JAR file. This link expires after 10 minutes. If the link expires, you can restart the download process.

Calling the API

Before you can download the JAR file by calling the API, you must first accept the EULA through the Download Looker JAR file webpage.

You can then make the necessary API call by making a POST request to the HTTPS endpoint with any desired method — JavaScript, Java, Ruby, shell command, etc. For any of these requests to work, you must use the POST method to send the API payload to https://apidownload.looker.com/download. The API payload must contain values for lic, email, and latest.

The latest property denotes the version of the Looker JAR. If you want to download the latest version of the JAR file for the current Looker release (looker-latest.jar), specifying “latest” is sufficient. If you want to download a specific version, set latest to “specific” and include another key-value pair within the API payload called specific with the desired filename as the value.

Here are two examples of making a request written in ES6 (JavaScript). To request the latest JAR version:

    axios({
        url: "https://apidownload.looker.com/download",
        method: "post",
        data: {
            lic: "YOUR-LOOK-ERLI-CENS-EKEY",
            email: "contact@email.com",
            latest: "latest"
        }
    }).then(function (response) {
        console.log(response.data);
    })

To request a specific JAR version (for example, Looker 5.20):

        data: {
            lic: "YOUR-LOOK-ERLI-CENS-EKEY",
            email: "contact@email.com",
            latest: "specific",
            specific: "looker-5.20-latest.jar"
        }

Here are two example shell commands for making POST requests to the HTTPS endpoint.

To request a specific JAR version using the wget command (for example, Looker 5.24):

wget -O- --header=Content-Type:application/json \
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific", \
"specific":"looker-5.24-latest.jar"}' \
"https://apidownload.looker.com/download"

To request the latest JAR version using the curl command:

curl -i -X POST -H 'Content-Type: application/json' \
-d '{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"latest"}' \
https://apidownload.looker.com/download

Alternatively, if you have jq and wget installed, you can use the shell command examples below.

To request the latest JAR version using the wget command:

wget -O "looker-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json' \
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"} \
"https://apidownload.looker.com/download | jq .url -r)"

You can also download other versions of the JAR by setting LOOKER_VERSION to latest, 6.10-latest, or another supported version in the example one-line command below. For example, to request Looker 6.10:

export LOOKER_VERSION="6.10-latest"

wget -O "looker$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H 'Content-Type: application/json' \
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"specific\", \
\"specific\":\"looker-$(LOOKER_VERSION).jar\"} "https://apidownload.looker.com/download | jq .url -r)"

A successful response will contain both the URL of the download and an MD5 hash of the JAR.

API payload errors, such as missing or mistyped input parameters, will result in an “Invalid request body” response. Providing an incorrect license key or omitting a specific value when requesting a specific version will result in an “Invalid Request” response.

Additionally, if you have not previously accepted the latest EULA, the response will contain three fields: eulaMessage, eulaText, and eulaNeeded. The eulaMessage will indicate that the user must first accept the EULA via the Download Looker JAR file webpage before the API will return a download URL.

Top