Vaadin Installation Package

While the recommended way to create a Vaadin project and install the libraries is to use an IDE plugin or a dependency management system, such as Maven, Vaadin is also available as a ZIP distribution package.

You can download the newest Vaadin installation package from the download page at http://vaadin.com/download/. Please use a ZIP decompression utility available in your operating system to extract the files from the ZIP package.

Package Contents

README.TXT

This README file gives simple instructions for installing Vaadin in your project.

release-notes.html

The Release Notes contain information about the new features in the particular release, give upgrade instructions, describe compatibility, etc. Please open the HTML file with a web browser.

license.html

Apache License version 2.0. Please open the HTML file with a web browser.

lib folder

All dependency libraries required by Vaadin are contained within the lib folder.

*.jar

Vaadin libraries, as described in “Overview of Vaadin Libraries”.

Installing the Libraries

You can install the Vaadin ZIP package in a few simple steps:

  1. Copy the JAR files at the package root folder to the WEB-APP/lib web library folder in the project. Some of the libraries are optional, as explained in “Overview of Vaadin Libraries”.

  2. Also copy the dependency JAR files at the lib folder to the WEB-APP/lib web library folder in the project.

The location of the WEB-APP/lib folder depends on the project organization, which depends on the development environment.

  • In Eclipse Dynamic Web Application projects: WebContent/WEB-INF/lib.

  • In Maven projects: src/main/webapp/WEB-INF/lib.