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

# render\_list(1)

renders a list of map tiles by sending requests to a rendering daemon.

## NAME

render\_list - renders a list of map tiles by sending requests to a rendering daemon.

## SYNOPSIS

**render\_list** \[*options*\] \< *render.list*

## DESCRIPTION

This manual page briefly documents the **render\_list** command.

**render\_list** is a helper utility that takes a list of map tiles from stdin and sends the requests to a rendering daemon

## OPTIONS

This program follows the usual GNU command line syntax, with long options starting with two dashes (\`-'). A summary of options is included below.

- **-a**\|--all

  Render all tiles in given zoom level range instead of reading from STDIN.

- **-c**\|--config=CONFIG

  Specify a \`renderd.conf\` file from which to load various option values rather than specifying via command line.

  The following options will be set (if present); however, they can be overridden if also specified:

  **-s**\|--socket

  **-n**\|--num-threads

  **-t**\|--tile-dir

  **-z**\|--min-zoom

  **-Z**\|--max-zoom

- **-f**\|--force

  Render tiles even if they seem current.

- **-m**\|--map=MAP

  Render tiles in this map (default is 'default').

- **-l**\|--max-load=LOAD

  Sleep if load is this high (default is '16').

- **-s**\|--socket=SOCKET\|HOSTNAME:PORT

  Unix domain socket name or hostname and port for contacting renderd (default is '/run/renderd/renderd.sock').

- **-n**\|--num-threads=N

  The number of parallel request threads (default is '1').

- **-t**\|--tile-dir=TILE\_DIR

  Tile cache directory (default is '/var/cache/renderd/tiles').

- **-z**\|--min-zoom=ZOOM

  Filter input to only render tiles greater than or equal to this zoom level (default is '0').

- **-Z**\|--max-zoom=ZOOM

  Filter input to only render tiles less than or equal to this zoom level (default is '20').

- **-h**\|--help

  Print out a help text for render\_list

- **-V**\|--version

  Print out the version number for render\_list

If you are using **-a**\|--all, you can restrict the tile range by adding these options:

(please note that tile coordinates must be positive integers and are not latitude and longitude values)

  **-g**\|--min-lat=LATITUDE   minimum latitude\
   **-G**\|--max-lat=LATITUDE   maximum latitude\
   **-w**\|--min-lon=LONGITUDE  minimum longitude\
   **-W**\|--max-lon=LONGITUDE  maximum longitude\
   **-x**\|--min-x=X            minimum X tile coordinate\
   **-X**\|--max-x=X            maximum X tile coordinate\
   **-y**\|--min-y=Y            minimum Y tile coordinate\
   **-Y**\|--max-y=Y            maximum Y tile coordinate

Without **-a**\|--all, send a list of tiles to be rendered from STDIN in the format:\
   X Y Z e.g.\
   0 0 1\
   0 1 1\
   1 0 1\
   1 1 1

The above would cause all 4 tiles at zoom 1 to be rendered

## SEE ALSO

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

## AUTHOR

render\_list was written by OpenStreetMap project members.

This manual page was written by OpenStreetMap authors.