NAME¶

renderd.conf - Configuration file of rendering daemon for rendering OpenStreetMap tiles.

SYNOPSIS¶

renderd.conf

DESCRIPTION¶

This manual page documents briefly the renderd.conf configuration file.

renderd.conf is an INI configuration file for use with renderd(1).

The default location is '/etc/renderd.conf' (macro definition 'RENDERD_CONFIG').

All option names are case-insensitive unless otherwise specified.

RENDERD¶

Options belonging to a [renderd] section.

There must be at least one [renderd] section (e.g. [renderd] or [renderd0]).

By default, there can be up to 5 (macro definition 'MAX_SLAVES') [renderd] sections (e.g. [renderd0] - [renderd4]).

[renderd] section names must begin with [renderd].

iphostname

Specify the IP address/hostname to be used for communication with renderd. This must be specified in combination with ipport. This option and socketname are mutually exclusive.

ipport

Specify the port number to be used for communication with renderd. This must be specified in combination with iphostname. This option and socketname are mutually exclusive.

num_threads

Specify the number of threads to be used for renderd. The default value is '4' (macro definition 'NUM_THREADS').

pid_file

Specify the file path into which the PID will be written by renderd. It is only written to when renderd is not running in foreground mode (e.g. without '--foreground' / '-f'). The default value is '/run/renderd/renderd.pid' (macro definition 'RENDERD_PIDFILE').

socketname

Specify the file path to be used as a unix domain socket for communication with renderd. This option and iphostname / ipport are mutually exclusive. The default value is '/run/renderd/renderd.sock' (macro definition 'RENDERD_SOCKET').

stats_file

Specify the file path into which statistics will be written by renderd. By default, a stats file will not be created.

tile_dir

Specify the directory path into which tiles will be written by renderd. The default value is '/var/cache/renderd/tiles' (macro definition 'RENDERD_TILE_DIR').

MAPNIK¶

Options belonging to the [mapnik] section.

There can be only one [mapnik] section.

[mapnik] section name must be equal to [mapnik].

font_dir

Specify the directory path where fonts are searched for by libmapnik. The default value is the output of 'mapnik-config --fonts' / 'pkgconf --variable=fonts_dir libmapnik' (macro definition 'MAPNIK_FONTS_DIR').

font_dir_recurse

Specify whether or not to recurse the font_dir when searching for fonts by libmapnik. The default value is 'false' / '0' (macro definition 'MAPNIK_FONTS_DIR_RECURSE').

plugins_dir

Specify the directory path where input plugins are searched for by libmapnik. The default value is the output of 'mapnik-config --input-plugins' / 'pkgconf --variable=plugins_dir libmapnik' (macro definition 'MAPNIK_PLUGINS_DIR').

MAP SECTION¶

Options belonging a [map] section.

There must be at least one [map] section.

[map] section names can neither begin with [renderd] nor be equal to [mapnik].

[map] section names can be anything else, but they must all be unique.

ASPECTX

Specify the X aspect to be used by mod_tile. Only used by mod_tile. The default value is '1'. This option name is case-sensitive.

ASPECTY

Specify the Y aspect to be used by mod_tile. Only used by mod_tile. The default value is '1'. This option name is case-sensitive.

ATTRIBUTION

Specify the data attribution to be provided by mod_tile as TileJSON (via {URI}/tile-layer.json). Only used by mod_tile. The default value is '&copy;<a href=\\\"http://www.openstreetmap.org/\\\">OpenStreetMap</a> and <a href=\\\"http://wiki.openstreetmap.org/wiki/Contributors\\\">contributors</a>, <a href=\\\"http://opendatacommons.org/licenses/odbl/\\\">(ODbL)</a>' (macro definition 'DEFAULT_ATTRIBUTION'). This option name is case-sensitive.

CORS

Specify the CORS configuration for mod_tile. Only used by mod_tile. This option name is case-sensitive.

DESCRIPTION

Specify the description to be provided by mod_tile as TileJSON (via {URI}/tile-layer.json). Only used by mod_tile. This option name is case-sensitive.

htcphost

Specify the IP address/hostname of the HTCP Host to be used by renderd for HTCP cache expiry. Only used by renderd.

host

Specify the IP address/hostname of the Host to be used by renderd for HTCP cache expiry. Only used by renderd.

MAXZOOM

Specify the maximum zoom level for this section. The default value is '20' (macro definition 'MAX_ZOOM'). This option name is case-sensitive.

MINZOOM

Specify the minimum zoom level for this section. The default value is '0'. This option name is case-sensitive.

PARAMETERIZE_STYLE

Specify the parameterization style/function to be used for this section. The value of 'language' seems to be the only one supported. This option name is case-sensitive.

SERVER_ALIAS

Specify a URL alias of this server to be provided by mod_tile as TileJSON (via {URI}/tile-layer.json). Only used by mod_tile. This option name is case-sensitive.

scale

Specify the scale for this section. Only used by renderd. The default value is '1.0'.

TILEDIR

Specify the directory path into which tiles will be written by renderd. The default value is '/var/cache/renderd/tiles' (macro definition 'RENDERD_TILE_DIR'). This option name is case-sensitive.

tilesize

Specify the tile size for this section. Only used by renderd. The default value is '256'.

TYPE

Specify the tile configuration (in the format '<extension> <mime-type> <output-format>') for this section (e.g. 'png image/png png256'). This option name is case-sensitive.

URI

Specify the URI prefix with which tiles can be accessed for this section. This option name is case-sensitive.

xml

Specify the file path of the Mapnik configuration XML file for this section. Only used by renderd.

SEE ALSO¶

renderd(1)

AUTHOR¶

renderd was written by Jon Burgess, and other OpenStreetMap project members.

This manual page was written by OpenStreetMap authors.