Configuration

Basic Options

Base configuration options are set in the .env configuration file in the deployment.

Make sure to generate secure random passwords whenever required.

OptionDefaultDescription
LF_VERSIONLatestLatticeFlow AI GO! version to deploy.
LF_APP_PORT5005Port on which LatticeFlow AI GO! is served.
LF_KEYCLOAK_PORT8080Port on which Keycloak IAM is served.
LF_DB_PASSWORDPassword for the database owner. This is the password that that will be used to configure the DB on the initial setup or during upgrades. Most other operations to the DB will use a tenant user (created by the application) which authenticates with LB_DB_TENANT_PASSWORD for security reasons.
LF_DB_TENANT_PASSWORDPassword for the tenant DB user.
MINIO_ROOT_PASSWORDPassword for the root user of the Minio service.
LF_S3_CLIENT_ACCESS_KEY_IDThe ID of the access key to S3.
LF_S3_CLIENT_SECRET_KEYThe secret key to S3.

Advanced Options

Application

Option

Default

Description

LF_ERROR_MONITORING_ENABLED

True

Flag for enabling/disabling error monitoring. Error monitoring does not leak any PII. LatticeFlow uses

Sentry

LF_JOB_QUEUE_BROKER

redis://latticeflow-assessment-redis:6379

Redis is used as a asynchronous job queue broker. Option to configure job queue broker to use an external Redis database.

Example for connecting to external Redis using secure rediss protocol: LF_JOB_QUEUE_BROKER=rediss://user:[email protected]:6379?ssl_cert_reqs=none.

LF_OFFLINE_MODE

False

Set to True if the deployed machine has no or limited internet connection. This will also disable error monitoring, usage analytics and any other outgoing traffic.

Authentication

The core AI assessment and the user authentication are separate services exposed through separate ports. These can be set by the options LF_ASSESSMENT_PORT and LF_KEYCLOAK_PORT, respectively. Both ports need to be accessible by the end-user. When a user attempts to login, they are redirected from the core service to the authentication service. For this to work, the core service needs to know the address on which the authentication service is exposed to end users. Use the following options to configure this.

Option

Default

Description

LF_OIDC_ALLOW_INSECURE_REDIRECT_URI

False

Set this option to True if the user-facing address of the authentication service is not using HTTPS.

NOTE: This is a security hazard as it exposes authentication details on the network.

LF_KC_EXTERNAL_PORT

8080

The port on which the authentication service is exposed to the end user.

Set this option when the authentication service is accessed on the same HTTP host as the core AI service.

If you have configured the authentication service to run on a different HTTP host, leave this option unset.

LF_KC_URL

http://latticeflow-assessment-keycloak:8080

The URL on which the core service will communicate with the authentication service.

Typically, both services are deployed in a their own network and exposed to the outside world. In this case the communication is done through this network and this option should not be changed.

Change the option if the authentication service is reachable by the core service on a non-standard address.

PostgreSQL Database

PostgreSQL options are controlled by the environment variables listed in the table below.

Option

Default

Description

POSTGRES_USER

latticeflow

Username for Root user.

LF_DB_PASSWORD

See template.

Password for root user POSTGRES_USER.

POSTGRES_DB

POSTGRES_USER

Database name in PostgreSQL. If not provided, it equals POSTGRES_USER.

POSTGRES_HOST

localhost

Host address for PostgreSQL.

By default, PostgreSQL is hosted at: localhost:5432. Adapt if connecting to an external PostgreSQL database.

POSTGRES_PORT

5432

Port for PostgreSQL. Adapt if connecting to an external PostgreSQL database.

LF_DB_TENANT_USER

tenant

Non-root user name.

LF_DB_TENANT_PASSWORD

See template.

Non-root user password.

S3 Object Storage

LatticeFlow AI GO! uses S3-compatible object storage, by default it is shipped with MiniO, but is fully compatible with AWS S3.

OptionDefaultDescription
LF_S3_CLIENT_URLhttp://latticeflow-assessment-minio:9000S3 client URL.
LF_S3_CLIENT_ACCESS_KEY_IDSee template.S3 client access key ID.
LF_S3_CLIENT_SECRET_KEYSee template.S3 client secret key.
LF_S3_CLIENT_BUCKETlatticeflowS3 bucket name that contains all of the application object data.