Enable Docker-based Postgres server for local Databricks app usage when Zscaler/zero-trust blocks Lakebase connection.

[sny-13]

Summary

Enable a Docker-based Postgres server configuration to allow the Databricks app to run locally, as many local machines with Zscaler or zero-trust tools prevent Lakebase from connecting locally.

Background

• Local environments protected by Zscaler or similar zero-trust solutions encounter connectivity issues with Lakebase.
• A local Postgres database running in Docker will circumvent these restrictions, improving developer onboarding and local development workflows.

Acceptance Criteria

• Provide an easy-to-use Docker Compose (or similar) YAML for spinning up a local Postgres server.
• Update documentation with steps for usage and any necessary environment configuration for the Databricks app.
• Ensure the Databricks app can connect to the Dockerized Postgres database without requiring additional firewall exceptions or changes to Zscaler.
• Document troubleshooting steps for common issues (e.g., port conflicts, connecting from the app to Docker, etc.).

Additional Notes

• This enhancement targets improved developer experience (DX).
• Should not impact cloud-based workflows or add unnecessary complexity to production deployment.