1. Docker Health Checks Failing
During installation with Docker, many users find the `openmetadata-server` container marked as “unhealthy,” which prevents the service from running. This often stems from incorrect or missing environment configurations or Docker memory allocation. A common solution is to increase Docker’s memory in settings (around 4 GB or more) and to check compatibility with `docker-compose` and `docker` versions. If issues persist, inspecting container logs for specific errors and referring to the GitHub discussion can provide more guidance.
2. Dependency Issues with `docker-compose`
OpenMetadata’s Docker setup sometimes fails if `docker-compose` isn’t installed or if it’s an incompatible version. Although recent Docker releases support the `docker compose` command (without the hyphen), OpenMetadata may still expect `docker-compose`. Installing the latest `docker-compose` manually can often resolve this. There’s a detailed explanation for managing this dependency on GitHub, where users share workarounds.
3. Python SDK and Virtual Environments
When using the OpenMetadata Python SDK, issues arise if Python versions aren’t compatible (3.8+ is recommended). Creating a virtual environment helps isolate dependencies, and using `pyenv` for Python version management can avoid conflicts. Installing the SDK (`openmetadata-ingestion`) within this environment prevents dependency clashes with other projects, a solution described in Restack’s SDK setup guide.
4. OpenMetadata Ingestion Services Configuration
For advanced users setting up ingestion pipelines, ensuring that the configurations align with the server’s version is crucial. Discrepancies between SDK and server versions can lead to ingestion failures, especially if customized ingestion connectors are involved. Aligning versions and following community-recommended practices, like using the `metadata` CLI to verify SDK functionality, helps streamline setup. These steps address common pain points effectively, though for further troubleshooting, the OpenMetadata community provides insights on GitHub and Stack Overflow, where ongoing updates and solutions are discussed in real-time.
For additional reference, you can explore the solutions shared by users and contributors on [GitHub] and [Restack].
Last Releases
- 1.7.5-releaseRelease: Add what’s new content for 1.7.5 (#21860) (cherry picked from commit 1439081) Source: https://github.com/open-metadata/OpenMetadata/releases/tag/1.7.5-release
- 1.6.13-releasefix #21394 Custom properties bug update with existing wrong values (#… …21825) * fix #21394 allow only updated extension fields to be validated * fix #21394 add tests * fix… Read more: 1.6.13-release
- 1.7.4-releaseAdd what’s new content for 1.7.4 (#21794) (cherry picked from commit 74851f8) Source: https://github.com/open-metadata/OpenMetadata/releases/tag/1.7.4-release