Building Weasis from source

Skip to end of metadata
Go to start of metadata

These instructions describe how to build Weasis directly from the Git repository on any platform. For building Weasis from an IDE, see Plug-in Development Guidelines.


  1. JDK 6 or higher (Sun or OpenJDK)
  2. Maven 2.2 or higher (
    If your computer is behind a proxy server, configure maven.
  3. Git (or directly download source from gitub), one of the following client:
    • CLI on Linux or Mac OS X -  Install git-core package
    • Windows - Tortoise Git - (When installing msysgit be sure to choose Unix style line endings)
    • Eclipse - Install egit

Getting the Source

To clone the repository, first install GIT and either clone using a graphical GIT client (such as Tortoise Git) or directly from the command line using the command:

git clone git://

This command will copy the current development code (the "master" branch) into a local directory named Weasis.

Note: Sources can also be browsed online or download as a zip file.

The trunk is not a stable version and snapshot version is not retained in cache for the web distribution (it means the files will be every times downloaded)
Check out a tag version to build a stable version, see tag list.
git checkout <TAG_NAME>

Building all Plug-ins

  • Go in the Weasis directory, Compile and install all the plug-ins in the local Maven repository
mvn clean install

Building Weasis Distributions

  • Requires to install all the plug-ins in the local Maven repository (see above Building all Plug-ins).
    cd weasis-distributions
    mvn clean package
    pack200 compression
    From 1.1.2 it is possible to use the compression pack200 that reduces jar size considerably. Note: it is recommended to use the Oracle jdk with this option (openjdk can throw packging errors).
    mvn clean package -P pack200
    For the WEB distribution
    For using Weasis through Java Webstart, it is required to sign jar files with your own certificate (replace values in the command below by your own values). You can generate one with keytool.
    The parameters must be placed in the maven user setting or has to be the options in the Maven command:
    mvn clean package -Djarsigner.alias="your_alias" -Djarsigner.storepass="your_pwd" -Djarsigner.keystore="your_path/keystore"

    Note: On Mac OS X 10.8 and from JRE 1.7.0_51, a trust-worthy certificate from a certificate authority is now required to run Java Web Start applications without changing the security level of the system.

  • Add the "-Dportable=true" option for building the portable distribution (cdrom or removable device).
    mvn clean package -Dportable=true
    Single instance for Windows executable (from version 2.0)
    To disable single instance in portable version, set windowsName property empty. By default, Windows executable is a single instance application.
    mvn clean package -Dportable=true -DwindowsName=
    Possible issue
    On 64-bit system, it requires to install the 32-bit compatibility libraries to build the windows executable. On Linux you need to install ia32-libs package.
    Do not place the sources in a path that contains directories with blanks or national characters, the compilation of the win32 executable can fail.
  • The distribution files are located in:
    • target/web_dist/
    • target/portable-dist/
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Apr 27, 2012

    Ramarajulu says:

    Hi the maven build gets stuck at Downloading:

    Hi the maven build gets stuck at


    is there anywhere else to get the file from ?