bokeh.settings

Control global configuration options with environment variables.

settings = <bokeh.settings.Settings object>

A global settings object that other parts of Bokeh can refer to.

BOKEH_BROWSER — What browser to use when opening plots.

Valid values are any of the browser names understood by the python standard library webbrowser module.

BOKEH_DEV — Whether to use development mode.

This uses absolute paths to development (non-minified) BokehJS components, sets logging to debug, makes generated HTML and JSON human-readable, etc.

This is a meta variable equivalent to the following environment variables:

  • BOKEH_BROWSER=none
  • BOKEH_LOG_LEVEL=debug
  • BOKEH_MINIFIED=false
  • BOKEH_PRETTY=true
  • BOKEH_PY_LOG_LEVEL=debug
  • BOKEH_RESOURCES=absolute-dev
  • BOKEH_SIMPLE_IDS=true

Accepted values are yes/no, true/false or 0/1.

BOKEH_DOCS_CDN — What version of BokehJS to use when building sphinx
~bokeh.resources.Resources class reference for full details.

BOKEH_DOCS_VERSION — What version of Bokeh to show when building sphinx docs locally.

Useful for re-deployment purposes.

Set to "local" to use a locally built dev version of BokehJS.

Note

This variable is only used when building documentation from the development version.

BOKEH_DOCS_CSS_SERVER — Where to get the CSS stylesheet from.

By default use CSS from bokehplots.com

Note

This variable is only used when building documentation from the development version.

Set to "local" to use a locally built dev version of BokehJS.

BOKEH_DOCS_MISSING_API_KEY_OK — Whether the docs build should fail without GOOGLE_API_KEY set.

By default, set to no, which means the docs build will stop immediately if the GOOGLE_API_KEY environment variable is missing. Set to yes to enable docs builds to proceed (but with non-functional Google Maps examples). Useful for development.

BOKEH_LOG_LEVEL — The BokehJS console logging level to use.

Valid values are, in order of increasing severity:

  • trace
  • debug
  • info
  • warn
  • error
  • fatal

The default logging level is info.

Note

When running server examples, it is the value of this BOKEH_LOG_LEVEL that is set for the server that matters.

BOKEH_MINIFIED — Whether to emit minified JavaScript for bokeh.js.

Accepted values are yes/no, true/false or 0/1.

BOKEH_PRETTY — Whether to emit “pretty printed” JSON.

Accepted values are yes/no, true/false or 0/1.

BOKEH_PY_LOG_LEVEL — The Python logging level to set.

As in the JS side, valid values are, in order of increasing severity:

  • trace
  • debug
  • info
  • warn
  • error
  • fatal
  • none

The default logging level is none.

BOKEH_RESOURCES — What kind of BokehJS resources to configure.

For example: inline, cdn, server. See the Resources class reference for full details.

BOKEH_ROOTDIR — Root directory to use with relative resources.

See the Resources class reference for full details.

BOKEH_SIMPLE_IDS — Whether to generate human-friendly object IDs.

Accepted values are yes/no, true/false or 0/1. Normally Bokeh generates UUIDs for object identifiers. Setting this variable to an affirmative value will result in more friendly simple numeric IDs counting up from 1000.

BOKEH_VERSION — What version of BokehJS to use with cdn resources.

See the Resources class reference for full details.