GeoGig Workshop

2.2. GeoGig setup

Before we can use GeoGig, we will need to configure the tool. Specifically we will want to enter information about the user that will be doing the commit. The information we enter here will be contained in all commits performed by this user, associating changes with its author.

User information can be set globally, for all repositories managed by GeoGig, or on a per-repository basis. We will set this information globally.

  1. In a terminal, enter the following two commands, substituting your own information for what is in quotes:

    geogig config --global "Author"
    geogig config --global ""


If you encounter any errors with the geogig command line interface, please see the Troubleshooting section.

2.3. Create a GeoGig repository

  1. On the command line, navigate to the geogig directory.

  2. Create a new directory and call it repo. This directory will house the GeoGig repo.

    mkdir repo


    As mentioned before, no spatial data needs to be contained in this directory. In fact, no files at all need to be in this directory, except for the .geogig subdirectory.

  3. Switch to this directory.

    cd repo
  4. Create a new GeoGig repository in this directory:

    geogig init
  5. View a directory listing that shows all files and verify that the .geogig directory has been created.

2.4. More about the geogig command

All working commands with GeoGig are in the following form:

geogig [command] [options]

These commands must be run from in the directory where the repository was created.

To see a full list of commands, type:

geogig --help

To see a list of the parameters associated with a given command, type help followed by the command. For example, to see the parameters associated with the show command, type:

geogig help show
Displays information about a commit, feature or feature type
Usage: show [options] <reference>
       Produce machine-readable output
       Default: false


Your copy of GeoGig may include a command geogig-console which opens a dedicated GeoGig shell, allowing you to run GeoGig commands without typing geogig first.

(geogig):/home/boundless/repo $ init
Initialized empty Geogig repository in /home/boundless/repo/.geogig
(geogig):/home/boundless/repo (master) $ log
No commits to show

geogig-console is still in development and some terminals can produce artifacts on the line which make it difficult to use.

This Page

About Boundless

Boundless provides commercial open source software for internet mapping and geospatial application development. We are dedicated to the growth and support of open source software.


This work is licensed under a Creative Non Commercial-Commons Attribution-Share Alike 3.0 United States License. Feel free to use this material, but we ask that you please retain the Boundless branding, logos and style.

Creative Commons License