Skip to content


Subversion checkout URL

You can clone with
Download ZIP
JavaScript Java CSS FORTRAN HTML Python Other

Adding Vagrantfile

This will construct a VM to build the Suite repo.
latest commit 8298ea736b
@cuttlefish cuttlefish authored

OpenGeo Suite README

These instructions describe how to build platform independent components of OpenGeo Suite.


The following base software packages are required.

Some modules require additional packages:

Ensure that all the above are installed so that the associated executables are on the PATH of the user building the suite.


  1. Clone the repository:

    % git clone git:// suite
    % cd suite
  2. Initialize submodule dependencies:

    % git submodule update --init --recursive
  3. Do a full build:

    % ant
  4. Or build the module of your choice:

    % cd docs
    % ant 

Build System Overview

The suite repository is made up a number of modules (ie projects). During development typically modules are built individually as opposed to all at once. The primary build tool for suite is Ant. For some modules the ant script delegates to the modules native build tool such as Maven or Sphinx.

All top level modules have a build.xml that defines the following targets:

  1. build - Builds the project, the result of this is something deployable in the development environment. This target is the default.
  2. clean - Cleans the project deleting all build artifacts.
  3. assemble - Assembles the project into a zip archive suitable for deployment in production. This is the artifact consumed by installer builders.
  4. publish - Publishes the zip archive to a final location.
  5. all - Runs all the above targets.

Building for development purposes typically looks like:

ant clean build

Building for deployment purposes typically looks like:

ant clean build assemble

Or to build everything:

ant all

The build directory contains common build files used by modules.

  • common.xml - Common ant targets used by module build files. Every module build file imports this file as the first step.
  • - Default build properties that can be overridden on a global or per module basis.

Build Properties

Many aspects of the suite build such as file locations, executable names, etc... are parameterized into build properties. The default contains a list of default values. Often these default properties must be overridden to cater to the environment (eg. Windows vs Unix) or to cater to specifics of a particular module.

There are two ways to override build properties:

  1. The first is to specify them directly to the ant build command with the Java system property (-D) syntax. For example:

      % ant -Dsuite.build_cat=release build
  2. Creating a file named either at the global level or at the module level. The global is located in the build directory next to Module specific files are located next to the module build.xml file. Naturally the module specific local properties file overrides properties from its global counterpart.

Using any combination of the above method it should never be necessary to modify the file directly.


The suite repository is composed of the following modules:

Consult the module README files for module specific information.

Something went wrong with that request. Please try again.