Self-host
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.
| Setting | Variable | Settings key | Default | Values | What it does | Changes |
|---|---|---|---|---|---|---|
| Data directory | DEZFIL_DATA_DIR | ./data; /data in the container | A folder path | The single durable directory for tables, tiles and metadata. | By variable, after a restart | |
| Encryption key | DEZFIL_SECRET_KEY | generated | 64 hex characters (32 bytes) | The key that encrypts saved connection passwords and service addresses. | By variable, after a restart | |
| Tile builder | DEZFIL_TIPPECANOE | tippecanoe | A program name, looked up on PATH, or a path to the program | The program that builds vector tiles. | By variable, after a restart | |
| Image renderer | DEZFIL_CHROMIUM_PATH | /usr/bin/chromium | A path to a headless Chromium or Chrome | The 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 assecret.keyin 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