Looker Startup Options

On this Page
Docs Menu

Listing Startup Options

There are a number of Looker startup settings which may be configured. To see the options available for your version, run the Looker startup script with --help. For example:

-p, --port=<i>                                           Port to run on (default: 9999)
--core-port=<i>                                          Port to run core on (default: 19999)
--daemonize, --no-daemonize                              Run as daemon (default: true)
--ssl, --no-ssl                                          Use SSL (default: true)
--ssl-provided-externally                                DEPRECATED, use --ssl-provided-externally-by instead
--ssl-provided-externally-by=<s>                         Turns off SSL in Looker but requires that the specified proxy provides it
--ssl-keystore=<s>                                       Path to keystore file for SSL
--ssl-keystore-pass-file=<s>                             Path to file containing ssl-keystore password
--ssl-keystore-pass=<s>                                  Password for ssl-keystore file
-h, --hosted                                             Hosted by Looker
--prefer-ipv4                                            Prefer IPv4
--log-level=<s>                                          Log level (default: info)
-r, --root                                               Allow running as root
--marketplace=<s>                                        Running in a Looker marketplace instance
--disable-db-log                                         Disable logging of internal DB queries
--core-on-loopback                                       Expose Core API on loopback interface
--self-signup                                            Allow anyone to create an account for themselves
--lock-out-lookers                                       No longer supported
--task-start-delay=<i>                                   Delay task runner startup (seconds) (default: 60)
--force-error-emails                                     Force Looker to report errors via email
--error-emails-to=<s>                                    Error emails to <email address>
--report-backend-errors, --no-report-backend-errors      Report errors from the backend (default: true)
--report-frontend-errors, --no-report-frontend-errors    Report errors from the frontend (default: true)
--scheduler-threads=<i>                                  Number of simultaneous scheduled tasks (default: 3)
--unlimited-scheduler-threads=<i>                        Number of simultaneous unlimited scheduled tasks (default: 1)
--default-mailer-port=<i>                                Port over which to send mail when using default mailer (default: 587)
--super-max-query-limit                                  Restricted Usage. Elevates the number of max query results
--max-unstreamed-limit=<i>                               Elevates the number of rows allowed for download without streaming (default: 100000)
--concurrent-render-jobs=<i>                             Number of simultaneous phantomjs processes (default: 2)
--ssl-cert=<s>                                           Deprecated. Use --ssl-keystore instead
--ssl-key=<s>                                            Deprecated. Use --ssl-keystore instead
--ssl-ca-cert=<s>                                        Deprecated. Use --ssl-keystore instead
--clustered                                              Whether this sever is part of a cluster
-H, --hostname=<s>                                       Hostname for node-to-node communication
-n, --node-to-node-port=<i>                              Port for node-to-node communication (default: 1551)
-d, --internal-db-creds=<s>                              Path to yaml file with db credentials
--shared-storage-dir=<s>                                 Path to network file system shared storage
--snowplow-host=<s>                                      Extra snowplow collector
--staging                                                Run server as staging
--async-results-cache-time=<i>                           Length of time to keep async results cached (default: 300)
--max-async-threads=<i>                                  Maximum number of async query threads (default: 200)
--dashboard-query-throttle=<i>                           Throttles the number of queries a user can run at once. ONLY USED ON DASHBOARDS FOR NOW!
--per-user-query-limit=<i>                               Limits number of concurrent queries per user (default: 15)
--per-user-query-timeout=<i>                             Length of per-user timeout to wait for connection (default: 600)
--scheduler-query-limit=<i>                              Limits number of concurrent scheduled queries (default: 10)
--scheduler-query-timeout=<i>                            Length of scheduler timeout to wait for connection (default: 1200)
--max-pdt-regen-threads=<i>                              Maximum number of PDT regenerator threads (default: 25)
--force-cdn                                              force enable CDN
--force-no-cdn                                           force disable CDN
--cdn-hosts=<s>                                          comma separated hostnames for cdn pool (default: static-a.lookercdn.com,static-b.lookercdn.com)
--use-custom-jdbc-config                                 Whether to use custom jdbc driver config
--cipher-key-file=<s>                                    Path to file containing cipher key
--new-cipher-key-file=<s>                                Path to file containing new cipher key
--force-cipher-key                                       Disregard safeguards for the cipher key settings
--loose-cipher-key-file                                  Don't require 0600 permissions for cipher key file
--in-memory-cache-size=<i>                               Size (in MB) of in memory cache (default: 50)
--on-disk-cache-size=<i>                                 Size (in MB) of disk cache (default: 2000)
--force-mismatched-internal-db                           Allow use of out-of-sync Looker Internal DB
-q, --queue-broker-port=<i>                              Port for queue broker (default: 61616)
--user-db-credentials                                    Restricted Usage. Connections can use per-user credentials
--public-embed-auth-param-file=<s>                       Authentication param file for public auth
--worker-service-host=<s>                                (Looker internal use only)
--worker-service-port=<i>                                (Looker internal use only)
--worker-admin-port=<i>                                  (Looker internal use only)
--worker-eval                                            (Looker internal use only)
-v, --version                                            Print version and exit
-e, --help                                               Show this message

Credentials File Format

dialect: mysql
database: YOUR_DBNAME

Making Startup Options Permanent

The preferred method for making startup configuration settings permanent is to create a file named lookerstart.cfg in the Looker application directory. This file will be executed by the Looker startup script that was provided with your looker.jar. The lookerstart.cfg file is the recommended place to set environment variables for JAVAARGS and LOOKERARGS because they will not be overwritten when new versions of the looker startup script are installed.

Here is an example lookerstart.cfg which disables Looker’s SSL and sets it to run on port 8080:

LOOKERARGS="--no-ssl --port 8080"

Looker will need to be restarted after making changes to lookerstart.cfg.

Next Step

After you have configured Looker start-up options you’re ready to configure your SSL certificate for proper HTTPS.

Still have questions?
Go to Discourse - or - Email Support