[Bug]: Oracle XE is not compatible substitute for Oracle Free

[TomasTokaMrazek]

Module

Oracle Free

Testcontainers version

2.0.3

Using the latest Testcontainers version?

Yes

Host OS

Linux Mint 22.2

Host Arch

x86

Docker version

Client: Docker Engine - Community
 Version:           29.1.3
 API version:       1.52
 Go version:        go1.25.5
 Git commit:        f52814d
 Built:             Fri Dec 12 14:49:32 2025
 OS/Arch:           linux/amd64
 Context:           default

Server: Docker Engine - Community
 Engine:
  Version:          29.1.3
  API version:      1.52 (minimum version 1.44)
  Go version:       go1.25.5
  Git commit:       fbf3ed2
  Built:            Fri Dec 12 14:49:32 2025
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          v2.2.1
  GitCommit:        dea7da592f5d1d2b7755e3a161be07f43fad8f75
 runc:
  Version:          1.3.4
  GitCommit:        v1.3.4-0-gd6d73eb8
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

What happened?

Containers under package org.testcontainers.containers are deprecated and should be migrated to org.testcontainers.<vendor> in Testcontainers 2.

For Oracle Module at org.testcontainers.oracle.OracleContainer the migration is not possible for gvenzl/oracle-xe image and org.testcontainers.containers.OracleContainer has to be used.

Either org.testcontainers.oracle.OracleContainer should support both xe and free or they should have their own vendor package.

Relevant log output

java.lang.IllegalStateException: 
Failed to verify that image 'gvenzl/oracle-xe' is a compatible substitute for 'gvenzl/oracle-free'. This generally means that you are trying to use an image that Testcontainers has not been designed to use. If this is deliberate, and if you are confident that the image is compatible, you should declare compatibility in code using the `asCompatibleSubstituteFor` method. For example:
   DockerImageName myImage = DockerImageName.parse("gvenzl/oracle-xe").asCompatibleSubstituteFor("gvenzl/oracle-free");
and then use `myImage` instead.

Additional Information

No response