Settings

Orchest is configured through Settings. Some settings require Orchest to be restarted for changes to take effect. For example:

{
  "AUTH_ENABLED": false,
  "MAX_JOB_RUNS_PARALLELISM": 4,
  "MAX_INTERACTIVE_RUNS_PARALLELISM": 4,
  "TELEMETRY_DISABLED": false,
  "TELEMETRY_UUID": "69b40767-e315-4953-8a2b-355833e344b8"
}
AUTH_ENABLED

Boolean: true or false.

Enables authentication. When enabled, Orchest will require a login. Create user accounts through settings > manage users. Orchest does not yet support individual user sessions, meaning that there is no granularity or security between users.

MAX_JOB_RUNS_PARALLELISM

Integer between: [1, 25].

Controls the number of Job runs that can be run in parallel across all Jobs. For example, if this is set to 3, then only 3 Pipeline runs can run in parallel.

MAX_INTERACTIVE_RUNS_PARALLELISM

Integer between: [1, 25].

Controls the number of interactive runs that can be run in parallel for different Pipelines at a given time. For example, if this is set to 2, then only 2 different Pipelines can have interactive runs at the same time. This is useful when multiple users are using Orchest.

TELEMETRY_DISABLED

Boolean: true or false.

Disables telemetry.

TELEMETRY_UUID

UUID to track usage across user sessions.

Note

💡 We do not use any third-party to track telemetry, see what telemetry we track and how in our codebase. All telemetry is anonymized through the TELEMETRY_UUID. We do not store any IP information on our servers.

Configuring JupyterLab

Extensions

You can install JupyterLab extensions through the JupyterLab UI and these extensions will persist (across interactive sessions) automatically.

JupyterLab also supports server extensions. To install, navigate to Settings > Configure JupyterLab. For example:

pip install jupyterlab-git

You can also install extensions from npm through the jupyter command.

jupyter labextension install jupyterlab-spreadsheet

Note

💡 Building the JupyterLab image will stop all interactive sessions since they are still using the old JupyterLab image.

User settings

User settings that are configured through the JupyterLab GUI, such as your JupyterLab Theme or Text Editor Key Map, are persisted automatically. No additional configuration needed.