Compatibility and Version Requirements

This guide describes Unity Editor version recommendations and system requirements.

We recommend using one of the following Unity versions for all Oculus development.

  • 2017.4.17f1 (Recommended)
  • 2018.2.19f1

At this time we do not recommend using Unity versions 2018.2.20f1 or 2018.3.x.

Our Troubleshooting and Known Issues page describes known issues with specific versions on Unity.

All Unity versions 5.1 and later ship with the Oculus OVRPlugin, providing built-in support for Rift, Oculus Go, and Samsung Gear VR.

The optional Oculus Utilities for Unity package offers additional developer resources, and includes the latest version of OVRPlugin. When you import Utilities for Unity into a project, if the OVRPlugin version included with the Utilities is later than the version built into your editor, a pop-up dialog will give you the option to update it in your project. We always recommend using the latest available OVRPlugin version. For more information, see OVRPlugin.

Legacy support is available for Unity 4 - see our Unity 4.x Legacy Integration Developer Guide for more information.

System and Hardware Requirements

To verify that you are using supported hardware, please review the relevant PC or mobile setup documentation:

OS Compatibility

  • Windows: Windows 7, 8, 10
  • Mac: OS X Yosemite, El Capitan, Sierra

OS X development requires the Oculus Rift Runtime for OS X, available from our Downloads page. Note that runtime support for OS X is legacy only. It does not support consumer versions of Rift.

Unity Personal and Professional Licenses

The Unity Personal and Professional licenses both provide built-in Rift support. Mobile developers using the Unity Free license receive basic Android support automatically. Mobile developers using a Professional license require an Android Pro Unity license.

For more information, see License Comparisons in Unity’s documentation.

Controllers

You may wish to have a controller for development or to use with the supplied demo applications. Available controllers include the Oculus Touch or Xbox 360 controller for Rift, and the Gear VR Controller and Oculus Go Controller for mobile development.