psycopg2-binary==2.9.6 incompatible with Python 3.12 docker image #37126

Activity

1. dosubot

   added

   data:connect:postgresRelated to PostgresRelated to Postgres

   install:dockerInstallation - docker containerInstallation - docker container

   on Jan 14, 2026
2. dosubot commented on Jan 14, 2026

   

   dosubotBot

   on Jan 14, 2026 – with DosuBot

   More actions

   Hi @bimbolimbo! I'm Dosu and I’m helping the superset team.

   You're correct: the postgres extra in Superset's pyproject.toml is pinned to psycopg2-binary==2.9.6, which does not have pre-built wheels for Python 3.12. This causes pip to attempt a source build, resulting in the gcc error you described in minimal Docker images (source).

   This issue is widely reported by users running Superset on newer Python versions and containerized environments (discussion). The most robust workaround is to install psycopg2-binary>=2.9.9, which provides Python 3.12 wheels and avoids the need for build tools. However, as of now, the official Superset dependencies have not been updated to reflect this, and there is no official fix merged yet (PR reference).

   If you need to proceed before an official update, you can override the dependency in your Dockerfile with:

   RUN pip install 'psycopg2-binary>=2.9.9'
   

   This should resolve the build failure on Python 3.12 images.

   To reply, just mention @dosu.

   ---

   ^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

      
3. rusackas

   assigned

   sadpandajoe

   on Jan 23, 2026
4. rusackas commented on Jan 27, 2026

   

   rusackas

   on Jan 27, 2026

   Member

   More actions

   PR welcome if the suggested fix does indeed fix it!
5. hainenber

   closed this as completedin #37587on Jan 31, 2026