Documentation versions (currently viewingVaadin 8)

Vaadin 8 reached End of Life on February 21, 2022. Discover how to make your Vaadin 8 app futureproof →

Installing Java SDK

A Java SDK is required by Vaadin and also by any of the Java IDEs. Vaadin Framework 8 requires Java 8. Java EE 7 is required for proper server push support with WebSockets.


Follow the following steps:

  1. Download Oracle Java SE 8.0 from

  2. Install the Java SDK by running the installer. The default options are fine.

Linux / UNIX

Most Linux systems either have JDK preinstalled or allow installing it through a package management system. Notice however that they have OpenJDK as the default Java implementation. While it is known to have worked with Vaadin Framework and possibly also with the development toolchain, we do not especially support it.

Depending on your OS distribution, you may have to download Java JDK 8:

  1. Download Oracle Java SE 8.0 from

  2. Decompress it under a suitable base directory, such as /opt. For example, for Java SDK, enter (either as root or with sudo in Linux):

    # cd /opt
    # sh <path>/jdk-<version>.bin

    and follow the instructions in the installer.

  3. Set up the JAVA_HOME environment variable to point to the Java installation directory. Also, include the $JAVA_HOME/bin in the PATH. How you do that varies by the UNIX variant. For example, in Linux and using the Bash shell, you would add lines such as the following to the .bashrc or .profile script in your home directory:

    export JAVA_HOME=/opt/jdk1.8.0_31
    export PATH=$PATH:$HOME/bin:$JAVA_HOME/bin

    You could also make the setting system-wide in a file such as /etc/bash.bashrc, /etc/profile, or an equivalent file. If you install Apache Ant or Maven, you may also want to set up those in the path.

    Settings done in a bashrc file require that you open a new shell window. Settings done in a profile file require that you log in into the system. You can, of course, also give the commands in the current shell.