The Chromium Project is an open source project started by Google to share the non-proprietary parts of Google Chrome. If your instance is hosted by Looker, this software is already installed.
The Customer-Hosted Installation of Rendering Software documentation page shows how to install Chromium on Ubuntu. This article provides instructions for installing Chromium if you are using a Debian system.
Version and Location
Make sure you install Chromium 65 or later into an executable path on the machine that hosts the Looker instance. The Looker application needs to access Chromium using the
chromium command or via a custom path set with the
CHROMIUM_PATH environment variable.
If you are using a Debian 8 (jessie) Linux system, then you cannot use this feature because Debian 8 only supports up to Chromium version 57. However, Debian 9 (stretch) includes the security updates and latest features, including support for the latest Chromium version.
If you are installing Chromium on a clustered Looker installation, the Chromium version on each node must be fully identical. Even minor differences, such as different build numbers, can prevent the Enhanced Rendering Labs feature from enabling properly.
sudocommand to perform these steps as the Looker user. If you install Chromium while logged in as the root user, Looker might not be able to execute PDF or PNG rendering.
1. On the command line, enter the following command:
apt-get update && apt-get install -y chromium
2. If you are using Docker with a bare-bones Debian install, you will need to install
procps and ensure you are not running as root.
3. After you set any environment variables, you will need to restart the Looker application for them to take effect. You may also need to restart any open terminal sessions, or run
source ~/.bash_profile, to get the terminal to read the new configuration.
4. After installing Chromium, you should get a valid response from either
$CHROMIUM_PATH --version depending on whether you set the environment variable.
Optional Environment Variables
See the Looker Documentation page for some optional environment variables, such as
Additional Contributor: Veronica Phillips