Skip to content

fix: add missing env variables from .env.example and docker compose#984

Merged
lucaseduoli merged 10 commits into
mainfrom
fix/env_vars
Feb 20, 2026
Merged

fix: add missing env variables from .env.example and docker compose#984
lucaseduoli merged 10 commits into
mainfrom
fix/env_vars

Conversation

@lucaseduoli

Copy link
Copy Markdown
Collaborator

This pull request introduces several improvements to configuration management and deployment flexibility for OpenRAG, focusing on environment variable handling, logging, and Helm chart enhancements. The changes make it easier to configure system behavior, pin or synchronize container versions, and securely manage secrets, especially for session management and Langflow integration.

Configuration and Logging Enhancements:

  • Added new environment variables for logging (LOG_FORMAT, LOG_LEVEL, SERVICE_NAME, SESSION_SECRET) and Langflow integration (LANGFLOW_KEY, LANGFLOW_KEY_RETRIES, LANGFLOW_KEY_RETRY_DELAY, LANGFLOW_VERSION) in .env.example and wired them into docker-compose.yml and documentation for easier customization and improved observability. [1] [2] [3]

OpenSearch and Service Configuration:

  • Refactored OpenSearch-related environment variables in .env.example and docker-compose.yml to support overriding host, port, and username, improving flexibility for different deployment environments. [1] [2] [3] [4]

Container Version Management and Documentation:

  • Clarified and improved documentation for container version synchronization and pinning (OPENRAG_VERSION), explaining how the TUI manages container versions versus manual deployment, and updated upgrade instructions for better user guidance. [1] [2] [3]

Helm Chart Improvements and Secret Management:

  • Enhanced the Helm chart to support the new configuration options, including logging, service name, Langflow API key management, and session secret. Added a new Kubernetes secret (backend-secret.yaml) for securely storing the session secret, with auto-generation if not provided. [1] [2] [3] [4] [5]

Summary of Most Important Changes:

1. Configuration and Logging

  • Added environment variables for logging format, level, service name, and session secret to .env.example, docker-compose.yml, and documentation, allowing for more flexible and secure configuration. [1] [2] [3]

2. OpenSearch and Service Environment Variables

  • Refactored OpenSearch environment variables for host, port, and username to be overridable, improving compatibility with diverse deployment setups. [1] [2] [3] [4]

3. Container Version Synchronization and Documentation

  • Updated documentation to clarify how OPENRAG_VERSION is managed by the TUI versus manual deployment, and improved instructions for pinning or synchronizing container versions. [1] [2] [3]

4. Helm Chart and Secret Management

  • Enhanced Helm chart to support new configuration options for backend and Langflow, and introduced a new secret for securely managing the backend session secret with auto-generation capability. [1] [2] [3] [4] [5]

Let me know if you want to discuss how these changes might affect your local development or deployment workflows!

Closes #568

@github-actions

This comment has been minimized.

@aimurphy aimurphy left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for doing this and tackling the docs changes. There are just a few edits/suggestions.

Comment thread docs/docs/get-started/upgrade.mdx Outdated
Comment thread docs/docs/get-started/upgrade.mdx Outdated
Comment thread docs/docs/reference/configuration.mdx Outdated
Comment thread .env.example Outdated
Comment thread docs/docs/reference/configuration.mdx Outdated
Comment thread .env.example Outdated
@lucaseduoli lucaseduoli requested a review from aimurphy February 20, 2026 19:11
@github-actions

This comment has been minimized.

@aimurphy aimurphy left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

approving to unblock, but some of the table rows are duplicated. Please fix before merging.

Comment thread docs/docs/reference/configuration.mdx Outdated
Comment thread docs/docs/reference/configuration.mdx Outdated
@lucaseduoli lucaseduoli merged commit 8b90f95 into main Feb 20, 2026
3 checks passed
@github-actions

github-actions Bot commented Feb 20, 2026

Copy link
Copy Markdown
Contributor

Build successful! ✅
Deploying docs draft.
Deploy successful! View draft

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug 🔴 Something isn't working.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Environment variable reference seems inaccurate

3 participants