Project Home | Documentation Index | Getting Started | Developer Documentation

Table Of Contents

Previous topic

URL Startup Arguments

Next topic

Notes on Internationalization

This Page

Local_settings.ini Reference Guide

The settings.ini file found in the conf folder is a text document used as the general configuration file for a GeoMOOSE application. It configures things such as projection, paths, mailing labels. For an example of a settings.ini file, please refer to the GeoMOOSE demo and the file in the conf folder. This reference guide explains the optional settings.

You should never, ever modify settings.ini

This is very important. settings.ini is managed by GeoMOOSE. If you upgrade the application in the same tree as your current application you will lose all of your changes. This can get annoying because replacing the new setttings.ini with your old one could substantially break the application because some of its defaults will be missing. GeoMOOSE is configured to override settings.ini with local_settings.ini. There are two example files that you might want to use for local_settings.ini`; either ms4w_local_settings.ini or unix_local_settings.ini. If you want to change these settings, leave settings.ini alone and change them in local_settings.ini. Think of local_settings.ini as an override to the defaults in settings.ini. Anything that is in settings.ini can go into local_settings.ini.

The configurations


  • mapbook – location of default mapbook


  • projection – EPSG code of coordinate system for the map


  • server_name - name of your web server. For development purposes this can be left set as “localhost”. However, for a public webserver, the server_name parameter should be changed to the name of that server.
  • root – root for the map (only configured through local_settings.ini)
  • temp – web accessible location of the temp files relative to the root of the domain (only configured through local_settings.ini)


This setting specifies which metadata parameters in the mapfiles are used for the identify service output templates.

  • identify_header=identify/header.html
  • identify_footer=identify/footer.html
  • wms_header=identify/wms_header.html
  • wms_record=identify/wms_record.html
  • wms_footer=identify/wms_footer.html


  • highlight_map – this setting specifies which mapfile should be used to symbolize the selected or highlight feature on the map


This setting specifies which metadata parameters in the mapfiles are used for the itemquery service output templates.

  • itemquery_header=itemquery/header.html
  • itemquery_footer=itemquery/footer.html
  • itemquery_miss=itemquery/miss.html


This setting specifies the output of a query with no results returned.

  • query_miss=itemquery/miss.html


These setting specify formatting options for the labels generated from the mailing labels service. Specifies how many rows/columns to print per page:

  • label_rows=10
  • label_columns=3

Specifies page layout information (only applies to PDF Format):

  • label_origin_x=.25
  • label_origin_y=.5
  • label_width=2.5
  • label_height=1

Specifies Font for the label output (only applies to PDF Format):

  • label_font=Arial
  • label_font_size=8

Specifies the settings for the actual lines of the label. The items in parentheses relate to the data source in the mailing labels service. Items must be enter with parentheses and case sensitive field name.

  • label_lines=3
  • label_line_1=%OWNER_NAME%
  • label_line_3=%CITY%, MN %ZIP%

If this is set to “true” then any blank lines in the labels will be “collapsed” in the PDF output.

  • label_lines_collapse=true


Sets the template to use, image width and height for map when selecting the html format for printing output.

  • html_template=./print/default_template.html
  • html_image_width=800
  • html_image_height=700

Apache environment variable to override local_settings.ini location

The default location of local_settings.ini is ‘../../conf/local_settings.ini’. The location of local_settings.ini can be changed with Apache environment variables. For instance, in Apache httpd.conf like: SetEnv GEOMOOSE_LOCAL_SETTINGS '/new/path/to/local_settings.ini'