User Guide Getting Started Help Center Documentation Community Training
Updating a Looker Instance

Looker strongly advises against using these instructions to roll back to an earlier version of Looker. This can cause serious problems that are tedious and difficult to recover from. Instead, we recommend you restore a backup if you need to go back to an earlier version of Looker.

You will be notified of new Looker releases as they become available. We recommend updating Looker regularly in order to keep current with bug fixes and new features.

If you have a cluster of Looker instances you must update a single node completely before updating the other instances. Read this Community topic for more information.

This update process assumes your Looker instance includes the startup script, which should have been installed as part of the initial Looker installation process.

  1. Download the most recent release of the Looker JAR file as described on this documentation page.
  2. Stop the Looker process from shell, as the looker user:

    sudo su - looker
    cd /home/looker/looker
    ./looker stop
  3. Back up your entire Looker directory, including hidden directories (see Creating and Restoring Backups for more detail).

  4. If you have migrated Looker’s default in-memory database to an external MySQL database, backup that MySQL database.
  5. Rename the JAR file to looker.jar and copy it to the server directory (i.e., /home/looker/looker/looker.jar).
  6. Start the Looker process from the shell as the looker user:

    ./looker start