Configuring a GeoGig repository¶
Once the repository is initialized, some further configuration is recommended to ease further work.
GeoGig configuration parameters are set using the
geogig config command, which, in the case of setting a new value, has the following syntax:
geogig config <--global> param_name param_value
Parameters are divided in sections, and they are referred to in the form
When creating a new repository, we recommend that you set two parameters in the
user section, which will identify you as the user of the repository. This is especially useful when sharing changes with others. When you later add changes to the repository to create new versions of your data, GeoGig will know who you are, so you will not have to enter this information manually each time.
To define your user, you have to configure a name and an email address, using the
user.email parameter. Substitute the values in quotes with your own name and email address.
geogig config user.name "Author" geogig config user.email "firstname.lastname@example.org"
You can get a display of all the configured values by using the
geogig config -l
These parameters are valid just for this particular repository. You can also configure global parameters as well, which will apply to all repositories created, unless overwritten by a local parameter.
To set the global value of a parameter, use the
geogig config --global user.name "Author" geogig config --global user.email "email@example.com"
You can also get a display of all the configured global values by using the
geogig config -l --global
Console text colouring can be set using the
ansi.enabled parameter. Set the value to
false to manually enable or disable ANSI support. This will override the auto-detection of ANSI support and can be set at the global level using
--global or set in a repository as shown below.
geogig config ansi.enabled true
To use auto-detection of ANSI support use the
--unset flag to remove the
geogig config --unset ansi.enabled