About this Docker Image
These Docker images contain the Oracle Instant Client 'Basic', 'SDK' and 'SQL*Plus' packages. They can be used to build and run Oracle Call Interface (OCI), Oracle C++ Call Interface (OCCI), and JDBC-OCI applications applications. The SQL*Plus command-line query tool allows quick ad-hoc SQL and PL/SQL execution. The Docker images can be extended with optional packages for ODBC, or to include tools such as Oracle SQL*Loader.
About Oracle Instant Client
The Oracle Instant Client is a repackaging of Oracle Database libraries, tools and header files usable to create and run applications that connect to a remote (or local) Oracle Database.
Oracle client-server version interoperability is detailed in Doc ID 207303.1. In summary, applications using Oracle Call Interface (OCI) 19, 18 and 12.2 can connect to Oracle Database 11.2 or later. Some tools may have other restrictions.
From release 18.3, the Oracle Instant Client RPMs for Oracle Linux are available for direct download from the Oracle Linux yum server without requiring manual license acceptance.
Building the Oracle Instant Client 19 Image
Change directory to
dockerfiles/19 and run:
docker build --pull -t oracle/instantclient:19 .
Applications using Oracle Call Interface (OCI) 19 can connect to Oracle Database 11.2 or later. Some tools may have other restrictions.
Building the Oracle Instant Client 18 Image
Change directory to
dockerfiles/18 and run:
docker build --pull -t oracle/instantclient:18 .
Applications using Oracle Call Interface (OCI) 18 can connect to Oracle Database 11.2 or later. Some tools may have other restrictions.
Building the Oracle Instant Client 12.2 Image
Download the following three RPMs from the Instant Client download page on the Oracle Technology Network:
Place the downloaded Oracle Instant Client RPMs (from the previous step) in the
dockerfiles/220.127.116.11 directory, then switch to that directory and run:
docker build --pull -t oracle/instantclient:18.104.22.168 .
Applications using Oracle Call Interface (OCI) 12.2 can connect to Oracle Database 11.2 or later. Some tools may have other restrictions.
Optional Oracle Net and Oracle Client Configuration Files
Optional Oracle Network and Oracle client configuration files can be
copied to the default configuration file directory
When files are in the default directory, you do not need to set
TNS_ADMIN environment variable.
For Instant Client 12.2, and earlier, you must explicitly create the directory.
You can run a container interactively to execute ad-hoc SQL and PL/SQL statements in SQL*Plus:
docker run -ti --rm oracle/instantclient:19 sqlplus firstname.lastname@example.org/pdborcl
Adding Oracle Database Drivers
To extend the image with optional Oracle Database drivers, follow your desired driver installation steps. The Instant Client libraries are in
/usr/lib/oracle/<version>/client64/lib and the Instant Client headers are in
The Instant Client libraries are in the default library search path.