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

# render\_expired(1)

expires a list of map tiles so that they get re-rendered.

## NAME

render\_expired - expires a list of map tiles so that they get re-rendered.

## SYNOPSIS

**render\_expired** \[*options*\] \< *expire.list*

## DESCRIPTION

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

**render\_expired** is a helper utility that takes a list of map tiles from stdin and expires them such that they will get re-rendered. Render\_expired has three potential strategies of how to expire map tiles: 1) Render tiles directly: Render\_expired can connect to the renderd socket and submit rendering requests for expired tiles directly 2) Delete tiles: Render\_expired can delete expired tiles from disk. The next time the tile then gets viewed it will get re-rendered, assuming a dynamic rendering setup like mod\_tile is installed 3) Mark tiles as dirty: A dynamic tile rendering system like mod\_tile decides if a tile needs re-rendering by comparing the timestamp of the tile with the time of the planet-import-complet timestamp. Render\_expired can set the timestamp of a tile back many years, ensuring it is older than the db import time, thus causeing the tile to be considered dirty and in need for re-render.

These three strategies can be combined and applied at different zoom levels. E.g. Zoom level 17-18 get deleted, z11 - z16 get marked dirty and z6 - z10 get rendered directly.

Render\_expired takes a list of tiles from stdin which should be expired. The format of the list is one tile per line specified as z/x/y.

1/0/1

1/1/1

1/0/0

1/1/0

render\_expired will automatically expand the list to cover the effected tiles at other zoom levels.

## OPTIONS

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

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

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

  Specify the style-sheet for which to expire tiles. The default is "default".

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

  Specify the location of the renderd socket or hostname and port to connect to.

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

  Specify the number of parallel requests to renderd. Should renderd have less threads active, requests will be queued. The default is 1.

- **-t**\|--tile-dir=DIR

  Specify the base directory where the rendered tiles are. The 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').

- **-d**\|--delete-from=ZOOM

  When expiring tiles of ZOOM or higher, delete them instead of re-rendering (default is off)

- **-T**\|--touch-from=ZOOM

  When expiring tiles of ZOOM or higher, touch them instead of re-rendering (default is off)

- **-N**\|--no-progress

  Disable display of progress messages (default is off)

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

  Print out a help text for render\_expired

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

  Print out the version number for render\_expired

## SEE ALSO

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

## AUTHOR

render\_expire was written by OpenStreetMap project members.

This manual page was written by OpenStreetMap authors.