Installation on Ubuntu Linux

This section describes how to install OpenGeo Suite on Ubuntu Linux. These instructions should be followed if:

  • Your system does not have OpenGeo Suite
  • You are upgrading from a minor version of OpenGeo Suite (for example: from 4.x to 4.y)

Do not use these instructions if upgrading from a previous major version of OpenGeo Suite (for example: from 3.x to 4.y). Instead, see the Upgrade section.

Note

QGIS, while part of OpenGeo Suite, is not currently bundled as a package by Boundless. To use QGIS with an Ubuntu system, please see the QGIS community installation instructions.

System requirements

The following Ubuntu versions are supported:

Warning

OpenGeo Suite is not supported on any other versions of Ubuntu (such as 13.04 or later). If running an unsupported installation, dependency conflicts may occur.

OpenGeo Suite for Ubuntu has the following system requirements:

  • Memory: 512MB minimum (1GB recommended)
  • Disk space: 750MB minimum (plus extra space for any loaded data)
  • Browser: Any modern web browser is supported
  • Permissions: Super user privileges are required for installation

Pre-installation

This installation will add the OpenGeo Suite package repository and then install the appropriate packages. See the Packages section for details about the possible packages to install.

Warning

Mixing repositories is not recommended. If you already have a repository that contains some of the components of OpenGeo Suite (such as PostgreSQL) please remove them before installing OpenGeo Suite.

The commands in this section require root privileges.

  1. Change to the root user:

    sudo su -

  2. Import the OpenGeo GPG key:

    wget -qO- http://apt.opengeo.org/gpg.key | apt-key add -

  3. Add the OpenGeo Suite repository.

    If installing for Precise:

    echo "deb http://apt.opengeo.org/suite/v4/ubuntu/ precise main" > /etc/apt/sources.list.d/opengeo.list

    If installing for Lucid:

    echo "deb http://apt.opengeo.org/suite/v4/ubuntu/ lucid main" > /etc/apt/sources.list.d/opengeo.list

Installation

  1. Update:

    apt-get update

  2. Search for OpenGeo packages:

    apt-cache search opengeo

    If the search command does not return any results, the repository was not added properly. Examine the output of the apt commands for any errors or warnings.

  3. You have options on what packages to install.

    For server components:

    apt-get install opengeo-server

    For client components:

    apt-get install opengeo-client

    For both client and server components:

    apt-get install opengeo

    Note

    See the Packages section for details of individual packages.

After installation

Installation is now complete. Please see the section on Working with OpenGeo Suite for Ubuntu Linux.