<h2>Software requirements<aclass="headerlink"href="#software-requirements"title="Permalink to this headline">¶</a></h2>
<p>Corda uses industry-standard tools to make set-up as simple as possible. Following the software recommendations below will
minimize the number of errors you encounter, and make it easier for others to provide support. However, if you do use other tools,
we’re interested to hear about any issues that arise.</p>
<divclass="section"id="jvm">
<h3>JVM<aclass="headerlink"href="#jvm"title="Permalink to this headline">¶</a></h3>
<p>Corda is written in Kotlin and runs in a JVM. We develop against Oracle JDK 8, and other JVM implementations are not actively
supported. Oracle JDK 8 can be obtained directly from
<aclass="reference external"href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Oracle</a>. Installation instructions are
available for <aclass="reference external"href="http://docs.oracle.com/javase/8/docs/technotes/guides/install/windows_jdk_install.html#CHDEBCCJ">Windows</a>,
<aclass="reference external"href="http://docs.oracle.com/javase/8/docs/technotes/guides/install/linux_jdk.html#BJFGGEFG">Linux</a> and
<p>Please ensure that you keep your Oracle JDK installation updated to the latest version while working with Corda.
Even earlier versions of JDK 8 versions can cause cryptic errors.</p>
<p>If you do choose to use OpenJDK instead of Oracle’s JDK, you will also need to install OpenJFX.</p>
<p>Additional troubleshooting information can be found <aclass="reference external"href="https://docs.corda.net/getting-set-up-fault-finding.html#java-issues">here</a>.</p>
<h3>Kotlin<aclass="headerlink"href="#kotlin"title="Permalink to this headline">¶</a></h3>
<p>Applications on Corda (CorDapps) can be written in any JVM-targeting language. However, Corda itself and most of the samples
are written in Kotlin. If you’re unfamiliar with Kotlin, there is an official <aclass="reference external"href="https://kotlinlang.org/docs/tutorials/">getting started guide</a>.
See also our <aclass="reference internal"href="further-notes-on-kotlin.html"><spanclass="doc">Further notes on Kotlin</span></a>.</p>
</div>
<divclass="section"id="ide">
<h3>IDE<aclass="headerlink"href="#ide"title="Permalink to this headline">¶</a></h3>
<p>We strongly recommend the use of IntelliJ IDEA as an IDE, primarily due to the strength of its Kotlin integration. The free Community
Edition can be downloaded from <aclass="reference external"href="https://www.jetbrains.com/idea/download/">JetBrains</a>.</p>
<p>Please make sure that you’re running the latest version of IDEA, as older versions have been known to have problems integrating with Gradle,
the build tool used by Corda.</p>
<p>You’ll also want to install the Kotlin IDEA plugin by following the instructions
<p>Additional troubleshooting information can be found <aclass="reference external"href="https://docs.corda.net/getting-set-up-fault-finding.html#idea-issues">here</a>.</p>
<p>Following these instructions will give you access to git via the command line. It can also be useful to control git via IDEA. Instructions
for doing so can be found on the <aclass="reference external"href="https://www.jetbrains.com/help/idea/2016.2/using-git-integration.html">JetBrains website</a>.</p>
<h3>Gradle<aclass="headerlink"href="#gradle"title="Permalink to this headline">¶</a></h3>
<p>We use Gradle as the build tool for Corda. However, you do not need to install Gradle itself, as a wrapper is provided.</p>
<p>The wrapper can be run from the command line by using <codeclass="docutils literal"><spanclass="pre">./gradlew</span><spanclass="pre">[taskName]</span></code> on OS X/Linux, or <codeclass="docutils literal"><spanclass="pre">gradlew.bat</span><spanclass="pre">[taskName]</span></code> on Windows.</p>
<p>You can clone these repos to your local machine by running the command <codeclass="docutils literal"><spanclass="pre">git</span><spanclass="pre">clone</span><spanclass="pre">[repo</span><spanclass="pre">URL]</span></code>.</p>
<p>By default, these repos will be on the <codeclass="docutils literal"><spanclass="pre">master</span></code> branch. However, this is an unstable development branch. You should check
out the latest release tag instead by running <codeclass="docutils literal"><spanclass="pre">git</span><spanclass="pre">checkout</span><spanclass="pre">release-M8.2</span></code>.</p>
<h3>Opening Corda/CorDapps in IDEA<aclass="headerlink"href="#opening-corda-cordapps-in-idea"title="Permalink to this headline">¶</a></h3>
<p>When opening a Corda project for the first time from the IDEA splash screen, please click “Open” rather than “Import Project”,
and then import the Gradle project by clicking “Import Gradle project” in the popup bubble on the lower right-hand side of the screen.
If you instead pick “Import Project” on the splash screen, a bug in IDEA will cause Corda’s pre-packaged run configurations to be erased.</p>
<p>If you see this warning too late, that’s not a problem - just use <codeclass="docutils literal"><spanclass="pre">git</span><spanclass="pre">checkout</span><spanclass="pre">.idea/runConfiguration</span></code> or the version control tab in
IDEA to undelete the files.</p>
<p>IDEA’s build of the project may need to be resynced from time to time. This can be done from within IDEA by going to “View” ->“Tool Windows” ->“Gradle”
and clicking “Refresh all Gradle projects”. Whenever prompted about Gradle, accept the defaults suggested by IDEA.</p>
<h2>Next steps<aclass="headerlink"href="#next-steps"title="Permalink to this headline">¶</a></h2>
<p>The best way to check that everything is working fine is by <aclass="reference internal"href="running-the-demos.html"><spanclass="doc">Running the demos</span></a>.</p>
<p>Once you have these demos running, you may be interested in writing your own CorDapps, in which case you should refer to
<p>If you encounter any issues, please see the <aclass="reference internal"href="getting-set-up-fault-finding.html"><spanclass="doc">Troubleshooting</span></a> page, or get in touch with us on the
<aclass="reference external"href="https://discourse.corda.net/">forums</a> or via <aclass="reference external"href="http://slack.corda.net/">slack</a>.</p>
Built with <ahref="http://sphinx-doc.org/">Sphinx</a> using a <ahref="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <ahref="https://readthedocs.org">Read the Docs</a>.