Mac OS X installer¶

The Mac OS X installer provides an easy way to set up GeoServer on your system, as it requires no configuration files to be edited or command line settings.

1. Make sure you have a Java Runtime Environment (JRE) installed on your system. GeoServer requires a Java 8 environment, and the JRE supplied by OS X is not sufficient. For more information, please see the instructions for installing Oracle Java on OS X.

   Note

   Java 9 is not currently supported.

   Note

   For more information about Java and GeoServer, please see the section on Java Considerations.

2. Navigate to the GeoServer Download page.

3. Select the version of GeoServer that you wish to download. If you’re not sure, select Stable.

4. Click the link for the Mac OS X installer to begin the download.

5. When downloaded, double click on the file to open it.

6. Drag the GeoServer icon to the Applications folder.

   

   Drag the GeoServer icon to Applications to install

7. Navigate to your Applications folder and double click the GeoServer icon.

8. In the resulting GeoServer console window, start GeoServer by going to Server ‣ Start.

   

   Starting GeoServer

9. The console window will be populated with log entries showing the GeoServer loading process. Once GeoServer is completely started, a browser window will open at http://localhost:8080/geoserver, which is the Web administration interface for GeoServer.

   Warning

   If you encounter the following error during startup, you may have some invalid JAI jars from the default Mac Java install:

   java.lang.NoClassDefFoundError: Could not initialize class javax.media.jai.JAI
   

   To fix this error, locate your Java extensions folder (Usually /System/Library/Java/Extensions and/or ~/Library/Java/Extensions), and delete the following jars:

   jai_codec-1.1.3.jar
   jai_core-1.1.3.jar
   jai_imageio-1.1.jar
   

   If you have upgraded your OS from an older version, you may not have permission to delete these jars. In this case, you will first need to disable System Integrity Protection.