Skip to content
DezfilDocsv0.1.0

Storage and programs

Set the data folder, the key that encrypts saved connection passwords and addresses, and the programs that build tiles and render images.

Each of these is a variable, read when the server starts. The System tab of Settings shows the value in effect.

SettingVariableSettings keyDefaultValuesWhat it doesChanges
Data directoryDEZFIL_DATA_DIR./data; /data in the containerA folder pathThe single durable directory for tables, tiles and metadata.By variable, after a restart
Encryption keyDEZFIL_SECRET_KEYgenerated64 hex characters (32 bytes)The key that encrypts saved connection passwords and service addresses.By variable, after a restart
Tile builderDEZFIL_TIPPECANOEtippecanoeA program name, looked up on PATH, or a path to the programThe program that builds vector tiles.By variable, after a restart
Image rendererDEZFIL_CHROMIUM_PATH/usr/bin/chromiumA path to a headless Chromium or ChromeThe headless browser that draws image exports and map pictures.By variable, after a restart
  • Without DEZFIL_SECRET_KEY, Dezfil makes a key the first time it needs one, such as when someone saves a connection password, and keeps it as secret.key in the data folder. Until then, System shows Not created yet. With a lost or changed key, Dezfil cannot read the saved connection passwords and service addresses. Back it up with the data, as Back up and restore says.
  • The image ships the tile builder and the image renderer where these defaults find them.
  • The data folder also holds the optional model catalogue file: see Offer other models.

Configuration shows how to set a variable.

Dezfil · Apache-2.0docs from 7439201b