---
name: "renderd.conf"
section: "5"
platform: "linux"
package: "renderd"
version: "0.8.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/renderd.conf"
---

# renderd.conf(5)

Configuration file of rendering daemon for rendering OpenStreetMap tiles.

## 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)](/renderd/1.md)**.

The default location is **'/etc/renderd.conf'** (macro definition **'RENDERD\_CONFIG'**).

All option names are **case-insensitive**.

## 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**. A value of **'-1'** will configure **num\_threads** to the number of cores on the system. 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'**.

- **aspecty**

  Specify the Y aspect to be used by **mod\_tile**. Only used by **mod\_tile**. The default value is **'1'**.

- **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'**).

- **cors**

  Specify the CORS configuration for **mod\_tile**. Only used by **mod\_tile**.

- **description**

  Specify the description to be provided by **mod\_tile** as **TileJSON** (via **{URI}/tile-layer.json**). Only used by **mod\_tile**.

- **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'**).

- **minzoom**

  Specify the minimum zoom level for this section. The default value is **'0'**.

- **parameterize\_style**

  Specify the parameterization style/function to be used for this section. The value of **'language'** seems to be the only one supported.

- **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**.

- **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'**).

- **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'**).

- **uri**

  Specify the URI prefix with which tiles can be accessed for this section.

- **xml**

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

## SEE ALSO

**[renderd(1)](/renderd/1.md)**

## AUTHOR

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

This manual page was written by OpenStreetMap authors.