Installing from WAR file

This section describes how to install GeoNetwork with the WAR.

At the end of the installation process you will end up with the web applications running.

Host ports requirements:

• Java web server Apache Tomcat or Jetty: 8080
• Database eg. 5432 for a default PostgreSQL installation

For Apache Tomcat we recommend the following versions: 8.5.x and 9.0.x. The latest Apache Tomcat 10.x cannot be used at this time.

For Jetty we the following versions: 9.4.x. Newer versions to Jetty cannot be used at this time.

1. Download the WAR file

   GeoNetwork releases are available in https://sourceforge.net/projects/geonetwork/files/GeoNetwork_opensource/

   You can download the WAR file geonetwork.war from your browser or use command line like

   wget https://downloads.sourceforge.net/project/geonetwork/GeoNetwork_opensource/v3.12.2/geonetwork.war
   

2. Copy the WAR to the Java web server

   After download, copy the WAR file in the webapp folder of Tomcat or Jetty.

   cp geonetwork.war /usr/share/apache-tomcat{X}/webapps/.
   

3. Start the Java web server

   If started, Tomcat will automatically deploy the application. If not, start the Java web server to deploy.

   Note

   You need to ensure Tomcat is configured with enough memory for GeoNetwork to launch. This can be be configured via the setenv script in tomcat with the appropriate memory for the JAVA_OPTS property). -Xms2g -Xmx2g is usually fine.

4. Up and running?

   Open or refresh http://localhost:8080/geonetwork in your web browser. You should see the GeoNetwork home page:

   

   You have now a default GeoNetwork up and running.

   To customize your catalog, you may follow the next steps to configure the database (See Configuring the database) instead of using the default H2 database and the data directory (See Customizing the data directory) .

   See Loading templates and sample data to start loading metadata records.