Make sure your computer meets the following requirements:
64-bit operating system: Windows, Linux or macOS.
Memory – at least 8 GB (16 GB is recommended).
Hard drive free space – at least 20 GB.
Jmix Studio is implemented as a plugin for IntelliJ IDEA. The minimal supported IntelliJ IDEA version is 2022.3.
If you don’t have IntelliJ IDEA installed yet, download Community edition from the JetBrains website and install it.
After IntelliJ IDEA has been installed, do the following:
Start IntelliJ IDEA (2022.3 or newer).
On the startup screen of the IDE click the Plugins button.
If you have any project opened, use the main menu: File → Settings (on Windows and Linux) or IntelliJ IDEA → Preferences (on macOS). Then switch to the Plugins section.
Switch to the Marketplace tab.
Enter "jmix" into the search field. You will see the Jmix plugin in the search results.
Click Install and follow the further instructions of the IDE.
In case you need to configure internet access via a proxy server or install non-standard Studio builds, visit the Studio installation section.
|To have access to the premium Studio features, configure subscription in the subscription dialog window.|
|With Jmix 2.0, you can build applications using Java 17 from any vendor. However, we don’t recommend an OpenJ9-based JDK due to the problems it has caused in the past.|
To run Jmix applications from the terminal, set
JAVA_HOME environment variable as described below.
On Windows, create the
JAVA_HOMEvariable with the path to the installed JDK root directory at Computer → Properties → Advanced System Settings → Advanced → Environment variables. The variable should be added to the System variables list.
On macOS and Linux set
~/.bash_profileor another appropriate file of your shell, for example:
Restart the computer to make sure the environment variable has taken effect.
Check correctness of the environment variable by running the following command in the console:On Windows
"%JAVA_HOME%\bin\java" -versionOn Linux and macOS
The command should return the Java version, e.g.
|If you connect to the internet via a proxy server, some Java system properties must be passed to the JVM running development tools and Gradle. Configure these properties using Jmix Studio.|
Depending on the size of your project, you may need to increase available memory for the IntelliJ IDEA and Gradle processes.
In IntelliJ IDEA, open Help → Edit Custom VM Options… and edit the
-Xmxparameter (it’s usually on top). The recommended value is
2048mor more, for example:
~/.gradle/gradle.propertiesfile and set the
-Xmxparameter in the
org.gradle.jvmargsproperty. The recommended value is
2048mor more, for example: