Instant Client Downloads
for macOS (Intel x86)


You must accept the Oracle Technology Network License Agreement to download this software. Subject to the Oracle Technology Network License Agreement for Oracle Instant Client software, licensees are authorized to use the version of Oracle Instant Client downloaded from this Oracle Technology Network webpage to provide third party training and instruction on the use of Oracle Instant Client.
Accept License Agreement     Decline License Agreement

See the Instant Client Home Page for more information about Instant Client.

The installation instructions are at the foot of the page.

Client-server version interoperability is detailed in Doc ID 207303.1. For example, Oracle Call Interface 12.2 can connect to Oracle Database 11.2 or later. Some tools may have other restrictions.


Version 12.2.0.1.0 (64-bit)
Updated 15-Jan-2018
 
Base - one of these packages is required

    Basic Package - All files required to run OCI, OCCI, and JDBC-OCI applications
Download instantclient-basic-macos.x64-12.2.0.1.0-2.zip (68,160,048 bytes) (cksum - 2145539248)

Basic Light Package - Smaller version of the Basic package, with only English error messages and Unicode, ASCII, and Western European character set support
Download instantclient-basiclite-macos.x64-12.2.0.1.0-2.zip (32,101,235 bytes) (cksum - 1597579561)
 
Tools - optional packages

    SQL*Plus Package - The SQL*Plus command line tool for SQL and PL/SQL queries
Download instantclient-sqlplus-macos.x64-12.2.0.1.0-2.zip (905,985 bytes) (cksum - 3193372887)

Tools Package - Includes Data Pump, SQL*Loader and Workload Replay Client
Download instantclient-tools-macos.x64-12.2.0.1.0-2.zip (1,188,607 bytes) (cksum - 4234197225)

  Development and Runtime - optional packages

    SDK Package - Additional header files and an example makefile for developing Oracle applications with Instant Client
Download instantclient-sdk-macos.x64-12.2.0.1.0-2.zip (673,883 bytes) (cksum - 3731483473)

JDBC Supplement Package - Additional support for Internationalization under JDBC
Download instantclient-jdbc-macos.x64-12.2.0.1.0-2.zip (1,570,334 bytes) (cksum - 1705103068)

ODBC Package - Additional libraries for enabling ODBC applications
Download instantclient-odbc-macos.x64-12.2.0.1.0-2.zip (1,962,870 bytes) (cksum - 3397148646)

Precompiler Package - Additional files for Pro*C and Pro*COBOL

Version 12.1.0.2 (64-bit)
Updated 5-Jul-2017

  Instant Client Package - Basic: All files required to run OCI, OCCI, and JDBC-OCI applications
Download instantclient-basic-macos.x64-12.1.0.2.0.zip (63,591,161 bytes) (cksum - 2819753276)

Instant Client Package - Basic Light: Smaller version of the Basic package, with only English error messages and Unicode, ASCII, and Western European character set support
Download instantclient-basiclite-macos.x64-12.1.0.2.0.zip (31,539,594 bytes) (cksum - 1112518720)

Instant Client Package - JDBC Supplement: Additional support for XA, Internationalization, and RowSet operations under JDBC
Download instantclient-jdbc-macos.x64-12.1.0.2.0.zip (143,238 bytes) (cksum - 988652685)

Instant Client Package - SQL*Plus: Additional libraries and executable for running SQL*Plus with Instant Client
Download instantclient-sqlplus-macos.x64-12.1.0.2.0.zip (871,943 bytes) (cksum - 1242636584)

Instant Client Package - ODBC: Additional libraries for enabling ODBC applications
Download instantclient-odbc-macos.x64-12.1.0.2.0.zip (1,865,942 bytes) (cksum - 2249115520)

Instant Client Package - SDK:
Additional header files and an example makefile for developing Oracle applications with Instant Client
Download instantclient-sdk-macos.x64-12.1.0.2.0.zip (664,114 bytes) (cksum - 670890418)

Instant Client Package - WRC: Workload Replay Client used to replay workload for RAT's DB Replay Feature
Download instantclient-tools-macos.x64-12.1.0.2.0.zip (236,151 bytes) (cksum - 3773150080)

Instant Client Package - Precompiler: Additional files for "proc" binary and related files to precompile a Pro*C application and demo

Version 12.1.0.2 (32-bit) Updated 4-Jan-17

  Instant Client Package - Basic: All files required to run OCI, OCCI, and JDBC-OCI applications
Download instantclient-basic-macos.x32-12.1.0.2.0.zip (64,143,856 bytes) (cksum - 3075410801)

Instant Client Package - Basic Light: Smaller version of the Basic, with only English error messages and Unicode, ASCII, and Western European character set support
Download instantclient-basiclite-macos.x32-12.1.0.2.0.zip (32,093,291 bytes) (cksum - 1437280362)

Instant Client Package - JDBC Supplement: Additional support for XA, Internationalization, and RowSet operations under JDBC
Download instantclient-jdbc-macos.x32-12.1.0.2.0.zip (143,295 bytes) (cksum - 2965858677)

Instant Client Package - SQL*Plus: Additional libraries and executable for running SQL*Plus with Instant Client
Download instantclient-sqlplus-macos.x32-12.1.0.2.0.zip (892,440 bytes) (cksum - 1535728498)

Instant Client Package - ODBC: Additional libraries for enabling ODBC applications
Download instantclient-odbc-macos.x32-12.1.0.2.0.zip (1,883,055 bytes) (cksum - 1502599121)

Instant Client Package - SDK: Additional header files and an example makefile for developing Oracle applications with Instant Client
Download instantclient-sdk-macos.x32-12.1.0.2.0.zip (664,121 bytes) (cksum - 2233654893)

Instant Client Package - WRC: Workload Replay Client used to replay workload for RAT's DB Replay Feature
Download instantclient-tools-macos.x32-12.1.0.2.0.zip (258,686 bytes) (cksum - 2882512306)

Instant Client Package - Precompiler: Additional files for "proc" binary and related files to precompile a Pro*C application and demo

Version 11.2.0.4.0 (64-bit)

  Instant Client Package - Basic: All files required to run OCI, OCCI, and JDBC-OCI applications
Download instantclient-basic-macos.x64-11.2.0.4.0.zip (62,794,903 bytes)

Instant Client Package - Basic Light: Smaller version of the Basic, with only English error messages and Unicode, ASCII, and Western European character set support
Download instantclient-basiclite-macos.x64-11.2.0.4.0.zip (26,034,836 bytes)

Instant Client Package - JDBC Supplement: Additional support for XA, Internationalization, and RowSet operations under JDBC
Download instantclient-jdbc-macos.x64-11.2.0.4.0.zip (1,560,298 bytes)

Instant Client Package - SQL*Plus: Additional libraries and executable for running SQL*Plus with Instant Client
Download instantclient-sqlplus-macos.x64-11.2.0.4.0.zip (884,608 bytes)

Instant Client Package - SDK: Additional header files and an example makefile for developing Oracle applications with Instant Client
Download instantclient-sdk-macos.x64-11.2.0.4.0.zip (651,903 bytes)

Instant Client Package - WRC: Workload Replay Client used to replay workload for RAT's DB Replay Feature
Download instantclient-tools-macos.x64-11.2.0.4.0.zip (235,951 bytes)

Instant Client Package - Precompiler: Additional files for "proc" binary and related files to precompile a Pro*C application and demo

Version 11.2.0.4.0 (32-bit)

  Instant Client Package - Basic: All files required to run OCI, OCCI, and JDBC-OCI applications
Download instantclient-basic-macos.x32-11.2.0.4.0.zip (58,425,231 bytes)

Instant Client Package - Basic Light: Smaller version of the Basic, with only English error messages and Unicode, ASCII, and Western European character set support
Download instantclient-basiclite-macos.x32-11.2.0.4.0.zip (23,003,182 bytes)

Instant Client Package - JDBC Supplement: Additional support for XA, Internationalization, and RowSet operations under JDBC
Download instantclient-jdbc-macos.x32-11.2.0.4.0.zip (11,078 bytes)

Instant Client Package - SQL*Plus: Additional libraries and executable for running SQL*Plus with Instant Client
Download instantclient-sqlplus-macos.x32-11.2.0.4.0.zip (800,263 bytes)

Instant Client Package - SDK: Additional header files and an example makefile for developing Oracle applications with Instant Client
Download instantclient-sdk-macos.x32-11.2.0.4.0.zip (651,903 bytes)

Instant Client Package - WRC: Workload Replay Client used to replay workload for RAT's DB Replay Feature
Download instantclient-tools-macos.x32-11.2.0.4.0.zip (197,708 bytes)

Instant Client Package - Precompiler: Additional files for "proc" binary and related files to precompile a Pro*C application and demo


Version 10.2.0.4 (64-bit)

  Instant Client Package - Basic: All files required to run OCI, OCCI, and JDBC-OCI applications
 instantclient-basic-10.2.0.4.0-macosx-x64.zip (35,013,419 bytes)

Instant Client Package - Basic Light: Smaller version of the Basic, with only English error messages and Unicode, ASCII, and Western European character set support (10.2 only)
 instantclient-basiclite-10.2.0.4.0-macosx-x64.zip (11,877,594 bytes)

Instant Client Package - JDBC Supplement: Additional support for XA, Internationalization, and RowSet operations under JDBC
 instantclient-jdbc-10.2.0.4.0-macosx-x64.zip (1,493,189 bytes)

Instant Client Package - SQL*Plus: Additional libraries and executable for running SQL*Plus with Instant Client
 instantclient-sqlplus-10.2.0.4.0-macosx-x64.zip (746,094 bytes)

Instant Client Package - SDK: Additional header files and an example makefile for developing Oracle applications with Instant Client
 instantclient-sdk-10.2.0.4.0-macosx-x64.zip (603,530 bytes)

Version 10.2.0.4 (32-bit)

  Instant Client Package - Basic: All files required to run OCI, OCCI, and JDBC-OCI applications
 instantclient-basic-10.2.0.4.0-macosx-x86.zip (34,109,360 bytes)

Instant Client Package - Basic Light: Smaller version of the Basic, with only English error messages and Unicode, ASCII, and Western European character set support (10.2 only)
 instantclient-basiclite-10.2.0.4.0-macosx-x86.zip (10,975,530 bytes)

Instant Client Package - JDBC Supplement: Additional support for XA, Internationalization, and RowSet operations under JDBC
 instantclient-jdbc-10.2.0.4.0-macosx-x86.zip (1,490,104 bytes)

Instant Client Package - SQL*Plus: Additional libraries and executable for running SQL*Plus with Instant Client
 instantclient-sqlplus-10.2.0.4.0-macosx-x86.zip (711,801 bytes)

Instant Client Package - SDK: Additional header files and an example makefile for developing Oracle applications with Instant Client
 instantclient-sdk-10.2.0.4.0-macosx-x86.zip (603,526 bytes)



Instant Client Installation for macOS (Intel x86)


Installing Instant Client 12.2 on macOS


Instant Client 12.2 supports macOS High Sierra, Sierra and El Capitan.

1. Download the desired Instant Client ZIP files. All installations require the Basic or Basic Light package.

2. Unzip the packages into a single directory such as ~/instantclient_12_2 that is accessible to your application. For example:

  cd ~
  unzip instantclient-basic-macos.x64-12.2.0.1.0.zip

3. Add links to ~/lib or /usr/local/lib to enable applications to find the libraries. For example, OCI based applications could do:

  mkdir ~/lib
  ln -s ~/instantclient_12_2/libclntsh.dylib ~/lib/
  ln -s ~/instantclient_12_2/libclntsh.dylib.12.1 ~/lib/

Alternatively, copy the required libraries. For example, to use OCI applications:

  mkdir ~/lib
  cp /opt/oracle/instantclient_12_2/libclntsh.dylib.12.1 ~/lib/
  cp /opt/oracle/instantclient_12_2/libclntshcore.dylib.12.1 ~/lib/
  cp /opt/oracle/instantclient_12_2/libons.dylib ~/lib/
  cp /opt/oracle/instantclient_12_2/libnnz12.dylib ~/lib/
  cp /opt/oracle/instantclient_12_2/libociei.dylib ~/lib/
  ln -s ~/lib/libclntsh.dylib.12.1 ~/lib/libclntsh.dylib

Note: Custom OCI applications, such as those that bundle Instant Client, may want to link with -rpath set to the directory containing Instant Client 12.2 instead of relying on libraries being in ~/lib.

4. If you intend to co-locate optional Oracle configuration files such as tnsnames.ora, sqlnet.ora, ldap.ora, or oraaccess.xml with Instant Client, then create a network/admin subdirectory. For example:

  mkdir -p ~/instantclient_12_2/network/admin

This is the default Oracle configuration directory for applications linked with this Instant Client.

Alternatively, Oracle configuration files can be put in another, accessible directory. Then set the environment variable TNS_ADMIN to that directory name.

5. To use binaries such as sqlplus from the SQL*Plus package, unzip the package to the same directory as the Basic package and then update your PATH environment variable, for example:

  export PATH=~/instantclient_12_2:$PATH

6. Run SQL*Plus and connect using your database credentials and connection string:

  sqlplus hr/welcome@localhost/orclpdb


Installing Instant Client 12.1 on macOS


Instant Client 12.1 supports macOS El Capitan, Yosemite and Mavericks.

1. Download the desired Instant Client ZIP files. All installations require the Basic or Basic Light package.

2. Unzip the packages into a single directory such as "~/instantclient_12_1". For example, to use SQL*Plus:

  cd ~
  unzip instantclient-basic-macos.x64-12.1.0.2.0.zip
                        

3. Create the appropriate libclntsh.dylib link for the version of Instant Client. For example:

  cd ~/instantclient_12_1
  ln -s libclntsh.dylib.12.1 libclntsh.dylib

OCCI programs will additionally need:

  ln -s libocci.dylib.12.1 libocci.dylib

4. Add links to ~/lib or /usr/local/lib to enable applications to find the libraries. For example, OCI based applications could do:

  mkdir ~/lib
  ln -s ~/instantclient_12_1/libclntsh.dylib ~/lib/
  ln -s ~/instantclient_12_1/libclntsh.dylib.12.1 ~/lib/

Alternatively, copy the required libraries. For example, to use OCI applications:

  mkdir ~/lib
  cp /opt/oracle/instantclient_12_1/libclntsh.dylib.12.1 ~/lib/
  cp /opt/oracle/instantclient_12_1/libclntshcore.dylib.12.1 ~/lib/
  cp /opt/oracle/instantclient_12_1/libons.dylib ~/lib/
  cp /opt/oracle/instantclient_12_1/libnnz12.dylib ~/lib/
  cp /opt/oracle/instantclient_12_1/libociei.dylib ~/lib/

Note: Custom OCI applications, such as those that bundle Instant Client, may want to link with -rpath set to the directory containing Instant Client 12.1 instead of relying on libraries being in ~/lib.

5. To be able to run SQL*Plus, update PATH. For example:

  export PATH=~/instantclient_12_1:$PATH

6. Run SQL*Plus and connect using your database credentials and connection string:

  sqlplus hr/welcome@localhost/orclpdb


Installing Instant Client 11.2 on macOS


Instant Client 11.2 supports macOS X Lion, Mountaint Lion and Mavericks.

1. Download the desired Instant Client ZIP files. All installations require the Basic or Basic Light package.

2. Unzip the packages into a single directory such as "~/instantclient_11_2". For example, to use SQL*Plus:

  cd ~
  unzip instantclient-basic-macos.x64-11.2.0.4.0.zip
  unzip instantclient-sqlplus-macos.x64-11.2.0.4.0.zip

3. Create the appropriate libclntsh.dylib link for the version of Instant Client. For example:

  cd ~/instantclient_11_2
  ln -s libclntsh.dylib.11.1 libclntsh.dylib

Note: OCCI programs will additionally need:

  ln -s libocci.dylib.11.1 libocci.dylib

4. Add links to "~/lib" for required Basic package libraries. For example, to use OCI programs (including SQL*Plus, Python's cx_Oracle, PHP's OCI8, Node.js's node-oracledb, and Ruby's ruby-oci8 driver):

  mkdir ~/lib
  ln -s ~/instantclient_11_2/{libclntsh.dylib.11.1,libnnz11.dylib,\
libociei.dylib} ~/lib/

5. To be able to run SQL*Plus, add its libraries to "~/lib", and update PATH. For example:

  ln -s ~/instantclient_11_2/{libsqlplus.dylib,libsqlplusic.dylib} ~/lib/
  export PATH=~/instantclient_11_2:$PATH

6. Run SQL*Plus and connect using your database credentials and connection string:

  sqlplus hr/welcome@localhost/orclpdb


More Information


Instant Client Home Page

Oracle Database Client Installation Guide for Apple Mac OS X (Intel) (11g Release 2)