fix(utils.py): add helpful log message, directing to use of LITELLM_MIGRATION_DIR

krrishdholakia · krrishdholakia · commit 6b2039f4d7a5 · 2025-08-21T16:41:21.000-07:00
diff --git a/litellm-proxy-extras/litellm_proxy_extras/utils.py b/litellm-proxy-extras/litellm_proxy_extras/utils.py
@@ -298,7 +298,7 @@ def setup_database(use_migrate: bool = False) -> bool:
                             and "database schema is not empty" in e.stderr
                         ):
                             logger.info(
-                                "Database schema is not empty, creating baseline migration"
+                                "Database schema is not empty, creating baseline migration. In read-only file system, please set an environment variable `LITELLM_MIGRATION_DIR` to a writable directory to enable migrations. Learn more - https://docs.litellm.ai/docs/proxy/prod#read-only-file-system"
                             )
                             ProxyExtrasDBManager._create_baseline_migration(schema_path)
                             logger.info(

Original file line number	Diff line number	Diff line change
`@@ -298,7 +298,7 @@ def setup_database(use_migrate: bool = False) -> bool:`
`298`	`298`	`and "database schema is not empty" in e.stderr`
`299`	`299`	`):`
`300`	`300`	`logger.info(`
`301`		`- "Database schema is not empty, creating baseline migration"`
	`301`	+ "Database schema is not empty, creating baseline migration. In read-only file system, please set an environment variable `LITELLM_MIGRATION_DIR` to a writable directory to enable migrations. Learn more - https://docs.litellm.ai/docs/proxy/prod#read-only-file-system"
`302`	`302`	`)`
`303`	`303`	`ProxyExtrasDBManager._create_baseline_migration(schema_path)`
`304`	`304`	`logger.info(`