1.1.2 Binary Package Install

Binary package installation for Mac, Unix and Windows

How to set up GeoServer with the binary distribution package (-bin version) for Mac, Unix, and Windows platforms. This is used for manually installing the files and running GeoServer as a Java program without a wrapper such as Tomcat.

Jump to:

Unix
Mac OSX
Windows
Setting a Data Directory

Unix

Getting GeoServer
Select geoserver-*.bin.zip* versions.

geoserver-*-bin.zip

After downloading the binary distribution, unzip geoserver--bin.zip* file to */usr/local (Recommended). The file will expand the files into /usr/local/geoserver.

cd /usr/local
unzip geoserver-*-bin.zip

There are two techniques by which the GeoServer binary distribution can be started. These will run GeoServer as a user program until you stop it (or the computer is restarted). To have it automatically started see the section Loading GeoServer at boot time.

Via an environment variable:
Open a command console and type:
```
$GEOSERVER_HOME/bin/startup.sh
```

By changing your current working directory
Open a command console and type:
```
cd $GEOSERVER_HOME/bin
./startup.sh
```

Go to http://localhost:8080/geoserver to configure the server.

Loading GeoServer at boot time

Ubuntu

Have a look at Ubuntu init.d startup script, edit to suit, place in /etc/init.d and run "update-rc.d geoserver defaults"

Fedora Core & Redhat Linux

Edit a file called /etc/rc.local:

gedit /etc/rc.local

Add this line:

/usr/local/geoserver/bin/startup.sh &

Save the changes and exit the editor and type the following to make the script executable:

chmod +x /etc/profile.d/geoserver.sh

Now we need to make make those variables immediately available:

source /etc/profile.d/java.sh
source /etc/profile.d/geoserver.sh

Mac OSX

Download the GeoServer-x.x.x-bin.zip version from the download page on the GeoServer home page
unzip to the directory of your choice
Open up a terminal and go to the unzipped 'geoserver' directory on the command line.
Configure your Java environment, on recent versions of Mac OS X this is done by typing
```
export JAVA_HOME=/Library/Java/Home
```
run bin/startup.sh
Go to http://localhost:8080/geoserver to configure your server

If you're interested in running GeoServer with Tomcat and/or on Max OS X server, see GeoServer-Tomcat-Mac

Windows

Download the GeoServer-x.x.x.exe version from the download page on GeoServer.org
Follow the steps on the installer.
Select 'start geoserver' from the start menu
Go to http://localhost:8080/geoserver Or use the 'admin geoserver' shortcut from the start menu.

Setting a Data Directory

By default, the binary package install will run from a data directory included in the archive. To change this behavior set the GEOSERVER_DATA_DIR to the desired location:

Linux/Mac:

export GEOSERVER_DATA_DIR=/var/lib/geoserver_data

Windows:

GEOSERVER_DATA_DIR=C:\geoserver_data

For more information on the data directory head to: Data Directories