Updated files to use load_dotenv

src/tui/managers/container_manager.py

@@ -125,27 +125,28 @@ class ContainerManager:
     def _get_env_from_file(self) -> Dict[str, str]:
         """Read environment variables from .env file, prioritizing file values over os.environ.
         
+        Uses python-dotenv's load_dotenv() for standard .env file parsing, which handles:
+        - Quoted values (single and double quotes)
+        - Variable expansion (${VAR})
+        - Multiline values
+        - Escaped characters
+        - Comments
+        
         This ensures Docker Compose commands use the latest values from .env file,
         even if os.environ has stale values.
         """
+        from dotenv import load_dotenv
+        
         env = dict(os.environ)  # Start with current environment
         env_file = Path(".env")
         
         if env_file.exists():
             try:
-                from ..utils.validation import sanitize_env_value
+                # Load .env file with override=True to ensure file values take precedence
-                with open(env_file, "r") as f:
+                # This loads into os.environ, then we copy to our dict
-                    for line in f:
+                load_dotenv(dotenv_path=env_file, override=True)
-                        line = line.strip()
+                # Update our dict with all environment variables (including those from .env)
-                        if not line or line.startswith("#"):
+                env.update(os.environ)
-                            continue
-                        if "=" in line:
-                            key, value = line.split("=", 1)
-                            key = key.strip()
-                            value = sanitize_env_value(value)
-                            # Override os.environ with .env file values
-                            # This ensures Docker Compose uses the latest .env values
-                            env[key] = value
             except Exception as e:
                 logger.debug(f"Error reading .env file for Docker Compose: {e}")
         

src/tui/managers/env_manager.py

@@ -1,5 +1,6 @@
 """Environment configuration manager for OpenRAG TUI."""
 
+import os
 import secrets
 import string
 from dataclasses import dataclass, field
@@ -7,10 +8,9 @@ from datetime import datetime
 from pathlib import Path
 from typing import Dict, List, Optional
 
+from dotenv import load_dotenv
 from utils.logging_config import get_logger
 
-logger = get_logger(__name__)
-
 from ..utils.validation import (
     sanitize_env_value,
     validate_documents_paths,
@@ -20,6 +20,8 @@ from ..utils.validation import (
     validate_url,
 )
 
+logger = get_logger(__name__)
+
 
 @dataclass
 class EnvConfig:
@@ -119,9 +121,15 @@ class EnvManager:
         return f"'{escaped_value}'"
 
     def load_existing_env(self) -> bool:
-        """Load existing .env file if it exists, or fall back to environment variables."""
+        """Load existing .env file if it exists, or fall back to environment variables.
-        import os
         
+        Uses python-dotenv's load_dotenv() for standard .env file parsing, which handles:
+        - Quoted values (single and double quotes)
+        - Variable expansion (${VAR})
+        - Multiline values
+        - Escaped characters
+        - Comments
+        """
         # Map env vars to config attributes
         # These are environment variable names, not actual secrets
         attr_map = {  # pragma: allowlist secret
@@ -158,36 +166,23 @@ class EnvManager:
         
         loaded_from_file = False
         
-        # Try to load from .env file first
+        # Load .env file using python-dotenv for standard parsing
+        # override=True ensures .env file values take precedence over existing environment variables
         if self.env_file.exists():
             try:
-                with open(self.env_file, "r") as f:
+                # Load .env file with override=True to ensure file values take precedence
-                    for line in f:
+                load_dotenv(dotenv_path=self.env_file, override=True)
-                        line = line.strip()
-                        if not line or line.startswith("#"):
-                            continue
-
-                        if "=" in line:
-                            key, value = line.split("=", 1)
-                            key = key.strip()
-                            value = sanitize_env_value(value)
-
-                            if key in attr_map:
-                                setattr(self.config, attr_map[key], value)
-
                 loaded_from_file = True
-
+                logger.debug(f"Loaded .env file from {self.env_file}")
             except Exception as e:
                 logger.error("Error loading .env file", error=str(e))
         
-        # Fall back to environment variables if .env file doesn't exist or failed to load
+        # Map environment variables to config attributes
-        if not loaded_from_file:
+        # This works whether values came from .env file or existing environment variables
-            logger.info("No .env file found, loading from environment variables")
+        for env_key, attr_name in attr_map.items():
-            for env_key, attr_name in attr_map.items():
+            value = os.environ.get(env_key, "")
-                value = os.environ.get(env_key, "")
+            if value:
-                if value:
+                setattr(self.config, attr_name, value)
-                    setattr(self.config, attr_name, value)
-            return True
         
         return loaded_from_file
 
@@ -546,6 +541,7 @@ class EnvManager:
         """Ensure OPENRAG_VERSION is set in .env file to match TUI version."""
         try:
             from ..utils.version_check import get_current_version
+            import os
             current_version = get_current_version()
             if current_version == "unknown":
                 return

src/tui/screens/welcome.py

@@ -41,7 +41,8 @@ class WelcomeScreen(Screen):
         self.has_env_file = self.env_manager.env_file.exists()
 
         # Load .env file if it exists
-        load_dotenv()
+        # override=True ensures .env file values take precedence over existing environment variables
+        load_dotenv(override=True)
 
         # Check OAuth config immediately
         self.has_oauth_config = bool(os.getenv("GOOGLE_OAUTH_CLIENT_ID")) or bool(