[{"data":1,"prerenderedAt":8754},["ShallowReactive",2],{"page-\u002Fgetting-started\u002Fconfig":3},{"id":4,"title":5,"body":6,"description":8747,"extension":8748,"meta":8749,"navigation":3868,"path":8750,"seo":8751,"stem":8752,"__hash__":8753},"content\u002F1.getting-started\u002F3.config.md","Configuration reference",{"type":7,"value":8,"toc":8684},"minimark",[9,27,32,43,97,122,174,203,207,214,237,242,248,294,298,329,517,521,579,583,596,655,696,703,708,900,1242,1245,1266,1275,1329,1351,1373,1404,1412,1430,1467,1477,1481,1487,1559,1651,1656,1726,1731,1738,1821,1943,1946,1998,2003,2064,2070,2080,2084,2300,2304,2315,2325,2331,2346,2413,2427,2433,2464,2519,2526,2534,2537,2602,2613,2634,2648,2728,2737,2742,2747,2813,2816,2860,2911,2915,2918,2984,2991,3002,3009,3020,3038,3232,3238,3412,3422,3480,3490,3500,3510,3676,3686,3805,3813,4019,4117,4123,4176,4246,4252,4264,4317,4363,4377,4388,4395,4432,4484,4490,4497,4539,4609,4615,4618,4677,4762,4782,4788,4795,4846,4916,4919,4937,4944,4957,4963,4974,5036,5126,5133,5165,5169,5175,5356,5365,5372,5690,5711,5717,5733,5868,6077,6088,6098,6133,6187,6191,6198,6205,6208,6219,6225,6230,6348,6589,6593,6603,6626,6652,6661,6667,6949,6955,7093,7099,7147,7153,7264,7270,7473,7483,7490,7631,7636,7718,7724,7848,7852,7906,7909,7917,8024,8038,8041,8047,8131,8170,8174,8188,8370,8432,8442,8445,8449,8588,8592,8599,8649,8673,8680],[10,11,12,13,17,18,22,23,26],"p",{},"This page is the canonical reference for ",[14,15,16],"strong",{},"everything tileserver-rs reads"," —\nCLI flags, config keys (TOML or YAML), and environment variables — sourced directly\nfrom the Rust structs in ",[19,20,21],"code",{},"crates\u002Ftileserver-rs\u002Fsrc\u002Fconfig.rs"," and\n",[19,24,25],{},"crates\u002Ftileserver-rs\u002Fsrc\u002Fcli.rs",".",[28,29,31],"h2",{"id":30},"config-file-formats","Config file formats",[10,33,34,35,38,39,42],{},"tileserver-rs accepts both ",[14,36,37],{},"TOML"," and ",[14,40,41],{},"YAML"," config files. The format is\ndetected from the file extension:",[44,45,46,59],"table",{},[47,48,49],"thead",{},[50,51,52,56],"tr",{},[53,54,55],"th",{},"Extension",[53,57,58],{},"Parser",[60,61,62,73,86],"tbody",{},[50,63,64,70],{},[65,66,67],"td",{},[19,68,69],{},".toml",[65,71,72],{},"TOML (default)",[50,74,75,84],{},[65,76,77,80,81],{},[19,78,79],{},".yaml",", ",[19,82,83],{},".yml",[65,85,41],{},[50,87,88,94],{},[65,89,90],{},[91,92,93],"em",{},"anything else",[65,95,96],{},"TOML (fallthrough)",[10,98,99,100,103,104,113,114,121],{},"TOML and YAML produce identical ",[19,101,102],{},"Config"," structs — every option documented\non this page works in both formats. See ",[105,106,110],"a",{"href":107,"rel":108},"https:\u002F\u002Fgithub.com\u002Fvinayakkulkarni\u002Ftileserver-rs\u002Fblob\u002Fmain\u002Fdata\u002Fconfigs\u002Fexample.toml",[109],"nofollow",[19,111,112],{},"data\u002Fconfigs\u002Fexample.toml","\nfor the canonical exhaustively-commented reference and ",[105,115,118],{"href":116,"rel":117},"https:\u002F\u002Fgithub.com\u002Fvinayakkulkarni\u002Ftileserver-rs\u002Fblob\u002Fmain\u002Fdata\u002Fconfigs\u002Fexample.yaml",[109],[19,119,120],{},"data\u002Fconfigs\u002Fexample.yaml","\nfor the YAML syntax mirror.",[123,124,129],"pre",{"className":125,"code":126,"language":127,"meta":128,"style":128},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Either of these works:\ntileserver-rs --config config.toml\ntileserver-rs --config config.yaml\ntileserver-rs --config config.yml\n","bash","",[19,130,131,140,154,164],{"__ignoreMap":128},[132,133,136],"span",{"class":134,"line":135},"line",1,[132,137,139],{"class":138},"sHwdD","# Either of these works:\n",[132,141,143,147,151],{"class":134,"line":142},2,[132,144,146],{"class":145},"sBMFI","tileserver-rs",[132,148,150],{"class":149},"sfazB"," --config",[132,152,153],{"class":149}," config.toml\n",[132,155,157,159,161],{"class":134,"line":156},3,[132,158,146],{"class":145},[132,160,150],{"class":149},[132,162,163],{"class":149}," config.yaml\n",[132,165,167,169,171],{"class":134,"line":166},4,[132,168,146],{"class":145},[132,170,150],{"class":149},[132,172,173],{"class":149}," config.yml\n",[10,175,176,177,181,182,80,186,181,190,80,194,198,199,26],{},"For task-oriented guides see ",[105,178,180],{"href":179},"\u002Fgetting-started\u002Fquickstart","Quickstart",",\n",[105,183,185],{"href":184},"\u002Fguides\u002Fvector-tiles","Vector tiles",[105,187,189],{"href":188},"\u002Fguides\u002Fauto-detect","Auto-detect",[105,191,193],{"href":192},"\u002Fguides\u002Fpostgres-outdb-rasters","Postgres",[105,195,197],{"href":196},"\u002Fguides\u002Fmcp","MCP",", and\n",[105,200,202],{"href":201},"\u002Fguides\u002Ftelemetry","Telemetry",[28,204,206],{"id":205},"precedence","Precedence",[10,208,209,210,213],{},"When the same value is supplied in multiple places, ",[14,211,212],{},"later sources\noverride earlier ones",":",[215,216,217,221,228,234],"ol",{},[218,219,220],"li",{},"Hard-coded defaults (lowest priority)",[218,222,223,224,227],{},"Config file in TOML or YAML (",[19,225,226],{},"--config",")",[218,229,230,231,227],{},"Environment variables (",[19,232,233],{},"TILESERVER_*",[218,235,236],{},"CLI flags (highest priority)",[238,239,241],"h3",{"id":240},"config-file-lookup","Config file lookup",[10,243,244,245,247],{},"If ",[19,246,226],{}," is not provided, the server resolves what to load in this\norder:",[215,249,250,256,265,281],{},[218,251,252,255],{},[19,253,254],{},"--config \u003CFILE>"," — explicit config path (fails if the file does not exist)",[218,257,258,259,262,263,227],{},"Positional ",[19,260,261],{},"PATH"," — auto-detect sources\u002Fstyles from that path (see ",[105,264,189],{"href":188},[218,266,267,268,80,271,80,274,277,278],{},"Default locations, tried in order: ",[19,269,270],{},".\u002Fconfig.toml",[19,272,273],{},".\u002Fconfig.yaml",[19,275,276],{},".\u002Fconfig.yml",", then ",[19,279,280],{},"\u002Fetc\u002Ftileserver-rs\u002Fconfig.{toml,yaml,yml}",[218,282,283,284,80,287,80,290,293],{},"CWD auto-detect — scan the current directory for ",[19,285,286],{},".pmtiles",[19,288,289],{},".mbtiles",[19,291,292],{},"style.json",", and font directories",[28,295,297],{"id":296},"cli-flags","CLI flags",[123,299,301],{"className":125,"code":300,"language":127,"meta":128,"style":128},"tileserver-rs [OPTIONS] [PATH] [SUBCOMMAND]\n",[19,302,303],{"__ignoreMap":128},[132,304,305,307,311,315,317,320,323,326],{"class":134,"line":135},[132,306,146],{"class":145},[132,308,310],{"class":309},"sTEyZ"," [OPTIONS] ",[132,312,314],{"class":313},"sMK4o","[",[132,316,261],{"class":309},[132,318,319],{"class":313},"]",[132,321,322],{"class":313}," [",[132,324,325],{"class":309},"SUBCOMMAND",[132,327,328],{"class":313},"]\n",[44,330,331,347],{},[47,332,333],{},[50,334,335,338,341,344],{},[53,336,337],{},"Flag",[53,339,340],{},"Env fallback",[53,342,343],{},"Default",[53,345,346],{},"Description",[60,348,349,365,382,405,426,445,466,486,500],{},[50,350,351,357,360,362],{},[65,352,353,356],{},[19,354,355],{},"[PATH]"," (positional)",[65,358,359],{},"—",[65,361,359],{},[65,363,364],{},"File or directory to auto-detect sources\u002Fstyles from (zero-config mode)",[50,366,367,372,377,379],{},[65,368,369],{},[19,370,371],{},"-c, --config \u003CFILE>",[65,373,374],{},[19,375,376],{},"TILESERVER_CONFIG",[65,378,359],{},[65,380,381],{},"Path to TOML config file",[50,383,384,389,394,399],{},[65,385,386],{},[19,387,388],{},"--cache-dir \u003CPATH>",[65,390,391],{},[19,392,393],{},"TILESERVER_CACHE_DIR",[65,395,396],{},[19,397,398],{},"\u003Ctmp>\u002Ftileserver-rs",[65,400,401,402],{},"Scratch \u002F state directory (uploads, on-disk subsystems). Overrides ",[19,403,404],{},"[cache].dir",[50,406,407,412,417,423],{},[65,408,409],{},[19,410,411],{},"--host \u003CHOST>",[65,413,414],{},[19,415,416],{},"TILESERVER_HOST",[65,418,419,420],{},"from ",[19,421,422],{},"[server]",[65,424,425],{},"Override bind address",[50,427,428,433,438,442],{},[65,429,430],{},[19,431,432],{},"-p, --port \u003CPORT>",[65,434,435],{},[19,436,437],{},"TILESERVER_PORT",[65,439,419,440],{},[19,441,422],{},[65,443,444],{},"Override bind port",[50,446,447,452,457,459],{},[65,448,449],{},[19,450,451],{},"--public-url \u003CURL>",[65,453,454],{},[19,455,456],{},"TILESERVER_PUBLIC_URL",[65,458,359],{},[65,460,461,462,465],{},"Public URL embedded in TileJSON ",[19,463,464],{},"tiles"," entries",[50,467,468,473,478,483],{},[65,469,470],{},[19,471,472],{},"--ui",[65,474,475],{},[19,476,477],{},"TILESERVER_UI",[65,479,480],{},[19,481,482],{},"true",[65,484,485],{},"Serve the embedded SPA web UI",[50,487,488,493,495,497],{},[65,489,490],{},[19,491,492],{},"--no-ui",[65,494,359],{},[65,496,359],{},[65,498,499],{},"Disable the embedded SPA web UI",[50,501,502,507,509,514],{},[65,503,504],{},[19,505,506],{},"-v, --verbose",[65,508,359],{},[65,510,511],{},[19,512,513],{},"false",[65,515,516],{},"Increase log verbosity",[238,518,520],{"id":519},"subcommands","Subcommands",[44,522,523,535],{},[47,524,525],{},[50,526,527,530,533],{},[53,528,529],{},"Subcommand",[53,531,532],{},"Feature gate",[53,534,346],{},[60,536,537,549,567],{},[50,538,539,544,546],{},[65,540,541],{},[91,542,543],{},"(none)",[65,545,359],{},[65,547,548],{},"Run the HTTP server (default)",[50,550,551,556,561],{},[65,552,553],{},[19,554,555],{},"mcp-stdio",[65,557,558],{},[19,559,560],{},"mcp",[65,562,563,564,566],{},"Run the ",[105,565,197],{"href":196}," server over stdin\u002Fstdout for Claude Desktop and other local clients",[50,568,569,574,576],{},[65,570,571],{},[19,572,573],{},"inspect",[65,575,359],{},[65,577,578],{},"Print metadata, tile counts and layers of a PMTiles\u002FMBTiles archive, then exit (see below)",[238,580,581],{"id":573},[19,582,573],{},[10,584,585,586,588,589,591,592,595],{},"Describe an archive without starting the server. The target is a local\n",[19,587,286],{}," or ",[19,590,289],{}," file, or an ",[19,593,594],{},"http(s):\u002F\u002F"," PMTiles URL (read with\nrange requests, so only the header, metadata and the requested tile are\ndownloaded).",[123,597,599],{"className":125,"code":598,"language":127,"meta":128,"style":128},"tileserver-rs inspect data\u002Ftiles\u002Fprotomaps-sample.pmtiles\ntileserver-rs inspect data\u002Fzurich.mbtiles --verbose            # adds tiles per zoom\ntileserver-rs inspect data\u002Fzurich.mbtiles --tile 10\u002F536\u002F358    # decode one tile\ntileserver-rs inspect https:\u002F\u002Fexample.com\u002Fplanet.pmtiles --json\n",[19,600,601,611,626,643],{"__ignoreMap":128},[132,602,603,605,608],{"class":134,"line":135},[132,604,146],{"class":145},[132,606,607],{"class":149}," inspect",[132,609,610],{"class":149}," data\u002Ftiles\u002Fprotomaps-sample.pmtiles\n",[132,612,613,615,617,620,623],{"class":134,"line":142},[132,614,146],{"class":145},[132,616,607],{"class":149},[132,618,619],{"class":149}," data\u002Fzurich.mbtiles",[132,621,622],{"class":149}," --verbose",[132,624,625],{"class":138},"            # adds tiles per zoom\n",[132,627,628,630,632,634,637,640],{"class":134,"line":156},[132,629,146],{"class":145},[132,631,607],{"class":149},[132,633,619],{"class":149},[132,635,636],{"class":149}," --tile",[132,638,639],{"class":149}," 10\u002F536\u002F358",[132,641,642],{"class":138},"    # decode one tile\n",[132,644,645,647,649,652],{"class":134,"line":166},[132,646,146],{"class":145},[132,648,607],{"class":149},[132,650,651],{"class":149}," https:\u002F\u002Fexample.com\u002Fplanet.pmtiles",[132,653,654],{"class":149}," --json\n",[44,656,657,665],{},[47,658,659],{},[50,660,661,663],{},[53,662,337],{},[53,664,346],{},[60,666,667,677,686],{},[50,668,669,674],{},[65,670,671],{},[19,672,673],{},"--tile Z\u002FX\u002FY",[65,675,676],{},"Decode one tile (XYZ order). Vector tiles list each layer's feature count per geometry type and its property keys",[50,678,679,683],{},[65,680,681],{},[19,682,506],{},[65,684,685],{},"Count tiles per zoom level (MBTiles only: a PMTiles count needs every leaf directory)",[50,687,688,693],{},[65,689,690],{},[19,691,692],{},"--json",[65,694,695],{},"Print the report as JSON for scripts",[10,697,698,699,702],{},"The report shows the container (PMTiles version or MBTiles), tile type,\ncompression, file size, tile count (and unique tiles for PMTiles), zoom\nrange, bounds, center, name, description, attribution and the\n",[19,700,701],{},"vector_layers"," metadata. A missing file or URL exits with status 1.",[28,704,706],{"id":705},"server",[19,707,422],{},[123,709,713],{"className":710,"code":711,"language":712,"meta":128,"style":128},"language-toml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","[server]\nhost = \"0.0.0.0\"\nport = 8080\ncors_origins = [\"*\"]\nadmin_bind = \"127.0.0.1:0\"\npublic_url = \"https:\u002F\u002Ftiles.example.com\"   # optional\nupload_dir = \"\u002Fvar\u002Flib\u002Ftileserver\u002Fuploads\" # optional\nupload_max_size_mb = 500\nupload_max_total_mb = 5120\nupload_max_files = 100\ndisable_render = false                     # optional — turn off raster routes\ndisable_ogc = false                        # optional — turn off OGC API routes\nsubfolder_mode = \"proxy-strip\"             # optional — subfolder serving mode\n","toml",[19,714,715,723,740,751,770,785,803,821,832,843,854,869,882],{"__ignoreMap":128},[132,716,717,719,721],{"class":134,"line":135},[132,718,314],{"class":313},[132,720,705],{"class":145},[132,722,328],{"class":313},[132,724,725,728,731,734,737],{"class":134,"line":142},[132,726,727],{"class":309},"host ",[132,729,730],{"class":313},"=",[132,732,733],{"class":313}," \"",[132,735,736],{"class":149},"0.0.0.0",[132,738,739],{"class":313},"\"\n",[132,741,742,745,747],{"class":134,"line":156},[132,743,744],{"class":309},"port ",[132,746,730],{"class":313},[132,748,750],{"class":749},"sbssI"," 8080\n",[132,752,753,756,758,760,763,766,768],{"class":134,"line":166},[132,754,755],{"class":309},"cors_origins ",[132,757,730],{"class":313},[132,759,322],{"class":313},[132,761,762],{"class":313},"\"",[132,764,765],{"class":149},"*",[132,767,762],{"class":313},[132,769,328],{"class":313},[132,771,773,776,778,780,783],{"class":134,"line":772},5,[132,774,775],{"class":309},"admin_bind ",[132,777,730],{"class":313},[132,779,733],{"class":313},[132,781,782],{"class":149},"127.0.0.1:0",[132,784,739],{"class":313},[132,786,788,791,793,795,798,800],{"class":134,"line":787},6,[132,789,790],{"class":309},"public_url ",[132,792,730],{"class":313},[132,794,733],{"class":313},[132,796,797],{"class":149},"https:\u002F\u002Ftiles.example.com",[132,799,762],{"class":313},[132,801,802],{"class":138},"   # optional\n",[132,804,806,809,811,813,816,818],{"class":134,"line":805},7,[132,807,808],{"class":309},"upload_dir ",[132,810,730],{"class":313},[132,812,733],{"class":313},[132,814,815],{"class":149},"\u002Fvar\u002Flib\u002Ftileserver\u002Fuploads",[132,817,762],{"class":313},[132,819,820],{"class":138}," # optional\n",[132,822,824,827,829],{"class":134,"line":823},8,[132,825,826],{"class":309},"upload_max_size_mb ",[132,828,730],{"class":313},[132,830,831],{"class":749}," 500\n",[132,833,835,838,840],{"class":134,"line":834},9,[132,836,837],{"class":309},"upload_max_total_mb ",[132,839,730],{"class":313},[132,841,842],{"class":749}," 5120\n",[132,844,846,849,851],{"class":134,"line":845},10,[132,847,848],{"class":309},"upload_max_files ",[132,850,730],{"class":313},[132,852,853],{"class":749}," 100\n",[132,855,857,860,862,866],{"class":134,"line":856},11,[132,858,859],{"class":309},"disable_render ",[132,861,730],{"class":313},[132,863,865],{"class":864},"sfNiH"," false",[132,867,868],{"class":138},"                     # optional — turn off raster routes\n",[132,870,872,875,877,879],{"class":134,"line":871},12,[132,873,874],{"class":309},"disable_ogc ",[132,876,730],{"class":313},[132,878,865],{"class":864},[132,880,881],{"class":138},"                        # optional — turn off OGC API routes\n",[132,883,885,888,890,892,895,897],{"class":134,"line":884},13,[132,886,887],{"class":309},"subfolder_mode ",[132,889,730],{"class":313},[132,891,733],{"class":313},[132,893,894],{"class":149},"proxy-strip",[132,896,762],{"class":313},[132,898,899],{"class":138},"             # optional — subfolder serving mode\n",[44,901,902,916],{},[47,903,904],{},[50,905,906,909,912,914],{},[53,907,908],{},"Key",[53,910,911],{},"Type",[53,913,343],{},[53,915,346],{},[60,917,918,936,954,985,1017,1057,1074,1090,1108,1125,1142,1165,1188,1214],{},[50,919,920,925,928,933],{},[65,921,922],{},[19,923,924],{},"host",[65,926,927],{},"string",[65,929,930],{},[19,931,932],{},"\"0.0.0.0\"",[65,934,935],{},"Bind address for the public tile server",[50,937,938,943,946,951],{},[65,939,940],{},[19,941,942],{},"port",[65,944,945],{},"u16",[65,947,948],{},[19,949,950],{},"8080",[65,952,953],{},"Bind port for the public tile server",[50,955,956,961,965,970],{},[65,957,958],{},[19,959,960],{},"cors_origins",[65,962,927,963],{},[132,964],{},[65,966,967],{},[19,968,969],{},"[\"*\"]",[65,971,972,973,975,976,979,980,984],{},"CORS allow-list — supports literals, glob (",[19,974,765],{},"), and regex (",[19,977,978],{},"\u002F...\u002F","); see ",[105,981,983],{"href":982},"#corsoriginpatterns","Pattern syntax"," below",[50,986,987,992,994,999],{},[65,988,989],{},[19,990,991],{},"admin_bind",[65,993,927],{},[65,995,996],{},[19,997,998],{},"\"127.0.0.1:0\"",[65,1000,1001,1002,80,1005,1008,1009,1012,1013,1016],{},"Separate bind for admin endpoints (",[19,1003,1004],{},"\u002F__admin\u002Freload",[19,1006,1007],{},"\u002F__admin\u002Foauth\u002F*","). ",[19,1010,1011],{},":0"," disables. Use ",[19,1014,1015],{},"127.0.0.1:8081"," to enable.",[50,1018,1019,1024,1028,1033],{},[65,1020,1021],{},[19,1022,1023],{},"admin_allowed_hosts",[65,1025,927,1026],{},[132,1027],{},[65,1029,1030],{},[19,1031,1032],{},"[]",[65,1034,1035,1036,1039,1040,1043,1044,80,1047,80,1050,1053,1054,1056],{},"Extra ",[19,1037,1038],{},"Host","\u002F",[19,1041,1042],{},"Origin"," names the admin listener accepts besides loopback (",[19,1045,1046],{},"localhost",[19,1048,1049],{},"127.0.0.1",[19,1051,1052],{},"[::1]","). Other names get 403, which blocks DNS-rebinding and cross-site requests. Add your proxy's host if it forwards its own ",[19,1055,1038],{}," header",[50,1058,1059,1064,1067,1071],{},[65,1060,1061],{},[19,1062,1063],{},"public_url",[65,1065,1066],{},"string?",[65,1068,1069],{},[91,1070,543],{},[65,1072,1073],{},"Public URL embedded in TileJSON. Falls back to the bind address",[50,1075,1076,1081,1084,1087],{},[65,1077,1078],{},[19,1079,1080],{},"upload_dir",[65,1082,1083],{},"path?",[65,1085,1086],{},"system tmp",[65,1088,1089],{},"Directory for drag-and-drop uploads (creates a tmp source per upload)",[50,1091,1092,1097,1100,1105],{},[65,1093,1094],{},[19,1095,1096],{},"upload_max_size_mb",[65,1098,1099],{},"u32",[65,1101,1102],{},[19,1103,1104],{},"500",[65,1106,1107],{},"Maximum per-file upload size in megabytes. Larger uploads get 413 and leave no file behind",[50,1109,1110,1115,1117,1122],{},[65,1111,1112],{},[19,1113,1114],{},"upload_max_total_mb",[65,1116,1099],{},[65,1118,1119],{},[19,1120,1121],{},"5120",[65,1123,1124],{},"Total disk space all uploaded files may use, in megabytes",[50,1126,1127,1132,1134,1139],{},[65,1128,1129],{},[19,1130,1131],{},"upload_max_files",[65,1133,1099],{},[65,1135,1136],{},[19,1137,1138],{},"100",[65,1140,1141],{},"Maximum number of uploaded files kept at once",[50,1143,1144,1149,1152,1156],{},[65,1145,1146],{},[19,1147,1148],{},"extra_response_headers",[65,1150,1151],{},"table?",[65,1153,1154],{},[91,1155,543],{},[65,1157,1158,1159,984],{},"User-defined response headers applied to every HTTP response — see ",[105,1160,1162],{"href":1161},"#serverextra_response_headers",[19,1163,1164],{},"[server.extra_response_headers]",[50,1166,1167,1172,1175,1179],{},[65,1168,1169],{},[19,1170,1171],{},"disable_render",[65,1173,1174],{},"bool",[65,1176,1177],{},[19,1178,513],{},[65,1180,1181,1182,1184,1185,26],{},"Unregister raster render routes (raster tiles + static images) at startup. Style metadata (",[19,1183,292],{},", sprites, WMTS) stays served. Disabled routes return ",[19,1186,1187],{},"404",[50,1189,1190,1195,1197,1201],{},[65,1191,1192],{},[19,1193,1194],{},"disable_ogc",[65,1196,1174],{},[65,1198,1199],{},[19,1200,513],{},[65,1202,1203,1204,1207,1208,1211,1212,26],{},"Unregister OGC API routes (",[19,1205,1206],{},"\u002Fogc\u002F*",") at startup. No effect unless built with the ",[19,1209,1210],{},"ogc"," feature. Disabled routes return ",[19,1213,1187],{},[50,1215,1216,1221,1230,1234],{},[65,1217,1218],{},[19,1219,1220],{},"subfolder_mode",[65,1222,1223,1226,1227],{},[19,1224,1225],{},"\"proxy-strip\""," | ",[19,1228,1229],{},"\"nested\"",[65,1231,1232],{},[19,1233,1225],{},[65,1235,1236,1237,1241],{},"How the embedded GUI + API are served under a URL subfolder — see ",[105,1238,1240],{"href":1239},"#subfolder-deployment","Subfolder deployment"," below. Ignored for root deployments.",[238,1243,1240],{"id":1244},"subfolder-deployment",[10,1246,1247,1248,1251,1252,1255,1256,1259,1260,1262,1263,1265],{},"By default the server assumes it is mounted at the domain root (",[19,1249,1250],{},"https:\u002F\u002Ftiles.example.com\u002F","). To serve it under a ",[14,1253,1254],{},"URL subfolder"," (e.g. ",[19,1257,1258],{},"https:\u002F\u002Fexample.com\u002Fmaps\u002F","), set the subfolder path in ",[19,1261,1063],{}," — the server derives the base path from it and rebases the embedded GUI (asset URLs, API calls, and the Vue Router base) at startup, so no client rebuild is needed. A root deployment (no subfolder in ",[19,1264,1063],{},") serves byte-identical embedded assets, so this feature is a no-op unless you opt in.",[10,1267,1268,1270,1271,1274],{},[19,1269,1220],{}," chooses ",[14,1272,1273],{},"where the subfolder prefix is stripped"," from incoming request paths:",[44,1276,1277,1290],{},[47,1278,1279],{},[50,1280,1281,1284,1287],{},[53,1282,1283],{},"Mode",[53,1285,1286],{},"Who strips the prefix",[53,1288,1289],{},"Reverse-proxy config",[60,1291,1292,1314],{},[50,1293,1294,1302,1305],{},[65,1295,1296,1298,1299],{},[19,1297,1225],{}," ",[91,1300,1301],{},"(default)",[65,1303,1304],{},"The reverse proxy",[65,1306,1307,1310,1311,227],{},[19,1308,1309],{},"proxy_pass http:\u002F\u002Fbackend\u002F;"," (trailing slash strips ",[19,1312,1313],{},"\u002Fmaps",[50,1315,1316,1320,1323],{},[65,1317,1318],{},[19,1319,1229],{},[65,1321,1322],{},"The server itself",[65,1324,1325,1328],{},[19,1326,1327],{},"proxy_pass http:\u002F\u002Fbackend;"," (no trailing slash — prefix forwarded intact)",[10,1330,1331,1336,1337,1339,1340,80,1343,1346,1347,1350],{},[14,1332,1333,1335],{},[19,1334,894],{}," (default)"," — the reverse proxy removes the ",[19,1338,1313],{}," prefix before forwarding, so the server sees root paths (",[19,1341,1342],{},"\u002Fping",[19,1344,1345],{},"\u002F_nuxt\u002Fx.js","). The GUI is still rebased so the browser requests ",[19,1348,1349],{},"\u002Fmaps\u002F..."," URLs.",[123,1352,1356],{"className":1353,"code":1354,"language":1355,"meta":128,"style":128},"language-nginx shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","location \u002Fmaps\u002F {\n    proxy_pass http:\u002F\u002F127.0.0.1:8080\u002F;   # trailing slash strips \u002Fmaps\n}\n","nginx",[19,1357,1358,1363,1368],{"__ignoreMap":128},[132,1359,1360],{"class":134,"line":135},[132,1361,1362],{},"location \u002Fmaps\u002F {\n",[132,1364,1365],{"class":134,"line":142},[132,1366,1367],{},"    proxy_pass http:\u002F\u002F127.0.0.1:8080\u002F;   # trailing slash strips \u002Fmaps\n",[132,1369,1370],{"class":134,"line":156},[132,1371,1372],{},"}\n",[123,1374,1376],{"className":710,"code":1375,"language":712,"meta":128,"style":128},"[server]\npublic_url = \"https:\u002F\u002Fexample.com\u002Fmaps\"\n# subfolder_mode defaults to \"proxy-strip\"\n",[19,1377,1378,1386,1399],{"__ignoreMap":128},[132,1379,1380,1382,1384],{"class":134,"line":135},[132,1381,314],{"class":313},[132,1383,705],{"class":145},[132,1385,328],{"class":313},[132,1387,1388,1390,1392,1394,1397],{"class":134,"line":142},[132,1389,790],{"class":309},[132,1391,730],{"class":313},[132,1393,733],{"class":313},[132,1395,1396],{"class":149},"https:\u002F\u002Fexample.com\u002Fmaps",[132,1398,739],{"class":313},[132,1400,1401],{"class":134,"line":156},[132,1402,1403],{"class":138},"# subfolder_mode defaults to \"proxy-strip\"\n",[10,1405,1406,1411],{},[14,1407,1408],{},[19,1409,1410],{},"nested"," — the proxy forwards the prefix untouched and the server strips it itself. Useful when the proxy cannot rewrite the path, or for testing a subfolder locally with no proxy at all.",[123,1413,1415],{"className":1353,"code":1414,"language":1355,"meta":128,"style":128},"location \u002Fmaps\u002F {\n    proxy_pass http:\u002F\u002F127.0.0.1:8080;    # no trailing slash — prefix forwarded\n}\n",[19,1416,1417,1421,1426],{"__ignoreMap":128},[132,1418,1419],{"class":134,"line":135},[132,1420,1362],{},[132,1422,1423],{"class":134,"line":142},[132,1424,1425],{},"    proxy_pass http:\u002F\u002F127.0.0.1:8080;    # no trailing slash — prefix forwarded\n",[132,1427,1428],{"class":134,"line":156},[132,1429,1372],{},[123,1431,1433],{"className":710,"code":1432,"language":712,"meta":128,"style":128},"[server]\npublic_url = \"https:\u002F\u002Fexample.com\u002Fmaps\"\nsubfolder_mode = \"nested\"\n",[19,1434,1435,1443,1455],{"__ignoreMap":128},[132,1436,1437,1439,1441],{"class":134,"line":135},[132,1438,314],{"class":313},[132,1440,705],{"class":145},[132,1442,328],{"class":313},[132,1444,1445,1447,1449,1451,1453],{"class":134,"line":142},[132,1446,790],{"class":309},[132,1448,730],{"class":313},[132,1450,733],{"class":313},[132,1452,1396],{"class":149},[132,1454,739],{"class":313},[132,1456,1457,1459,1461,1463,1465],{"class":134,"line":156},[132,1458,887],{"class":309},[132,1460,730],{"class":313},[132,1462,733],{"class":313},[132,1464,1410],{"class":149},[132,1466,739],{"class":313},[10,1468,1469,1470,1472,1473,1476],{},"With ",[19,1471,1410],{}," the server responds directly at ",[19,1474,1475],{},"http:\u002F\u002F127.0.0.1:8080\u002Fmaps\u002F"," — you can verify a subfolder deployment end-to-end with no proxy.",[238,1478,1480],{"id":1479},"cors-origin-patterns","CORS origin patterns",[10,1482,1483,1484,1486],{},"The ",[19,1485,960],{}," list accepts three syntaxes, dispatched per entry:",[44,1488,1489,1499],{},[47,1490,1491],{},[50,1492,1493,1496],{},[53,1494,1495],{},"Entry syntax",[53,1497,1498],{},"Interpretation",[60,1500,1501,1511,1521,1534,1546],{},[50,1502,1503,1508],{},[65,1504,1505],{},[19,1506,1507],{},"\"*\"",[65,1509,1510],{},"Wildcard — allow any origin (default; emits a startup warning)",[50,1512,1513,1518],{},[65,1514,1515],{},[19,1516,1517],{},"\"https:\u002F\u002Fexample.com\"",[65,1519,1520],{},"Exact literal match (unchanged from previous behaviour)",[50,1522,1523,1528],{},[65,1524,1525],{},[19,1526,1527],{},"\"*.example.com\"",[65,1529,1530,1531,1533],{},"Glob — ",[19,1532,765],{}," matches one or more characters in the Origin URL",[50,1535,1536,1541],{},[65,1537,1538],{},[19,1539,1540],{},"\"preview-*.example.com\"",[65,1542,1530,1543,1545],{},[19,1544,765],{}," can appear anywhere in the pattern",[50,1547,1548,1553],{},[65,1549,1550],{},[19,1551,1552],{},"\"\u002F^https:\u002F\u002F.+\\\\.example\\\\.com$\u002F\"",[65,1554,1555,1556,1558],{},"Regex — enclosed in ",[19,1557,978],{},", matched against the full Origin",[123,1560,1562],{"className":710,"code":1561,"language":712,"meta":128,"style":128},"[server]\ncors_origins = [\n  \"https:\u002F\u002Fexample.com\",\n  \"*.cdn.example.com\",\n  \"preview-*.example.com\",\n  \"\u002F^https:\u002F\u002F.+\\\\.team-[a-z0-9]+\\\\.app\\\\.example\\\\.com$\u002F\",\n]\n",[19,1563,1564,1572,1581,1593,1604,1615,1647],{"__ignoreMap":128},[132,1565,1566,1568,1570],{"class":134,"line":135},[132,1567,314],{"class":313},[132,1569,705],{"class":145},[132,1571,328],{"class":313},[132,1573,1574,1576,1578],{"class":134,"line":142},[132,1575,755],{"class":309},[132,1577,730],{"class":313},[132,1579,1580],{"class":313}," [\n",[132,1582,1583,1586,1589,1591],{"class":134,"line":156},[132,1584,1585],{"class":313},"  \"",[132,1587,1588],{"class":149},"https:\u002F\u002Fexample.com",[132,1590,762],{"class":313},[132,1592,181],{"class":313},[132,1594,1595,1597,1600,1602],{"class":134,"line":166},[132,1596,1585],{"class":313},[132,1598,1599],{"class":149},"*.cdn.example.com",[132,1601,762],{"class":313},[132,1603,181],{"class":313},[132,1605,1606,1608,1611,1613],{"class":134,"line":772},[132,1607,1585],{"class":313},[132,1609,1610],{"class":149},"preview-*.example.com",[132,1612,762],{"class":313},[132,1614,181],{"class":313},[132,1616,1617,1619,1622,1625,1628,1630,1633,1635,1638,1640,1643,1645],{"class":134,"line":787},[132,1618,1585],{"class":313},[132,1620,1621],{"class":149},"\u002F^https:\u002F\u002F.+",[132,1623,1624],{"class":309},"\\\\",[132,1626,1627],{"class":149},".team-[a-z0-9]+",[132,1629,1624],{"class":309},[132,1631,1632],{"class":149},".app",[132,1634,1624],{"class":309},[132,1636,1637],{"class":149},".example",[132,1639,1624],{"class":309},[132,1641,1642],{"class":149},".com$\u002F",[132,1644,762],{"class":313},[132,1646,181],{"class":313},[132,1648,1649],{"class":134,"line":805},[132,1650,328],{"class":313},[10,1652,1653],{},[14,1654,1655],{},"Notes:",[215,1657,1658,1661,1667,1683,1693],{},[218,1659,1660],{},"Entries are tried in order; the first match short-circuits per request.",[218,1662,1663,1664,1666],{},"A list containing ",[19,1665,1507],{}," ALWAYS resolves to wildcard regardless of other entries — that is the existing semantics, preserved.",[218,1668,1669,1670,1672,1673,1675,1676,1679,1680,26],{},"Pure-literal lists (no ",[19,1671,765],{},", no ",[19,1674,978],{},") use the same allocation-free ",[19,1677,1678],{},"AllowOrigin::list"," fast-path as before. Adding a glob or regex switches the layer to ",[19,1681,1682],{},"AllowOrigin::predicate",[218,1684,1685,1686,1688,1689,1692],{},"Invalid regex (e.g. unbalanced ",[19,1687,314],{},") ",[14,1690,1691],{},"fails fast at startup"," with the offending entry quoted in the error.",[218,1694,1695,1696,1699,1700,1702,1703,1706,1707,1710,1711,38,1714,1717,1718,1721,1722,1725],{},"Glob entries are compiled by anchoring with ",[19,1697,1698],{},"^...$"," and replacing ",[19,1701,765],{}," with ",[19,1704,1705],{},".*"," — so ",[19,1708,1709],{},"*.x.com"," matches ",[19,1712,1713],{},"foo.x.com",[19,1715,1716],{},"https:\u002F\u002Ffoo.x.com",", but NOT ",[19,1719,1720],{},"x.com"," (no leading subdomain) or ",[19,1723,1724],{},"foo.x.com.evil.com"," (suffix injection blocked).",[238,1727,1729],{"id":1728},"serverextra_response_headers",[19,1730,1164],{},[10,1732,1733,1734,1737],{},"A user-defined map of HTTP response headers that are applied (in\n",[19,1735,1736],{},"SetResponseHeaderLayer::overriding"," mode) to every response served by\ntileserver-rs — tile, style, OGC, admin, MCP, everything. Useful for:",[44,1739,1740,1750],{},[47,1741,1742],{},[50,1743,1744,1747],{},[53,1745,1746],{},"Use case",[53,1748,1749],{},"Example header",[60,1751,1752,1765,1776,1786,1796,1806],{},[50,1753,1754,1757],{},[65,1755,1756],{},"Edge \u002F CDN cache control",[65,1758,1759,80,1762],{},[19,1760,1761],{},"CDN-Cache-Control",[19,1763,1764],{},"Surrogate-Control",[50,1766,1767,1770],{},[65,1768,1769],{},"Browser cache control",[65,1771,1772,1775],{},[19,1773,1774],{},"Cache-Control"," (overrides any default)",[50,1777,1778,1781],{},[65,1779,1780],{},"Block search-engine indexing",[65,1782,1783],{},[19,1784,1785],{},"X-Robots-Tag: noindex, nofollow",[50,1787,1788,1791],{},[65,1789,1790],{},"HSTS for TLS terminators",[65,1792,1793],{},[19,1794,1795],{},"Strict-Transport-Security",[50,1797,1798,1801],{},[65,1799,1800],{},"Content security",[65,1802,1803],{},[19,1804,1805],{},"X-Content-Type-Options: nosniff",[50,1807,1808,1811],{},[65,1809,1810],{},"APM correlation",[65,1812,1813,1816,1817,1820],{},[19,1814,1815],{},"Server-Timing",", custom ",[19,1818,1819],{},"X-*"," audit headers",[123,1822,1824],{"className":710,"code":1823,"language":712,"meta":128,"style":128},"[server.extra_response_headers]\n\"Cache-Control\" = \"public, max-age=86400, immutable\"\n\"CDN-Cache-Control\" = \"max-age=604800\"\n\"X-Robots-Tag\" = \"noindex, nofollow\"\n\"X-Content-Type-Options\" = \"nosniff\"\n\"Strict-Transport-Security\" = \"max-age=31536000; includeSubDomains\"\n\"Server-Timing\" = \"tileserver;dur=0\"\n",[19,1825,1826,1838,1856,1873,1891,1909,1926],{"__ignoreMap":128},[132,1827,1828,1830,1832,1834,1836],{"class":134,"line":135},[132,1829,314],{"class":313},[132,1831,705],{"class":145},[132,1833,26],{"class":309},[132,1835,1148],{"class":145},[132,1837,328],{"class":313},[132,1839,1840,1842,1844,1846,1849,1851,1854],{"class":134,"line":142},[132,1841,762],{"class":313},[132,1843,1774],{"class":309},[132,1845,762],{"class":313},[132,1847,1848],{"class":313}," =",[132,1850,733],{"class":313},[132,1852,1853],{"class":149},"public, max-age=86400, immutable",[132,1855,739],{"class":313},[132,1857,1858,1860,1862,1864,1866,1868,1871],{"class":134,"line":156},[132,1859,762],{"class":313},[132,1861,1761],{"class":309},[132,1863,762],{"class":313},[132,1865,1848],{"class":313},[132,1867,733],{"class":313},[132,1869,1870],{"class":149},"max-age=604800",[132,1872,739],{"class":313},[132,1874,1875,1877,1880,1882,1884,1886,1889],{"class":134,"line":166},[132,1876,762],{"class":313},[132,1878,1879],{"class":309},"X-Robots-Tag",[132,1881,762],{"class":313},[132,1883,1848],{"class":313},[132,1885,733],{"class":313},[132,1887,1888],{"class":149},"noindex, nofollow",[132,1890,739],{"class":313},[132,1892,1893,1895,1898,1900,1902,1904,1907],{"class":134,"line":772},[132,1894,762],{"class":313},[132,1896,1897],{"class":309},"X-Content-Type-Options",[132,1899,762],{"class":313},[132,1901,1848],{"class":313},[132,1903,733],{"class":313},[132,1905,1906],{"class":149},"nosniff",[132,1908,739],{"class":313},[132,1910,1911,1913,1915,1917,1919,1921,1924],{"class":134,"line":787},[132,1912,762],{"class":313},[132,1914,1795],{"class":309},[132,1916,762],{"class":313},[132,1918,1848],{"class":313},[132,1920,733],{"class":313},[132,1922,1923],{"class":149},"max-age=31536000; includeSubDomains",[132,1925,739],{"class":313},[132,1927,1928,1930,1932,1934,1936,1938,1941],{"class":134,"line":805},[132,1929,762],{"class":313},[132,1931,1815],{"class":309},[132,1933,762],{"class":313},[132,1935,1848],{"class":313},[132,1937,733],{"class":313},[132,1939,1940],{"class":149},"tileserver;dur=0",[132,1942,739],{"class":313},[10,1944,1945],{},"Equivalent YAML:",[123,1947,1951],{"className":1948,"code":1949,"language":1950,"meta":128,"style":128},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","server:\n  extra_response_headers:\n    Cache-Control: public, max-age=86400, immutable\n    CDN-Cache-Control: max-age=604800\n    X-Robots-Tag: noindex, nofollow\n","yaml",[19,1952,1953,1961,1968,1978,1988],{"__ignoreMap":128},[132,1954,1955,1958],{"class":134,"line":135},[132,1956,705],{"class":1957},"swJcz",[132,1959,1960],{"class":313},":\n",[132,1962,1963,1966],{"class":134,"line":142},[132,1964,1965],{"class":1957},"  extra_response_headers",[132,1967,1960],{"class":313},[132,1969,1970,1973,1975],{"class":134,"line":156},[132,1971,1972],{"class":1957},"    Cache-Control",[132,1974,213],{"class":313},[132,1976,1977],{"class":149}," public, max-age=86400, immutable\n",[132,1979,1980,1983,1985],{"class":134,"line":166},[132,1981,1982],{"class":1957},"    CDN-Cache-Control",[132,1984,213],{"class":313},[132,1986,1987],{"class":149}," max-age=604800\n",[132,1989,1990,1993,1995],{"class":134,"line":772},[132,1991,1992],{"class":1957},"    X-Robots-Tag",[132,1994,213],{"class":313},[132,1996,1997],{"class":149}," noindex, nofollow\n",[10,1999,2000],{},[14,2001,2002],{},"Rules:",[215,2004,2005,2016,2036,2050,2057],{},[218,2006,2007,2008,2011,2012,2015],{},"Header names must conform to ",[14,2009,2010],{},"RFC 7230 token grammar"," (alphanumeric + ",[19,2013,2014],{},"!#$%&'*+-.^_\\","|~`).",[218,2017,2018,2019,80,2022,80,2025,80,2028,2031,2032,2035],{},"The transport-managed headers ",[19,2020,2021],{},"Content-Length",[19,2023,2024],{},"Transfer-Encoding",[19,2026,2027],{},"Date",[19,2029,2030],{},"Connection"," are ",[14,2033,2034],{},"rejected at startup"," — the server fails fast.",[218,2037,2038,2039,1688,2042,2045,2046,2049],{},"An empty string value (",[19,2040,2041],{},"\"X-Foo\" = \"\"",[14,2043,2044],{},"removes"," any pre-existing ",[19,2047,2048],{},"X-Foo"," header from outgoing responses.",[218,2051,2052,2053,2056],{},"User values are ",[19,2054,2055],{},"overriding"," — they win over anything an upstream middleware emits.",[218,2058,2059,2060,2063],{},"Hot reload (",[19,2061,2062],{},"POST \u002F__admin\u002Freload",") picks up changes without a restart.",[28,2065,2067],{"id":2066},"sources",[19,2068,2069],{},"[[sources]]",[10,2071,2072,2073,2075,2076,2079],{},"Each ",[19,2074,2069],{}," block configures one tile source. The ",[19,2077,2078],{},"type"," field\ndetermines which optional fields are read.",[238,2081,2083],{"id":2082},"common-fields","Common fields",[44,2085,2086,2099],{},[47,2087,2088],{},[50,2089,2090,2092,2094,2097],{},[53,2091,908],{},[53,2093,911],{},[53,2095,2096],{},"Required",[53,2098,346],{},[60,2100,2101,2120,2159,2187,2202,2216,2230,2245,2259,2282],{},[50,2102,2103,2108,2110,2113],{},[65,2104,2105],{},[19,2106,2107],{},"id",[65,2109,927],{},[65,2111,2112],{},"yes",[65,2114,2115,2116,2119],{},"Unique identifier (becomes ",[19,2117,2118],{},"\u002Fdata\u002F\u003Cid>\u002F*"," route)",[50,2121,2122,2126,2129,2131],{},[65,2123,2124],{},[19,2125,2078],{},[65,2127,2128],{},"enum",[65,2130,2112],{},[65,2132,2133,2134,80,2137,80,2140,80,2143,80,2146,80,2149,80,2152,80,2155,2158],{},"One of: ",[19,2135,2136],{},"pmtiles",[19,2138,2139],{},"mbtiles",[19,2141,2142],{},"postgres",[19,2144,2145],{},"cog",[19,2147,2148],{},"vrt",[19,2150,2151],{},"geoparquet",[19,2153,2154],{},"duckdb",[19,2156,2157],{},"stac"," (some feature-gated)",[50,2160,2161,2166,2168,2170],{},[65,2162,2163],{},[19,2164,2165],{},"path",[65,2167,927],{},[65,2169,2112],{},[65,2171,2172,2173,80,2176,80,2179,2182,2183,2186],{},"File path, HTTP(S) URL, cloud URL (",[19,2174,2175],{},"s3:\u002F\u002F",[19,2177,2178],{},"gs:\u002F\u002F",[19,2180,2181],{},"az:\u002F\u002F","), or SFTP URL (",[19,2184,2185],{},"sftp:\u002F\u002F",", feature-gated)",[50,2188,2189,2194,2196,2199],{},[65,2190,2191],{},[19,2192,2193],{},"name",[65,2195,1066],{},[65,2197,2198],{},"no",[65,2200,2201],{},"Display name shown in the viewer",[50,2203,2204,2209,2211,2213],{},[65,2205,2206],{},[19,2207,2208],{},"attribution",[65,2210,1066],{},[65,2212,2198],{},[65,2214,2215],{},"Attribution text included in TileJSON",[50,2217,2218,2223,2225,2227],{},[65,2219,2220],{},[19,2221,2222],{},"description",[65,2224,1066],{},[65,2226,2198],{},[65,2228,2229],{},"Free-form description",[50,2231,2232,2237,2240,2242],{},[65,2233,2234],{},[19,2235,2236],{},"minzoom",[65,2238,2239],{},"u8?",[65,2241,2198],{},[65,2243,2244],{},"Override the minzoom from source metadata",[50,2246,2247,2252,2254,2256],{},[65,2248,2249],{},[19,2250,2251],{},"maxzoom",[65,2253,2239],{},[65,2255,2198],{},[65,2257,2258],{},"Override the maxzoom from source metadata",[50,2260,2261,2266,2269,2271],{},[65,2262,2263],{},[19,2264,2265],{},"serve_as",[65,2267,2268],{},"enum?",[65,2270,2198],{},[65,2272,2273,2274,2277,2278,2281],{},"Transcode on the fly. E.g. ",[19,2275,2276],{},"serve_as = \"mlt\""," on a PBF source emits MLT. Requires ",[19,2279,2280],{},"mlt"," feature",[50,2283,2284,2289,2291,2293],{},[65,2285,2286],{},[19,2287,2288],{},"options",[65,2290,44],{},[65,2292,2198],{},[65,2294,2295,2296],{},"Key-value map forwarded to cloud backends (S3 credentials, GCS keys, etc.) — see ",[105,2297,2299],{"href":2298},"#cloud-sources","Cloud sources",[238,2301,2303],{"id":2302},"type-specific-fields","Type-specific fields",[2305,2306,2308,2311,2312],"h4",{"id":2307},"type-pmtiles-type-mbtiles",[19,2309,2310],{},"type = \"pmtiles\""," \u002F ",[19,2313,2314],{},"type = \"mbtiles\"",[10,2316,2317,2318,80,2320,2322,2323,26],{},"These read all metadata (zoom range, bounds, layers) from the file itself.\nNo extra config needed beyond ",[19,2319,2107],{},[19,2321,2078],{},", and ",[19,2324,2165],{},[2305,2326,2328],{"id":2327},"type-dir",[19,2329,2330],{},"type = \"dir\"",[10,2332,2333,2334,2337,2338,2341,2342,2345],{},"Serve a ",[19,2335,2336],{},"{z}\u002F{x}\u002F{y}.{ext}"," pyramid straight from disk — no PMTiles\u002FMBTiles\npackaging step. The lowest-friction source: point it at tippecanoe\n",[19,2339,2340],{},"--output-to-directory"," output, a ",[19,2343,2344],{},"wget --recursive"," mirror, or any on-disk\npyramid. Zero startup index cost; every tile fetch is a direct filesystem read.",[123,2347,2349],{"className":710,"code":2348,"language":712,"meta":128,"style":128},"[[sources]]\nid = \"tippecanoe-output\"\ntype = \"dir\"\npath = \"\u002Fdata\u002Ftiles\u002Fopenmaptiles\u002F\"\n# tile_path_template = \"{z}\u002F{x}\u002F{y}@2x.png\"  # optional, default {z}\u002F{x}\u002F{y}.{ext}\n# tms = true                                  # optional, default false (XYZ)\n",[19,2350,2351,2361,2375,2389,2403,2408],{"__ignoreMap":128},[132,2352,2353,2356,2358],{"class":134,"line":135},[132,2354,2355],{"class":313},"[[",[132,2357,2066],{"class":145},[132,2359,2360],{"class":313},"]]\n",[132,2362,2363,2366,2368,2370,2373],{"class":134,"line":142},[132,2364,2365],{"class":309},"id ",[132,2367,730],{"class":313},[132,2369,733],{"class":313},[132,2371,2372],{"class":149},"tippecanoe-output",[132,2374,739],{"class":313},[132,2376,2377,2380,2382,2384,2387],{"class":134,"line":156},[132,2378,2379],{"class":309},"type ",[132,2381,730],{"class":313},[132,2383,733],{"class":313},[132,2385,2386],{"class":149},"dir",[132,2388,739],{"class":313},[132,2390,2391,2394,2396,2398,2401],{"class":134,"line":166},[132,2392,2393],{"class":309},"path ",[132,2395,730],{"class":313},[132,2397,733],{"class":313},[132,2399,2400],{"class":149},"\u002Fdata\u002Ftiles\u002Fopenmaptiles\u002F",[132,2402,739],{"class":313},[132,2404,2405],{"class":134,"line":772},[132,2406,2407],{"class":138},"# tile_path_template = \"{z}\u002F{x}\u002F{y}@2x.png\"  # optional, default {z}\u002F{x}\u002F{y}.{ext}\n",[132,2409,2410],{"class":134,"line":787},[132,2411,2412],{"class":138},"# tms = true                                  # optional, default false (XYZ)\n",[10,2414,2415,80,2417,2322,2419,2422,2423,2426],{},[19,2416,2236],{},[19,2418,2251],{},[19,2420,2421],{},"bounds"," are derived lazily by walking the directory\non the first TileJSON request, then cached. Missing tiles behave like every\nother source. For tilesets with millions of files, the natural\n",[19,2424,2425],{},"{z}\u002F{x}\u002F{y}"," sharding keeps per-directory entry counts manageable.",[2305,2428,2430],{"id":2429},"type-tar",[19,2431,2432],{},"type = \"tar\"",[10,2434,2333,2435,2438,2439,2441,2442,2445,2446,2449,2450,80,2452,2311,2455,80,2458,80,2461,26],{},[19,2436,2437],{},".tar"," bundle of ",[19,2440,2336],{}," tiles — a single portable file,\nideal for airgapped \u002F offline \u002F ",[19,2443,2444],{},"scp","-everywhere deployments. The archive is\ndecompressed once at startup and an in-memory ",[19,2447,2448],{},"(z, x, y)"," index is built; tiles\nare then served via random access. Compression is auto-detected by extension:\n",[19,2451,2437],{},[19,2453,2454],{},".tar.gz",[19,2456,2457],{},".tgz",[19,2459,2460],{},".tar.br",[19,2462,2463],{},".tar.zst",[123,2465,2467],{"className":710,"code":2466,"language":712,"meta":128,"style":128},"[[sources]]\nid = \"regional-tiles\"\ntype = \"tar\"\npath = \"\u002Fdata\u002Ftiles.tar.gz\"  # or .tar \u002F .tar.br \u002F .tar.zst\n",[19,2468,2469,2477,2490,2503],{"__ignoreMap":128},[132,2470,2471,2473,2475],{"class":134,"line":135},[132,2472,2355],{"class":313},[132,2474,2066],{"class":145},[132,2476,2360],{"class":313},[132,2478,2479,2481,2483,2485,2488],{"class":134,"line":142},[132,2480,2365],{"class":309},[132,2482,730],{"class":313},[132,2484,733],{"class":313},[132,2486,2487],{"class":149},"regional-tiles",[132,2489,739],{"class":313},[132,2491,2492,2494,2496,2498,2501],{"class":134,"line":156},[132,2493,2379],{"class":309},[132,2495,730],{"class":313},[132,2497,733],{"class":313},[132,2499,2500],{"class":149},"tar",[132,2502,739],{"class":313},[132,2504,2505,2507,2509,2511,2514,2516],{"class":134,"line":166},[132,2506,2393],{"class":309},[132,2508,730],{"class":313},[132,2510,733],{"class":313},[132,2512,2513],{"class":149},"\u002Fdata\u002Ftiles.tar.gz",[132,2515,762],{"class":313},[132,2517,2518],{"class":138},"  # or .tar \u002F .tar.br \u002F .tar.zst\n",[10,2520,2521,2522,2525],{},"Vector layer metadata is introspected from the first MVT tile, exactly like the\nPMTiles source. ",[14,2523,2524],{},"Tradeoff:"," the whole archive is held resident in memory\n(the index alone is ~16 bytes per tile). For planet-scale tilesets, PMTiles\nremains the production choice — its hierarchical directory avoids keeping every\ntile in memory.",[2305,2527,2529,2311,2531,2533],{"id":2528},"dir-tar-shared-options",[19,2530,2386],{},[19,2532,2500],{}," shared options",[10,2535,2536],{},"Both filesystem-style sources accept two extra fields:",[44,2538,2539,2550],{},[47,2540,2541],{},[50,2542,2543,2546,2548],{},[53,2544,2545],{},"Option",[53,2547,343],{},[53,2549,346],{},[60,2551,2552,2583],{},[50,2553,2554,2559,2563],{},[65,2555,2556],{},[19,2557,2558],{},"tile_path_template",[65,2560,2561],{},[19,2562,2336],{},[65,2564,2565,2566,80,2569,80,2572,2575,2576,2579,2580,26],{},"Layout template. Must contain ",[19,2567,2568],{},"{z}",[19,2570,2571],{},"{x}",[19,2573,2574],{},"{y}","; ",[19,2577,2578],{},"{ext}"," is optional. Example: ",[19,2581,2582],{},"{z}\u002F{x}\u002F{y}@2x.png",[50,2584,2585,2590,2594],{},[65,2586,2587],{},[19,2588,2589],{},"tms",[65,2591,2592],{},[19,2593,513],{},[65,2595,2596,2598,2599,2601],{},[19,2597,482],{}," flips the Y axis for TMS (south-up) archives. Default ",[19,2600,513],{}," serves XYZ (north-up), what tippecanoe emits and web clients expect.",[2305,2603,2605,1298,2608],{"id":2604},"type-postgres-feature-postgres",[19,2606,2607],{},"type = \"postgres\"",[91,2609,2610,2611,227],{},"(feature: ",[19,2612,2142],{},[10,2614,2615,2616,2619,2620,2623,2624,2630,2631,26],{},"Combines the common fields with one of two patterns: ",[14,2617,2618],{},"functions"," or\n",[14,2621,2622],{},"tables",". Defined inside the top-level ",[105,2625,2627],{"href":2626},"#postgres",[19,2628,2629],{},"[postgres]"," block,\nnot directly on the source. See the ",[105,2632,2633],{"href":192},"PostGIS guide",[2305,2635,2637,2311,2640,1298,2643],{"id":2636},"type-cog-type-vrt-feature-raster",[19,2638,2639],{},"type = \"cog\"",[19,2641,2642],{},"type = \"vrt\"",[91,2644,2610,2645,227],{},[19,2646,2647],{},"raster",[44,2649,2650,2662],{},[47,2651,2652],{},[50,2653,2654,2656,2658,2660],{},[53,2655,908],{},[53,2657,911],{},[53,2659,343],{},[53,2661,346],{},[60,2663,2664,2708],{},[50,2665,2666,2671,2673,2678],{},[65,2667,2668],{},[19,2669,2670],{},"resampling",[65,2672,2268],{},[65,2674,2675],{},[19,2676,2677],{},"bilinear",[65,2679,2680,2681,80,2684,80,2686,80,2689,80,2692,80,2695,80,2698,2701,2702,2705,2706],{},"GDAL warp resampler. One of: ",[19,2682,2683],{},"nearest",[19,2685,2677],{},[19,2687,2688],{},"cubic",[19,2690,2691],{},"cubicspline",[19,2693,2694],{},"lanczos",[19,2696,2697],{},"average",[19,2699,2700],{},"mode",". With a ",[19,2703,2704],{},"discrete"," colormap the default is ",[19,2707,2683],{},[50,2709,2710,2715,2717,2721],{},[65,2711,2712],{},[19,2713,2714],{},"colormap",[65,2716,1151],{},[65,2718,2719],{},[91,2720,543],{},[65,2722,2723,2724,984],{},"See ",[105,2725,2727],{"href":2726},"#colormap","ColorMap",[10,2729,2730,2731,2733,2734,2736],{},"In v2.39.0 and earlier, ",[19,2732,2670],{}," had no effect on COG, VRT, DEM, STAC and\nPostGIS out-db tiles: GDAL always warped them with ",[19,2735,2677],{},". The setting\nnow selects the warp algorithm.",[2738,2739,2741],"h5",{"id":2740},"remote-paths","Remote paths",[10,2743,2744,2746],{},[19,2745,2165],{}," can be a local file or a remote file. Remote paths use these forms:",[44,2748,2749,2759],{},[47,2750,2751],{},[50,2752,2753,2756],{},[53,2754,2755],{},"You write",[53,2757,2758],{},"GDAL opens",[60,2760,2761,2773,2785,2797],{},[50,2762,2763,2768],{},[65,2764,2765],{},[19,2766,2767],{},"https:\u002F\u002Fhost\u002Ffile.tif",[65,2769,2770],{},[19,2771,2772],{},"\u002Fvsicurl\u002Fhttps:\u002F\u002Fhost\u002Ffile.tif",[50,2774,2775,2780],{},[65,2776,2777],{},[19,2778,2779],{},"http:\u002F\u002Fhost\u002Ffile.tif",[65,2781,2782],{},[19,2783,2784],{},"\u002Fvsicurl\u002Fhttp:\u002F\u002Fhost\u002Ffile.tif",[50,2786,2787,2792],{},[65,2788,2789],{},[19,2790,2791],{},"s3:\u002F\u002Fbucket\u002Ffile.tif",[65,2793,2794],{},[19,2795,2796],{},"\u002Fvsis3\u002Fbucket\u002Ffile.tif",[50,2798,2799,2810],{},[65,2800,2801,80,2804,80,2807],{},[19,2802,2803],{},"\u002Fvsicurl\u002F…",[19,2805,2806],{},"\u002Fvsis3\u002F…",[19,2808,2809],{},"\u002Fvsigs\u002F…",[65,2811,2812],{},"the path as written",[10,2814,2815],{},"tileserver-rs adds the GDAL prefix for you. With the prefix, GDAL reads only the\nbyte ranges that a tile needs. Without it, GDAL downloads the full file each time\nit opens the file.",[2817,2818,2819,2826,2845],"ul",{},[218,2820,2821,2822,2825],{},"The server that hosts the file must support HTTP range requests (",[19,2823,2824],{},"Accept-Ranges: bytes",").",[218,2827,2828,2830,2831,80,2834,80,2837,2840,2841,2844],{},[19,2829,2175],{}," paths use the standard GDAL credentials (",[19,2832,2833],{},"AWS_ACCESS_KEY_ID",[19,2835,2836],{},"AWS_SECRET_ACCESS_KEY",[19,2838,2839],{},"AWS_REGION",", or ",[19,2842,2843],{},"AWS_NO_SIGN_REQUEST=YES"," for public buckets).",[218,2846,2847,2848,588,2850,2852,2853,80,2856,2859],{},"Other schemes (for example ",[19,2849,2178],{},[19,2851,2181],{},") are not rewritten. Write the GDAL prefix (",[19,2854,2855],{},"\u002Fvsigs\u002F",[19,2857,2858],{},"\u002Fvsiaz\u002F",") yourself.",[123,2861,2863],{"className":710,"code":2862,"language":712,"meta":128,"style":128},"[[sources]]\nid = \"sentinel\"\ntype = \"cog\"\npath = \"https:\u002F\u002Fexample.com\u002Fimagery\u002FTCI.tif\"\n",[19,2864,2865,2873,2886,2898],{"__ignoreMap":128},[132,2866,2867,2869,2871],{"class":134,"line":135},[132,2868,2355],{"class":313},[132,2870,2066],{"class":145},[132,2872,2360],{"class":313},[132,2874,2875,2877,2879,2881,2884],{"class":134,"line":142},[132,2876,2365],{"class":309},[132,2878,730],{"class":313},[132,2880,733],{"class":313},[132,2882,2883],{"class":149},"sentinel",[132,2885,739],{"class":313},[132,2887,2888,2890,2892,2894,2896],{"class":134,"line":156},[132,2889,2379],{"class":309},[132,2891,730],{"class":313},[132,2893,733],{"class":313},[132,2895,2145],{"class":149},[132,2897,739],{"class":313},[132,2899,2900,2902,2904,2906,2909],{"class":134,"line":166},[132,2901,2393],{"class":309},[132,2903,730],{"class":313},[132,2905,733],{"class":313},[132,2907,2908],{"class":149},"https:\u002F\u002Fexample.com\u002Fimagery\u002FTCI.tif",[132,2910,739],{"class":313},[2738,2912,2914],{"id":2913},"bands-and-transparency","Bands and transparency",[10,2916,2917],{},"The number of source bands sets the colour and the transparency of each tile:",[44,2919,2920,2933],{},[47,2921,2922],{},[50,2923,2924,2927,2930],{},[53,2925,2926],{},"Source bands",[53,2928,2929],{},"Tile colour",[53,2931,2932],{},"Tile transparency",[60,2934,2935,2948,2961,2973],{},[50,2936,2937,2942,2945],{},[65,2938,2939,2940],{},"1, with ",[19,2941,2714],{},[65,2943,2944],{},"colour from the colormap",[65,2946,2947],{},"from the colormap colour",[50,2949,2950,2955,2958],{},[65,2951,2952,2953],{},"1, no ",[19,2954,2714],{},[65,2956,2957],{},"gray",[65,2959,2960],{},"opaque",[50,2962,2963,2968,2971],{},[65,2964,2965,2966],{},"2, no ",[19,2967,2714],{},[65,2969,2970],{},"band 1 = red, band 2 = green",[65,2972,2960],{},[50,2974,2975,2978,2981],{},[65,2976,2977],{},"3 or more",[65,2979,2980],{},"bands 1–3 = red, green, blue",[65,2982,2983],{},"from the source data (see below)",[10,2985,2986,2987,2990],{},"For 3 or more bands, GDAL calculates the alpha while it warps the tile\n(the same as ",[19,2988,2989],{},"gdalwarp -dstalpha"," and TiTiler):",[2817,2992,2993,2996,2999],{},[218,2994,2995],{},"Pixels outside the source data are transparent.",[218,2997,2998],{},"If the last source band is an alpha band (for example an RGBA COG), the tile keeps that alpha.",[218,3000,3001],{},"Other bands after band 3 are not used.",[3003,3004,3006],"alert",{"type":3005},"info",[10,3007,3008],{},"In v2.39.0 and earlier, RGB tiles were opaque black outside the source data,\nRGBA tiles were fully transparent, and 2-band tiles were fully transparent.",[2305,3010,3012,1298,3015],{"id":3011},"type-dem-feature-dem",[19,3013,3014],{},"type = \"dem\"",[91,3016,2610,3017,227],{},[19,3018,3019],{},"dem",[10,3021,3022,3023,588,3026,3029,3030,3033,3034,3037],{},"Reads float elevation from a GDAL raster (COG \u002F GeoTIFF) and re-encodes each\npixel as a ",[14,3024,3025],{},"Terrarium",[14,3027,3028],{},"Mapbox-RGB"," (",[19,3031,3032],{},"terrain-rgb",") PNG tile that\nMapLibre GL JS consumes directly as a ",[19,3035,3036],{},"raster-dem"," source for 3D terrain,\nhillshading, and contour generation. Both encodings are bit-exact to what\nMapLibre decodes.",[44,3039,3040,3052],{},[47,3041,3042],{},[50,3043,3044,3046,3048,3050],{},[53,3045,908],{},[53,3047,911],{},[53,3049,343],{},[53,3051,346],{},[60,3053,3054,3078,3098,3124,3142,3163,3182,3215],{},[50,3055,3056,3060,3062,3066],{},[65,3057,3058],{},[19,3059,2165],{},[65,3061,1066],{},[65,3063,3064],{},[91,3065,543],{},[65,3067,3068,3069,3073,3074,3077],{},"Source GDAL raster: a local file or a ",[105,3070,3072],{"href":3071},"#remote-paths","remote path",". Omit when ",[19,3075,3076],{},"input_source"," is set",[50,3079,3080,3084,3086,3090],{},[65,3081,3082],{},[19,3083,3076],{},[65,3085,1066],{},[65,3087,3088],{},[91,3089,543],{},[65,3091,3092,3093,1039,3095,3097],{},"Id of another already-loaded ",[19,3094,2145],{},[19,3096,2148],{}," source to read elevation from. Shares its cached GDAL dataset (no re-open)",[50,3099,3100,3105,3107,3112],{},[65,3101,3102],{},[19,3103,3104],{},"dem_encoding",[65,3106,2268],{},[65,3108,3109],{},[19,3110,3111],{},"terrarium",[65,3113,3114,3116,3117,3120,3121,3123],{},[19,3115,3111],{}," (precision 1\u002F256 m) or ",[19,3118,3119],{},"mapbox_rgb"," (legacy ",[19,3122,3032],{},", precision 0.1 m)",[50,3125,3126,3131,3134,3139],{},[65,3127,3128],{},[19,3129,3130],{},"dem_band",[65,3132,3133],{},"u32?",[65,3135,3136],{},[19,3137,3138],{},"1",[65,3140,3141],{},"1-indexed GDAL band to encode",[50,3143,3144,3149,3152,3157],{},[65,3145,3146],{},[19,3147,3148],{},"dem_scale",[65,3150,3151],{},"f64?",[65,3153,3154],{},[19,3155,3156],{},"1.0",[65,3158,3159,3160,227],{},"Multiplier applied to elevation before encoding (e.g. feet → metres: ",[19,3161,3162],{},"0.3048",[50,3164,3165,3170,3172,3177],{},[65,3166,3167],{},[19,3168,3169],{},"dem_offset",[65,3171,3151],{},[65,3173,3174],{},[19,3175,3176],{},"0.0",[65,3178,3179,3180],{},"Additive offset applied after ",[19,3181,3148],{},[50,3183,3184,3189,3196,3201],{},[65,3185,3186],{},[19,3187,3188],{},"dem_nodata_color",[65,3190,3191,3192,3195],{},"u8",[132,3193,3194],{},"4","?",[65,3197,3198],{},[91,3199,3200],{},"(per-enc.)",[65,3202,3203,3204,3207,3208,3211,3212],{},"RGBA sentinel for nodata pixels. MapLibre ",[14,3205,3206],{},"ignores alpha",", so the RGB encodes \"no data\". Mapbox default ",[19,3209,3210],{},"[1,134,160]",", Terrarium ",[19,3213,3214],{},"[0,0,0]",[50,3216,3217,3221,3223,3227],{},[65,3218,3219],{},[19,3220,2670],{},[65,3222,2268],{},[65,3224,3225],{},[19,3226,2677],{},[65,3228,3229,3230],{},"Same GDAL resampler set as ",[19,3231,2145],{},[10,3233,3234,3235,3237],{},"Use it in a style as a ",[19,3236,3036],{}," source:",[123,3239,3243],{"className":3240,"code":3241,"language":3242,"meta":128,"style":128},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"sources\": {\n    \"terrain\": {\n      \"type\": \"raster-dem\",\n      \"tiles\": [\"https:\u002F\u002Ftiles.example.com\u002Fdata\u002Fterrain-terrarium\u002F{z}\u002F{x}\u002F{y}.png\"],\n      \"encoding\": \"terrarium\",\n      \"tileSize\": 256\n    }\n  },\n  \"terrain\": { \"source\": \"terrain\", \"exaggeration\": 1.5 }\n}\n","json",[19,3244,3245,3250,3264,3278,3297,3319,3338,3352,3357,3362,3408],{"__ignoreMap":128},[132,3246,3247],{"class":134,"line":135},[132,3248,3249],{"class":313},"{\n",[132,3251,3252,3254,3257,3259,3261],{"class":134,"line":142},[132,3253,1585],{"class":313},[132,3255,2066],{"class":3256},"spNyl",[132,3258,762],{"class":313},[132,3260,213],{"class":313},[132,3262,3263],{"class":313}," {\n",[132,3265,3266,3269,3272,3274,3276],{"class":134,"line":156},[132,3267,3268],{"class":313},"    \"",[132,3270,3271],{"class":145},"terrain",[132,3273,762],{"class":313},[132,3275,213],{"class":313},[132,3277,3263],{"class":313},[132,3279,3280,3283,3285,3287,3289,3291,3293,3295],{"class":134,"line":166},[132,3281,3282],{"class":313},"      \"",[132,3284,2078],{"class":749},[132,3286,762],{"class":313},[132,3288,213],{"class":313},[132,3290,733],{"class":313},[132,3292,3036],{"class":149},[132,3294,762],{"class":313},[132,3296,181],{"class":313},[132,3298,3299,3301,3303,3305,3307,3309,3311,3314,3316],{"class":134,"line":772},[132,3300,3282],{"class":313},[132,3302,464],{"class":749},[132,3304,762],{"class":313},[132,3306,213],{"class":313},[132,3308,322],{"class":313},[132,3310,762],{"class":313},[132,3312,3313],{"class":149},"https:\u002F\u002Ftiles.example.com\u002Fdata\u002Fterrain-terrarium\u002F{z}\u002F{x}\u002F{y}.png",[132,3315,762],{"class":313},[132,3317,3318],{"class":313},"],\n",[132,3320,3321,3323,3326,3328,3330,3332,3334,3336],{"class":134,"line":787},[132,3322,3282],{"class":313},[132,3324,3325],{"class":749},"encoding",[132,3327,762],{"class":313},[132,3329,213],{"class":313},[132,3331,733],{"class":313},[132,3333,3111],{"class":149},[132,3335,762],{"class":313},[132,3337,181],{"class":313},[132,3339,3340,3342,3345,3347,3349],{"class":134,"line":805},[132,3341,3282],{"class":313},[132,3343,3344],{"class":749},"tileSize",[132,3346,762],{"class":313},[132,3348,213],{"class":313},[132,3350,3351],{"class":749}," 256\n",[132,3353,3354],{"class":134,"line":823},[132,3355,3356],{"class":313},"    }\n",[132,3358,3359],{"class":134,"line":834},[132,3360,3361],{"class":313},"  },\n",[132,3363,3364,3366,3368,3370,3372,3375,3377,3380,3382,3384,3386,3388,3390,3393,3395,3398,3400,3402,3405],{"class":134,"line":845},[132,3365,1585],{"class":313},[132,3367,3271],{"class":3256},[132,3369,762],{"class":313},[132,3371,213],{"class":313},[132,3373,3374],{"class":313}," {",[132,3376,733],{"class":313},[132,3378,3379],{"class":145},"source",[132,3381,762],{"class":313},[132,3383,213],{"class":313},[132,3385,733],{"class":313},[132,3387,3271],{"class":149},[132,3389,762],{"class":313},[132,3391,3392],{"class":313},",",[132,3394,733],{"class":313},[132,3396,3397],{"class":145},"exaggeration",[132,3399,762],{"class":313},[132,3401,213],{"class":313},[132,3403,3404],{"class":749}," 1.5",[132,3406,3407],{"class":313}," }\n",[132,3409,3410],{"class":134,"line":856},[132,3411,1372],{"class":313},[2305,3413,3415,1298,3418],{"id":3414},"type-geoparquet-feature-geoparquet",[19,3416,3417],{},"type = \"geoparquet\"",[91,3419,2610,3420,227],{},[19,3421,2151],{},[44,3423,3424,3436],{},[47,3425,3426],{},[50,3427,3428,3430,3432,3434],{},[53,3429,908],{},[53,3431,911],{},[53,3433,2096],{},[53,3435,346],{},[60,3437,3438,3452,3466],{},[50,3439,3440,3445,3447,3449],{},[65,3441,3442],{},[19,3443,3444],{},"layer_name",[65,3446,1066],{},[65,3448,2198],{},[65,3450,3451],{},"Override the layer name in emitted MVT tiles",[50,3453,3454,3459,3461,3463],{},[65,3455,3456],{},[19,3457,3458],{},"geometry_column",[65,3460,1066],{},[65,3462,2198],{},[65,3464,3465],{},"Geometry column name (auto-detected when GeoParquet metadata is present)",[50,3467,3468,3473,3475,3477],{},[65,3469,3470],{},[19,3471,3472],{},"query",[65,3474,1066],{},[65,3476,2198],{},[65,3478,3479],{},"DuckDB SQL filter applied before tile materialization",[2305,3481,3483,1298,3486],{"id":3482},"type-duckdb-feature-duckdb",[19,3484,3485],{},"type = \"duckdb\"",[91,3487,2610,3488,227],{},[19,3489,2154],{},[10,3491,3492,3493,80,3495,80,3497,3499],{},"Same ",[19,3494,3444],{},[19,3496,3458],{},[19,3498,3472],{}," as GeoParquet.",[2305,3501,3503,1298,3506],{"id":3502},"type-stac-feature-stac",[19,3504,3505],{},"type = \"stac\"",[91,3507,2610,3508,227],{},[19,3509,2157],{},[44,3511,3512,3524],{},[47,3513,3514],{},[50,3515,3516,3518,3520,3522],{},[53,3517,908],{},[53,3519,911],{},[53,3521,343],{},[53,3523,346],{},[60,3525,3526,3542,3567,3583,3603,3622,3643],{},[50,3527,3528,3533,3535,3539],{},[65,3529,3530],{},[19,3531,3532],{},"collection",[65,3534,1066],{},[65,3536,3537],{},[91,3538,543],{},[65,3540,3541],{},"STAC collection ID",[50,3543,3544,3549,3551,3556],{},[65,3545,3546],{},[19,3547,3548],{},"asset_role",[65,3550,927],{},[65,3552,3553],{},[19,3554,3555],{},"\"visual\"",[65,3557,3558,3559,80,3561,80,3564,227],{},"Which asset role to render (e.g. ",[19,3560,3555],{},[19,3562,3563],{},"\"thumbnail\"",[19,3565,3566],{},"\"data\"",[50,3568,3569,3574,3576,3580],{},[65,3570,3571],{},[19,3572,3573],{},"dynamic",[65,3575,1174],{},[65,3577,3578],{},[19,3579,513],{},[65,3581,3582],{},"Enable on-demand STAC search per tile request (vs. one-time discovery at startup)",[50,3584,3585,3590,3593,3597],{},[65,3586,3587],{},[19,3588,3589],{},"max_items",[65,3591,3592],{},"usize",[65,3594,3595],{},[19,3596,1138],{},[65,3598,3599,3600],{},"Max items considered per tile request when ",[19,3601,3602],{},"dynamic = true",[50,3604,3605,3610,3615,3619],{},[65,3606,3607],{},[19,3608,3609],{},"stac_bbox",[65,3611,3612,3613,3195],{},"f64",[132,3614,3194],{},[65,3616,3617],{},[91,3618,543],{},[65,3620,3621],{},"Override the bbox passed to STAC search",[50,3623,3624,3629,3631,3636],{},[65,3625,3626],{},[19,3627,3628],{},"pixel_selection",[65,3630,2128],{},[65,3632,3633],{},[19,3634,3635],{},"first",[65,3637,3638,3639],{},"Mosaic strategy. See ",[105,3640,3642],{"href":3641},"#pixel-selection","Pixel selection",[50,3644,3645,3650,3652,3657],{},[65,3646,3647],{},[19,3648,3649],{},"options.allow_local_hrefs",[65,3651,927],{},[65,3653,3654],{},[91,3655,3656],{},"(unset)",[65,3658,3659,3662,3663,3666,3667,80,3670,588,3673,3675],{},[19,3660,3661],{},"\"true\""," lets a remote (",[19,3664,3665],{},"http(s)",") catalog point at local paths, ",[19,3668,3669],{},"file:",[19,3671,3672],{},"\u002Fvsi…",[19,3674,2175],{}," assets. Off by default: such hrefs from a remote catalog are skipped, so a catalog cannot make the server open its own files. A local catalog file is always trusted",[238,3677,3679,3680],{"id":3678},"pixel-selection-feature-stac-or-raster","Pixel selection ",[91,3681,2610,3682,588,3684,227],{},[19,3683,2157],{},[19,3685,2647],{},[44,3687,3688,3700],{},[47,3689,3690],{},[50,3691,3692,3695,3698],{},[53,3693,3694],{},"Variant",[53,3696,3697],{},"Short-circuit",[53,3699,346],{},[60,3701,3702,3715,3727,3739,3751,3763,3775,3787],{},[50,3703,3704,3710,3712],{},[65,3705,3706,1298,3708],{},[19,3707,3635],{},[91,3709,1301],{},[65,3711,2112],{},[65,3713,3714],{},"First valid pixel wins. Lowest latency",[50,3716,3717,3722,3724],{},[65,3718,3719],{},[19,3720,3721],{},"highest",[65,3723,2198],{},[65,3725,3726],{},"Per-pixel max across all bands. Highlights bright features",[50,3728,3729,3734,3736],{},[65,3730,3731],{},[19,3732,3733],{},"lowest",[65,3735,2198],{},[65,3737,3738],{},"Per-pixel min. Highlights shadows",[50,3740,3741,3746,3748],{},[65,3742,3743],{},[19,3744,3745],{},"mean",[65,3747,2198],{},[65,3749,3750],{},"Per-pixel arithmetic mean",[50,3752,3753,3758,3760],{},[65,3754,3755],{},[19,3756,3757],{},"median",[65,3759,2198],{},[65,3761,3762],{},"Per-pixel median. Robust to outliers",[50,3764,3765,3770,3772],{},[65,3766,3767],{},[19,3768,3769],{},"stdev",[65,3771,2198],{},[65,3773,3774],{},"Per-pixel std-dev. Change detection",[50,3776,3777,3782,3784],{},[65,3778,3779],{},[19,3780,3781],{},"count",[65,3783,2198],{},[65,3785,3786],{},"Per-pixel valid-input count (debug viz, encodes count in red channel)",[50,3788,3789,3794,3796],{},[65,3790,3791],{},[19,3792,3793],{},"lowestcloudcover",[65,3795,2112],{},[65,3797,3798,3799,277,3802,3804],{},"Pick the STAC asset with lowest ",[19,3800,3801],{},"eo:cloud_cover",[19,3803,3635],{}," ordering",[238,3806,3808,3809],{"id":3807},"colormap-feature-raster","ColorMap ",[91,3810,2610,3811,227],{},[19,3812,2647],{},[123,3814,3816],{"className":710,"code":3815,"language":712,"meta":128,"style":128},"[[sources]]\nid = \"ndvi\"\ntype = \"cog\"\npath = \"\u002Fdata\u002Fndvi.tif\"\n\n[sources.colormap]\ntype = \"discrete\"        # or \"continuous\"\nrescale_mode = \"static\"  # or \"dynamic\" \u002F \"none\"\nnodata_color = \"#00000000\"\n\n[[sources.colormap.entries]]\nvalue = -1.0\ncolor = \"#0033cc\"\n\n[[sources.colormap.entries]]\nvalue = 0.0\ncolor = \"#888888\"\n",[19,3817,3818,3826,3839,3851,3864,3870,3882,3897,3914,3928,3932,3949,3959,3973,3978,3995,4005],{"__ignoreMap":128},[132,3819,3820,3822,3824],{"class":134,"line":135},[132,3821,2355],{"class":313},[132,3823,2066],{"class":145},[132,3825,2360],{"class":313},[132,3827,3828,3830,3832,3834,3837],{"class":134,"line":142},[132,3829,2365],{"class":309},[132,3831,730],{"class":313},[132,3833,733],{"class":313},[132,3835,3836],{"class":149},"ndvi",[132,3838,739],{"class":313},[132,3840,3841,3843,3845,3847,3849],{"class":134,"line":156},[132,3842,2379],{"class":309},[132,3844,730],{"class":313},[132,3846,733],{"class":313},[132,3848,2145],{"class":149},[132,3850,739],{"class":313},[132,3852,3853,3855,3857,3859,3862],{"class":134,"line":166},[132,3854,2393],{"class":309},[132,3856,730],{"class":313},[132,3858,733],{"class":313},[132,3860,3861],{"class":149},"\u002Fdata\u002Fndvi.tif",[132,3863,739],{"class":313},[132,3865,3866],{"class":134,"line":772},[132,3867,3869],{"emptyLinePlaceholder":3868},true,"\n",[132,3871,3872,3874,3876,3878,3880],{"class":134,"line":787},[132,3873,314],{"class":313},[132,3875,2066],{"class":145},[132,3877,26],{"class":309},[132,3879,2714],{"class":145},[132,3881,328],{"class":313},[132,3883,3884,3886,3888,3890,3892,3894],{"class":134,"line":805},[132,3885,2379],{"class":309},[132,3887,730],{"class":313},[132,3889,733],{"class":313},[132,3891,2704],{"class":149},[132,3893,762],{"class":313},[132,3895,3896],{"class":138},"        # or \"continuous\"\n",[132,3898,3899,3902,3904,3906,3909,3911],{"class":134,"line":823},[132,3900,3901],{"class":309},"rescale_mode ",[132,3903,730],{"class":313},[132,3905,733],{"class":313},[132,3907,3908],{"class":149},"static",[132,3910,762],{"class":313},[132,3912,3913],{"class":138},"  # or \"dynamic\" \u002F \"none\"\n",[132,3915,3916,3919,3921,3923,3926],{"class":134,"line":834},[132,3917,3918],{"class":309},"nodata_color ",[132,3920,730],{"class":313},[132,3922,733],{"class":313},[132,3924,3925],{"class":149},"#00000000",[132,3927,739],{"class":313},[132,3929,3930],{"class":134,"line":845},[132,3931,3869],{"emptyLinePlaceholder":3868},[132,3933,3934,3936,3938,3940,3942,3944,3947],{"class":134,"line":856},[132,3935,2355],{"class":313},[132,3937,2066],{"class":145},[132,3939,26],{"class":309},[132,3941,2714],{"class":145},[132,3943,26],{"class":309},[132,3945,3946],{"class":145},"entries",[132,3948,2360],{"class":313},[132,3950,3951,3954,3956],{"class":134,"line":871},[132,3952,3953],{"class":309},"value ",[132,3955,730],{"class":313},[132,3957,3958],{"class":749}," -1.0\n",[132,3960,3961,3964,3966,3968,3971],{"class":134,"line":884},[132,3962,3963],{"class":309},"color ",[132,3965,730],{"class":313},[132,3967,733],{"class":313},[132,3969,3970],{"class":149},"#0033cc",[132,3972,739],{"class":313},[132,3974,3976],{"class":134,"line":3975},14,[132,3977,3869],{"emptyLinePlaceholder":3868},[132,3979,3981,3983,3985,3987,3989,3991,3993],{"class":134,"line":3980},15,[132,3982,2355],{"class":313},[132,3984,2066],{"class":145},[132,3986,26],{"class":309},[132,3988,2714],{"class":145},[132,3990,26],{"class":309},[132,3992,3946],{"class":145},[132,3994,2360],{"class":313},[132,3996,3998,4000,4002],{"class":134,"line":3997},16,[132,3999,3953],{"class":309},[132,4001,730],{"class":313},[132,4003,4004],{"class":749}," 0.0\n",[132,4006,4008,4010,4012,4014,4017],{"class":134,"line":4007},17,[132,4009,3963],{"class":309},[132,4011,730],{"class":313},[132,4013,733],{"class":313},[132,4015,4016],{"class":149},"#888888",[132,4018,739],{"class":313},[44,4020,4021,4033],{},[47,4022,4023],{},[50,4024,4025,4027,4029,4031],{},[53,4026,908],{},[53,4028,911],{},[53,4030,343],{},[53,4032,346],{},[60,4034,4035,4056,4081,4101],{},[50,4036,4037,4041,4043,4047],{},[65,4038,4039],{},[19,4040,2078],{},[65,4042,2128],{},[65,4044,4045],{},[19,4046,2704],{},[65,4048,4049,4051,4052,4055],{},[19,4050,2704],{}," = stepped, ",[19,4053,4054],{},"continuous"," = interpolated",[50,4057,4058,4063,4065,4069],{},[65,4059,4060],{},[19,4061,4062],{},"rescale_mode",[65,4064,2128],{},[65,4066,4067],{},[19,4068,3908],{},[65,4070,4071,4073,4074,4076,4077,4080],{},[19,4072,3908],{}," = use entry values verbatim. ",[19,4075,3573],{}," = stretch to per-tile data range. ",[19,4078,4079],{},"none"," = no rescale",[50,4082,4083,4087,4091,4094],{},[65,4084,4085],{},[19,4086,3946],{},[65,4088,44,4089],{},[132,4090],{},[65,4092,4093],{},"required",[65,4095,4096,4097,4100],{},"List of ",[19,4098,4099],{},"{value, color}"," stops",[50,4102,4103,4108,4110,4114],{},[65,4104,4105],{},[19,4106,4107],{},"nodata_color",[65,4109,1066],{},[65,4111,4112],{},[91,4113,543],{},[65,4115,4116],{},"Hex color (incl. alpha) for nodata pixels",[28,4118,4120],{"id":4119},"styles",[19,4121,4122],{},"[[styles]]",[123,4124,4126],{"className":710,"code":4125,"language":712,"meta":128,"style":128},"[[styles]]\nid = \"osm-bright\"\npath = \"\u002Fdata\u002Fstyles\u002Fosm-bright\u002Fstyle.json\"\nname = \"OSM Bright\"\n",[19,4127,4128,4136,4149,4162],{"__ignoreMap":128},[132,4129,4130,4132,4134],{"class":134,"line":135},[132,4131,2355],{"class":313},[132,4133,4119],{"class":145},[132,4135,2360],{"class":313},[132,4137,4138,4140,4142,4144,4147],{"class":134,"line":142},[132,4139,2365],{"class":309},[132,4141,730],{"class":313},[132,4143,733],{"class":313},[132,4145,4146],{"class":149},"osm-bright",[132,4148,739],{"class":313},[132,4150,4151,4153,4155,4157,4160],{"class":134,"line":156},[132,4152,2393],{"class":309},[132,4154,730],{"class":313},[132,4156,733],{"class":313},[132,4158,4159],{"class":149},"\u002Fdata\u002Fstyles\u002Fosm-bright\u002Fstyle.json",[132,4161,739],{"class":313},[132,4163,4164,4167,4169,4171,4174],{"class":134,"line":166},[132,4165,4166],{"class":309},"name ",[132,4168,730],{"class":313},[132,4170,733],{"class":313},[132,4172,4173],{"class":149},"OSM Bright",[132,4175,739],{"class":313},[44,4177,4178,4190],{},[47,4179,4180],{},[50,4181,4182,4184,4186,4188],{},[53,4183,908],{},[53,4185,911],{},[53,4187,2096],{},[53,4189,346],{},[60,4191,4192,4208,4221,4233],{},[50,4193,4194,4198,4200,4202],{},[65,4195,4196],{},[19,4197,2107],{},[65,4199,927],{},[65,4201,2112],{},[65,4203,4204,4205,2119],{},"Style identifier (becomes ",[19,4206,4207],{},"\u002Fstyles\u002F\u003Cid>\u002F*",[50,4209,4210,4214,4216,4218],{},[65,4211,4212],{},[19,4213,2165],{},[65,4215,927],{},[65,4217,2112],{},[65,4219,4220],{},"Path to a MapLibre style JSON file",[50,4222,4223,4227,4229,4231],{},[65,4224,4225],{},[19,4226,2193],{},[65,4228,1066],{},[65,4230,2198],{},[65,4232,2201],{},[50,4234,4235,4239,4241,4243],{},[65,4236,4237],{},[19,4238,2208],{},[65,4240,1066],{},[65,4242,2198],{},[65,4244,4245],{},"Attribution text",[28,4247,4249],{"id":4248},"composites",[19,4250,4251],{},"[[composites]]",[10,4253,4254,4255,4258,4259,4263],{},"Named multi-source composites merge vector tiles from several sources into\none endpoint at ",[19,4256,4257],{},"\u002Fdata\u002F{id}"," (see the\n",[105,4260,4262],{"href":4261},"\u002Fguides\u002Fcomposite-sources","Composite Sources guide","):",[123,4265,4267],{"className":710,"code":4266,"language":712,"meta":128,"style":128},"[[composites]]\nid = \"world-base\"\nsources = [\"protomaps\", \"zurich\"]\n",[19,4268,4269,4277,4290],{"__ignoreMap":128},[132,4270,4271,4273,4275],{"class":134,"line":135},[132,4272,2355],{"class":313},[132,4274,4248],{"class":145},[132,4276,2360],{"class":313},[132,4278,4279,4281,4283,4285,4288],{"class":134,"line":142},[132,4280,2365],{"class":309},[132,4282,730],{"class":313},[132,4284,733],{"class":313},[132,4286,4287],{"class":149},"world-base",[132,4289,739],{"class":313},[132,4291,4292,4295,4297,4299,4301,4304,4306,4308,4310,4313,4315],{"class":134,"line":156},[132,4293,4294],{"class":309},"sources ",[132,4296,730],{"class":313},[132,4298,322],{"class":313},[132,4300,762],{"class":313},[132,4302,4303],{"class":149},"protomaps",[132,4305,762],{"class":313},[132,4307,3392],{"class":313},[132,4309,733],{"class":313},[132,4311,4312],{"class":149},"zurich",[132,4314,762],{"class":313},[132,4316,328],{"class":313},[44,4318,4319,4331],{},[47,4320,4321],{},[50,4322,4323,4325,4327,4329],{},[53,4324,908],{},[53,4326,911],{},[53,4328,2096],{},[53,4330,346],{},[60,4332,4333,4348],{},[50,4334,4335,4339,4341,4343],{},[65,4336,4337],{},[19,4338,2107],{},[65,4340,927],{},[65,4342,2112],{},[65,4344,4345,4346,2119],{},"Composite identifier (becomes ",[19,4347,2118],{},[50,4349,4350,4354,4358,4360],{},[65,4351,4352],{},[19,4353,2066],{},[65,4355,927,4356],{},[132,4357],{},[65,4359,2112],{},[65,4361,4362],{},"Member source ids merged into this composite",[10,4364,4365,4366,4369,4370,4372,4373,4376],{},"Ad-hoc composites (",[19,4367,4368],{},"\u002Fdata\u002Fa+b+c\u002F...",") work without any config; a configured\n",[19,4371,4251],{}," id always wins over ad-hoc ",[19,4374,4375],{},"+"," parsing.",[28,4378,4380,1298,4383],{"id":4379},"sftp-feature-sftp",[19,4381,4382],{},"[sftp]",[91,4384,2610,4385,227],{},[19,4386,4387],{},"sftp",[10,4389,4390,4391,213],{},"Global defaults for ",[105,4392,4394],{"href":4393},"#sftp-sources","SFTP sources",[123,4396,4398],{"className":710,"code":4397,"language":712,"meta":128,"style":128},"[sftp]\nknown_hosts_path = \"\u002Fetc\u002Ftileserver\u002Fknown_hosts\"\nstrict_host_key = true\n",[19,4399,4400,4408,4422],{"__ignoreMap":128},[132,4401,4402,4404,4406],{"class":134,"line":135},[132,4403,314],{"class":313},[132,4405,4387],{"class":145},[132,4407,328],{"class":313},[132,4409,4410,4413,4415,4417,4420],{"class":134,"line":142},[132,4411,4412],{"class":309},"known_hosts_path ",[132,4414,730],{"class":313},[132,4416,733],{"class":313},[132,4418,4419],{"class":149},"\u002Fetc\u002Ftileserver\u002Fknown_hosts",[132,4421,739],{"class":313},[132,4423,4424,4427,4429],{"class":134,"line":156},[132,4425,4426],{"class":309},"strict_host_key ",[132,4428,730],{"class":313},[132,4430,4431],{"class":864}," true\n",[44,4433,4434,4446],{},[47,4435,4436],{},[50,4437,4438,4440,4442,4444],{},[53,4439,908],{},[53,4441,911],{},[53,4443,343],{},[53,4445,346],{},[60,4447,4448,4465],{},[50,4449,4450,4455,4457,4462],{},[65,4451,4452],{},[19,4453,4454],{},"known_hosts_path",[65,4456,1083],{},[65,4458,4459],{},[19,4460,4461],{},"~\u002F.ssh\u002Fknown_hosts",[65,4463,4464],{},"known_hosts file used for host-key verification",[50,4466,4467,4472,4474,4478],{},[65,4468,4469],{},[19,4470,4471],{},"strict_host_key",[65,4473,1174],{},[65,4475,4476],{},[19,4477,482],{},[65,4479,4480,4481,4483],{},"Fail-closed on unknown hosts; ",[19,4482,513],{}," accepts first-seen keys (TOFU)",[28,4485,4487],{"id":4486},"render",[19,4488,4489],{},"[render]",[10,4491,4492,4493,26],{},"Native MapLibre raster renderer pool. See ",[105,4494,4496],{"href":4495},"\u002Fguides\u002Fstatic-images","Static images",[123,4498,4500],{"className":710,"code":4499,"language":712,"meta":128,"style":128},"[render]\npool_size = 4\nrender_timeout_secs = 30\nqueue_size = 256\n",[19,4501,4502,4510,4520,4530],{"__ignoreMap":128},[132,4503,4504,4506,4508],{"class":134,"line":135},[132,4505,314],{"class":313},[132,4507,4486],{"class":145},[132,4509,328],{"class":313},[132,4511,4512,4515,4517],{"class":134,"line":142},[132,4513,4514],{"class":309},"pool_size ",[132,4516,730],{"class":313},[132,4518,4519],{"class":749}," 4\n",[132,4521,4522,4525,4527],{"class":134,"line":156},[132,4523,4524],{"class":309},"render_timeout_secs ",[132,4526,730],{"class":313},[132,4528,4529],{"class":749}," 30\n",[132,4531,4532,4535,4537],{"class":134,"line":166},[132,4533,4534],{"class":309},"queue_size ",[132,4536,730],{"class":313},[132,4538,3351],{"class":749},[44,4540,4541,4553],{},[47,4542,4543],{},[50,4544,4545,4547,4549,4551],{},[53,4546,908],{},[53,4548,911],{},[53,4550,343],{},[53,4552,346],{},[60,4554,4555,4571,4589],{},[50,4556,4557,4562,4564,4568],{},[65,4558,4559],{},[19,4560,4561],{},"pool_size",[65,4563,3592],{},[65,4565,4566],{},[19,4567,3194],{},[65,4569,4570],{},"Concurrent renderer worker threads",[50,4572,4573,4578,4581,4586],{},[65,4574,4575],{},[19,4576,4577],{},"render_timeout_secs",[65,4579,4580],{},"u64",[65,4582,4583],{},[19,4584,4585],{},"30",[65,4587,4588],{},"Per-request render timeout. Requests exceeding this are dropped",[50,4590,4591,4596,4598,4603],{},[65,4592,4593],{},[19,4594,4595],{},"queue_size",[65,4597,3592],{},[65,4599,4600],{},[19,4601,4602],{},"256",[65,4604,4605,4606],{},"Render requests that may wait for a free worker. More get ",[19,4607,4608],{},"503",[28,4610,4612],{"id":4611},"cache",[19,4613,4614],{},"[cache]",[10,4616,4617],{},"Global in-process tile cache (moka backend).",[123,4619,4621],{"className":710,"code":4620,"language":712,"meta":128,"style":128},"[cache]\nenabled = true\nmax_size_mb = 512\nttl_seconds = 3600\ndir = \"\u002Fvar\u002Flib\u002Ftileserver\"   # optional — scratch \u002F state directory\n",[19,4622,4623,4631,4640,4650,4660],{"__ignoreMap":128},[132,4624,4625,4627,4629],{"class":134,"line":135},[132,4626,314],{"class":313},[132,4628,4611],{"class":145},[132,4630,328],{"class":313},[132,4632,4633,4636,4638],{"class":134,"line":142},[132,4634,4635],{"class":309},"enabled ",[132,4637,730],{"class":313},[132,4639,4431],{"class":864},[132,4641,4642,4645,4647],{"class":134,"line":156},[132,4643,4644],{"class":309},"max_size_mb ",[132,4646,730],{"class":313},[132,4648,4649],{"class":749}," 512\n",[132,4651,4652,4655,4657],{"class":134,"line":166},[132,4653,4654],{"class":309},"ttl_seconds ",[132,4656,730],{"class":313},[132,4658,4659],{"class":749}," 3600\n",[132,4661,4662,4665,4667,4669,4672,4674],{"class":134,"line":772},[132,4663,4664],{"class":309},"dir ",[132,4666,730],{"class":313},[132,4668,733],{"class":313},[132,4670,4671],{"class":149},"\u002Fvar\u002Flib\u002Ftileserver",[132,4673,762],{"class":313},[132,4675,4676],{"class":138},"   # optional — scratch \u002F state directory\n",[44,4678,4679,4691],{},[47,4680,4681],{},[50,4682,4683,4685,4687,4689],{},[53,4684,908],{},[53,4686,911],{},[53,4688,343],{},[53,4690,346],{},[60,4692,4693,4709,4726,4743],{},[50,4694,4695,4700,4702,4706],{},[65,4696,4697],{},[19,4698,4699],{},"enabled",[65,4701,1174],{},[65,4703,4704],{},[19,4705,513],{},[65,4707,4708],{},"Enable the global tile cache",[50,4710,4711,4716,4718,4723],{},[65,4712,4713],{},[19,4714,4715],{},"max_size_mb",[65,4717,4580],{},[65,4719,4720],{},[19,4721,4722],{},"512",[65,4724,4725],{},"Maximum cache size in megabytes",[50,4727,4728,4733,4735,4740],{},[65,4729,4730],{},[19,4731,4732],{},"ttl_seconds",[65,4734,4580],{},[65,4736,4737],{},[19,4738,4739],{},"3600",[65,4741,4742],{},"Time-to-live for cache entries",[50,4744,4745,4749,4751,4755],{},[65,4746,4747],{},[19,4748,2386],{},[65,4750,1083],{},[65,4752,4753],{},[19,4754,398],{},[65,4756,4757,4758,4761],{},"Scratch \u002F state directory for on-disk subsystems (today: uploads). Storage location only — ",[14,4759,4760],{},"not"," a cache eviction policy.",[3003,4763,4765],{"type":4764},"note",[10,4766,4767,4769,4770,4773,4774,4776,4777,4779,4780,26],{},[19,4768,2386],{}," sets where on-disk state (e.g. uploads) lives, not the in-memory tile\ncache. Resolution precedence (highest first): ",[19,4771,4772],{},"--cache-dir"," flag →\n",[19,4775,393],{}," env → ",[19,4778,404],{}," → ",[19,4781,398],{},[28,4783,4785],{"id":4784},"compression",[19,4786,4787],{},"[compression]",[10,4789,4790,4791,4794],{},"Negotiates ",[19,4792,4793],{},"Accept-Encoding"," per request and serves tile bodies as brotli or\nzstd when the client accepts them. By default tiles are served in whatever\nencoding the source stores them in (gzip for most PMTiles); enabling brotli or\nzstd negotiation produces 15–40% smaller payloads on typical vector tiles.",[123,4796,4798],{"className":710,"code":4797,"language":712,"meta":128,"style":128},"[compression]\nbr_quality = 5                # brotli quality 0-11 (default 5)\nzstd_level = 3                # zstd level 1-22 (default 3)\nminimal_recompression = false # if true, never re-encode — always passthrough\n",[19,4799,4800,4808,4821,4834],{"__ignoreMap":128},[132,4801,4802,4804,4806],{"class":134,"line":135},[132,4803,314],{"class":313},[132,4805,4784],{"class":145},[132,4807,328],{"class":313},[132,4809,4810,4813,4815,4818],{"class":134,"line":142},[132,4811,4812],{"class":309},"br_quality ",[132,4814,730],{"class":313},[132,4816,4817],{"class":749}," 5",[132,4819,4820],{"class":138},"                # brotli quality 0-11 (default 5)\n",[132,4822,4823,4826,4828,4831],{"class":134,"line":156},[132,4824,4825],{"class":309},"zstd_level ",[132,4827,730],{"class":313},[132,4829,4830],{"class":749}," 3",[132,4832,4833],{"class":138},"                # zstd level 1-22 (default 3)\n",[132,4835,4836,4839,4841,4843],{"class":134,"line":166},[132,4837,4838],{"class":309},"minimal_recompression ",[132,4840,730],{"class":313},[132,4842,865],{"class":864},[132,4844,4845],{"class":138}," # if true, never re-encode — always passthrough\n",[44,4847,4848,4860],{},[47,4849,4850],{},[50,4851,4852,4854,4856,4858],{},[53,4853,908],{},[53,4855,911],{},[53,4857,343],{},[53,4859,346],{},[60,4861,4862,4879,4897],{},[50,4863,4864,4869,4871,4876],{},[65,4865,4866],{},[19,4867,4868],{},"br_quality",[65,4870,3191],{},[65,4872,4873],{},[19,4874,4875],{},"5",[65,4877,4878],{},"Brotli quality (0–11). Higher = smaller payload, slower encode.",[50,4880,4881,4886,4889,4894],{},[65,4882,4883],{},[19,4884,4885],{},"zstd_level",[65,4887,4888],{},"i32",[65,4890,4891],{},[19,4892,4893],{},"3",[65,4895,4896],{},"Zstandard level (1–22). Higher = smaller payload, slower encode.",[50,4898,4899,4904,4906,4910],{},[65,4900,4901],{},[19,4902,4903],{},"minimal_recompression",[65,4905,1174],{},[65,4907,4908],{},[19,4909,513],{},[65,4911,4912,4913,4915],{},"When ",[19,4914,482],{},", never decode\u002Fre-encode — serve the source encoding as-is.",[10,4917,4918],{},"How negotiation works per request:",[215,4920,4921,4927,4934],{},[218,4922,4923,4924,4926],{},"If the source's stored encoding is already in the client's ",[19,4925,4793],{},"\nset, it is served as-is (no decode\u002Fre-encode).",[218,4928,4929,4930,4933],{},"Otherwise the tile is decoded once and re-encoded to the highest-preference\nacceptable encoding, then cached under ",[19,4931,4932],{},"(source, z, x, y, encoding)"," so the\nre-encode cost is paid once per tile + encoding pair.",[218,4935,4936],{},"Tiles smaller than 200 bytes skip compression — the framing overhead exceeds\nthe savings.",[10,4938,4939,4940,4943],{},"Every tile response carries ",[19,4941,4942],{},"Vary: Accept-Encoding"," so CDNs cache one copy per\nencoding rather than serving a wrong-encoding copy to a client that cannot\ndecode it.",[3003,4945,4946],{"type":4764},[10,4947,4948,4949,4952,4953,4956],{},"Brotli at quality 10–11 can exceed 100 ms per tile. The default ",[19,4950,4951],{},"q5"," favours\nfirst-paint latency; raise it only if you precompute tiles in batch. Set\n",[19,4954,4955],{},"minimal_recompression = true"," to disable negotiation entirely and serve source\nbytes verbatim.",[28,4958,4960],{"id":4959},"live",[19,4961,4962],{},"[live]",[10,4964,4965,4966,4969,4970,4973],{},"Live source updates over WebSocket. With ",[19,4967,4968],{},"enabled = true"," the server mounts\n",[19,4971,4972],{},"GET \u002Fws"," and tells connected clients when a source's data changes, so maps\nre-fetch its tiles without a page reload. The built-in viewer connects\nautomatically.",[123,4975,4977],{"className":710,"code":4976,"language":712,"meta":128,"style":128},"[live]\nenabled = true\nwatch = [\"live-tracking\"]   # or [\"*\"] for every source\ninterval_secs = 5\nmax_clients = 1000\n",[19,4978,4979,4987,4995,5016,5026],{"__ignoreMap":128},[132,4980,4981,4983,4985],{"class":134,"line":135},[132,4982,314],{"class":313},[132,4984,4959],{"class":145},[132,4986,328],{"class":313},[132,4988,4989,4991,4993],{"class":134,"line":142},[132,4990,4635],{"class":309},[132,4992,730],{"class":313},[132,4994,4431],{"class":864},[132,4996,4997,5000,5002,5004,5006,5009,5011,5013],{"class":134,"line":156},[132,4998,4999],{"class":309},"watch ",[132,5001,730],{"class":313},[132,5003,322],{"class":313},[132,5005,762],{"class":313},[132,5007,5008],{"class":149},"live-tracking",[132,5010,762],{"class":313},[132,5012,319],{"class":313},[132,5014,5015],{"class":138},"   # or [\"*\"] for every source\n",[132,5017,5018,5021,5023],{"class":134,"line":166},[132,5019,5020],{"class":309},"interval_secs ",[132,5022,730],{"class":313},[132,5024,5025],{"class":749}," 5\n",[132,5027,5028,5031,5033],{"class":134,"line":772},[132,5029,5030],{"class":309},"max_clients ",[132,5032,730],{"class":313},[132,5034,5035],{"class":749}," 1000\n",[44,5037,5038,5050],{},[47,5039,5040],{},[50,5041,5042,5044,5046,5048],{},[53,5043,908],{},[53,5045,911],{},[53,5047,343],{},[53,5049,346],{},[60,5051,5052,5070,5091,5107],{},[50,5053,5054,5058,5060,5064],{},[65,5055,5056],{},[19,5057,4699],{},[65,5059,1174],{},[65,5061,5062],{},[19,5063,513],{},[65,5065,5066,5067,5069],{},"Mount ",[19,5068,4972],{}," and broadcast source reloads",[50,5071,5072,5077,5081,5085],{},[65,5073,5074],{},[19,5075,5076],{},"watch",[65,5078,927,5079],{},[132,5080],{},[65,5082,5083],{},[19,5084,1032],{},[65,5086,5087,5088,5090],{},"Source ids to poll for data changes; ",[19,5089,969],{}," polls every source. Unknown ids fail validation",[50,5092,5093,5098,5100,5104],{},[65,5094,5095],{},[19,5096,5097],{},"interval_secs",[65,5099,4580],{},[65,5101,5102],{},[19,5103,4875],{},[65,5105,5106],{},"Seconds between polls (minimum 1)",[50,5108,5109,5114,5116,5121],{},[65,5110,5111],{},[19,5112,5113],{},"max_clients",[65,5115,3592],{},[65,5117,5118],{},[19,5119,5120],{},"1000",[65,5122,5123,5124],{},"Maximum concurrent WebSocket clients; further upgrades get ",[19,5125,4608],{},[10,5127,5128,5129,5132],{},"A client receives a ",[19,5130,5131],{},"reload"," for a source when:",[2817,5134,5135,5147],{},[218,5136,5137,5138,80,5141,5143,5144,5146],{},"a hot reload (",[19,5139,5140],{},"SIGHUP",[19,5142,2062],{},") changed, added or removed\nthat source's ",[19,5145,2069],{}," entry (a forced reload sends every source);",[218,5148,5149,5150,5152,5153,181,5156,38,5159,5161,5162,5164],{},"the source is watched and its data changed: local files are compared by\nmodification time and size, ",[19,5151,3665],{}," sources by ",[19,5154,5155],{},"ETag",[19,5157,5158],{},"Last-Modified",[19,5160,2021],{},". The server then reloads its sources\n(like ",[19,5163,5140],{},", with a fresh tile cache) before it sends the message.",[238,5166,5168],{"id":5167},"protocol","Protocol",[10,5170,5171,5172,213],{},"JSON text frames on ",[19,5173,5174],{},"ws(s):\u002F\u002F\u003Chost>\u002Fws",[123,5176,5178],{"className":3240,"code":5177,"language":3242,"meta":128,"style":128},"\u002F\u002F server → client, once on connect\n{ \"type\": \"hello\", \"sources\": [\"live-tracking\", \"osm\"] }\n\u002F\u002F server → client, when a source changes\n{ \"type\": \"reload\", \"source\": \"live-tracking\" }\n\u002F\u002F client → server\n{ \"type\": \"subscribe\", \"source\": \"live-tracking\" }\n{ \"type\": \"unsubscribe\", \"source\": \"live-tracking\" }\n",[19,5179,5180,5185,5236,5241,5277,5282,5319],{"__ignoreMap":128},[132,5181,5182],{"class":134,"line":135},[132,5183,5184],{"class":138},"\u002F\u002F server → client, once on connect\n",[132,5186,5187,5190,5192,5194,5196,5198,5200,5203,5205,5207,5209,5211,5213,5215,5217,5219,5221,5223,5225,5227,5230,5232,5234],{"class":134,"line":142},[132,5188,5189],{"class":313},"{",[132,5191,733],{"class":313},[132,5193,2078],{"class":3256},[132,5195,762],{"class":313},[132,5197,213],{"class":313},[132,5199,733],{"class":313},[132,5201,5202],{"class":149},"hello",[132,5204,762],{"class":313},[132,5206,3392],{"class":313},[132,5208,733],{"class":313},[132,5210,2066],{"class":3256},[132,5212,762],{"class":313},[132,5214,213],{"class":313},[132,5216,322],{"class":313},[132,5218,762],{"class":313},[132,5220,5008],{"class":149},[132,5222,762],{"class":313},[132,5224,3392],{"class":313},[132,5226,733],{"class":313},[132,5228,5229],{"class":149},"osm",[132,5231,762],{"class":313},[132,5233,319],{"class":313},[132,5235,3407],{"class":313},[132,5237,5238],{"class":134,"line":156},[132,5239,5240],{"class":138},"\u002F\u002F server → client, when a source changes\n",[132,5242,5243,5245,5247,5249,5251,5253,5255,5257,5259,5261,5263,5265,5267,5269,5271,5273,5275],{"class":134,"line":166},[132,5244,5189],{"class":313},[132,5246,733],{"class":313},[132,5248,2078],{"class":3256},[132,5250,762],{"class":313},[132,5252,213],{"class":313},[132,5254,733],{"class":313},[132,5256,5131],{"class":149},[132,5258,762],{"class":313},[132,5260,3392],{"class":313},[132,5262,733],{"class":313},[132,5264,3379],{"class":3256},[132,5266,762],{"class":313},[132,5268,213],{"class":313},[132,5270,733],{"class":313},[132,5272,5008],{"class":149},[132,5274,762],{"class":313},[132,5276,3407],{"class":313},[132,5278,5279],{"class":134,"line":772},[132,5280,5281],{"class":138},"\u002F\u002F client → server\n",[132,5283,5284,5286,5288,5290,5292,5294,5296,5299,5301,5303,5305,5307,5309,5311,5313,5315,5317],{"class":134,"line":787},[132,5285,5189],{"class":313},[132,5287,733],{"class":313},[132,5289,2078],{"class":3256},[132,5291,762],{"class":313},[132,5293,213],{"class":313},[132,5295,733],{"class":313},[132,5297,5298],{"class":149},"subscribe",[132,5300,762],{"class":313},[132,5302,3392],{"class":313},[132,5304,733],{"class":313},[132,5306,3379],{"class":3256},[132,5308,762],{"class":313},[132,5310,213],{"class":313},[132,5312,733],{"class":313},[132,5314,5008],{"class":149},[132,5316,762],{"class":313},[132,5318,3407],{"class":313},[132,5320,5321,5323,5325,5327,5329,5331,5333,5336,5338,5340,5342,5344,5346,5348,5350,5352,5354],{"class":134,"line":805},[132,5322,5189],{"class":313},[132,5324,733],{"class":313},[132,5326,2078],{"class":3256},[132,5328,762],{"class":313},[132,5330,213],{"class":313},[132,5332,733],{"class":313},[132,5334,5335],{"class":149},"unsubscribe",[132,5337,762],{"class":313},[132,5339,3392],{"class":313},[132,5341,733],{"class":313},[132,5343,3379],{"class":3256},[132,5345,762],{"class":313},[132,5347,213],{"class":313},[132,5349,733],{"class":313},[132,5351,5008],{"class":149},[132,5353,762],{"class":313},[132,5355,3407],{"class":313},[10,5357,5358,5359,5361,5362,5364],{},"A client with no subscriptions receives every source's messages; after its\nfirst ",[19,5360,5298],{}," it receives only the sources it subscribed to. A client that\nfalls more than 256 messages behind gets a ",[19,5363,5131],{}," for each of its\nsubscriptions. Messages name a whole source; there are no per-tile\ninvalidations yet.",[10,5366,5367,5368,5371],{},"In MapLibre GL JS, re-fetch the tiles of the style sources that read from the\nreloaded server source. Tiles are served with ",[19,5369,5370],{},"Cache-Control: max-age=86400",",\nso bypass the browser cache for them:",[123,5373,5377],{"className":5374,"code":5375,"language":5376,"meta":128,"style":128},"language-js shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","const reloaded = new Set();\nmap.setTransformRequest((url) =>\n  [...reloaded].some((id) => url.includes(`\u002Fdata\u002F${id}`))\n    ? { url, cache: 'no-cache' }\n    : { url },\n);\nconst ws = new WebSocket('wss:\u002F\u002Ftiles.example.com\u002Fws');\nws.onmessage = ({ data }) => {\n  const msg = JSON.parse(data);\n  if (msg.type !== 'reload') return;\n  reloaded.add(msg.source);\n  map.refreshTiles('my-source'); \u002F\u002F the style source fed by msg.source\n};\n","js",[19,5378,5379,5402,5426,5480,5507,5520,5526,5553,5578,5605,5636,5658,5685],{"__ignoreMap":128},[132,5380,5381,5384,5387,5389,5392,5396,5399],{"class":134,"line":135},[132,5382,5383],{"class":3256},"const",[132,5385,5386],{"class":309}," reloaded ",[132,5388,730],{"class":313},[132,5390,5391],{"class":313}," new",[132,5393,5395],{"class":5394},"s2Zo4"," Set",[132,5397,5398],{"class":309},"()",[132,5400,5401],{"class":313},";\n",[132,5403,5404,5407,5409,5412,5415,5417,5421,5423],{"class":134,"line":142},[132,5405,5406],{"class":309},"map",[132,5408,26],{"class":313},[132,5410,5411],{"class":5394},"setTransformRequest",[132,5413,5414],{"class":309},"(",[132,5416,5414],{"class":313},[132,5418,5420],{"class":5419},"sHdIc","url",[132,5422,227],{"class":313},[132,5424,5425],{"class":3256}," =>\n",[132,5427,5428,5431,5434,5437,5439,5442,5444,5446,5448,5450,5453,5456,5458,5461,5463,5466,5469,5472,5474,5477],{"class":134,"line":156},[132,5429,5430],{"class":309},"  [",[132,5432,5433],{"class":313},"...",[132,5435,5436],{"class":309},"reloaded]",[132,5438,26],{"class":313},[132,5440,5441],{"class":5394},"some",[132,5443,5414],{"class":309},[132,5445,5414],{"class":313},[132,5447,2107],{"class":5419},[132,5449,227],{"class":313},[132,5451,5452],{"class":3256}," =>",[132,5454,5455],{"class":309}," url",[132,5457,26],{"class":313},[132,5459,5460],{"class":5394},"includes",[132,5462,5414],{"class":309},[132,5464,5465],{"class":313},"`",[132,5467,5468],{"class":149},"\u002Fdata\u002F",[132,5470,5471],{"class":313},"${",[132,5473,2107],{"class":309},[132,5475,5476],{"class":313},"}`",[132,5478,5479],{"class":309},"))\n",[132,5481,5482,5485,5487,5489,5491,5494,5496,5499,5502,5505],{"class":134,"line":166},[132,5483,5484],{"class":313},"    ?",[132,5486,3374],{"class":313},[132,5488,5455],{"class":309},[132,5490,3392],{"class":313},[132,5492,5493],{"class":1957}," cache",[132,5495,213],{"class":313},[132,5497,5498],{"class":313}," '",[132,5500,5501],{"class":149},"no-cache",[132,5503,5504],{"class":313},"'",[132,5506,3407],{"class":313},[132,5508,5509,5512,5514,5517],{"class":134,"line":772},[132,5510,5511],{"class":313},"    :",[132,5513,3374],{"class":313},[132,5515,5516],{"class":309}," url ",[132,5518,5519],{"class":313},"},\n",[132,5521,5522,5524],{"class":134,"line":787},[132,5523,227],{"class":309},[132,5525,5401],{"class":313},[132,5527,5528,5530,5533,5535,5537,5540,5542,5544,5547,5549,5551],{"class":134,"line":805},[132,5529,5383],{"class":3256},[132,5531,5532],{"class":309}," ws ",[132,5534,730],{"class":313},[132,5536,5391],{"class":313},[132,5538,5539],{"class":5394}," WebSocket",[132,5541,5414],{"class":309},[132,5543,5504],{"class":313},[132,5545,5546],{"class":149},"wss:\u002F\u002Ftiles.example.com\u002Fws",[132,5548,5504],{"class":313},[132,5550,227],{"class":309},[132,5552,5401],{"class":313},[132,5554,5555,5558,5560,5563,5565,5568,5571,5574,5576],{"class":134,"line":823},[132,5556,5557],{"class":309},"ws",[132,5559,26],{"class":313},[132,5561,5562],{"class":5394},"onmessage",[132,5564,1848],{"class":313},[132,5566,5567],{"class":313}," ({",[132,5569,5570],{"class":5419}," data",[132,5572,5573],{"class":313}," })",[132,5575,5452],{"class":3256},[132,5577,3263],{"class":313},[132,5579,5580,5583,5586,5588,5591,5593,5596,5598,5601,5603],{"class":134,"line":834},[132,5581,5582],{"class":3256},"  const",[132,5584,5585],{"class":309}," msg",[132,5587,1848],{"class":313},[132,5589,5590],{"class":309}," JSON",[132,5592,26],{"class":313},[132,5594,5595],{"class":5394},"parse",[132,5597,5414],{"class":1957},[132,5599,5600],{"class":309},"data",[132,5602,227],{"class":1957},[132,5604,5401],{"class":313},[132,5606,5607,5611,5613,5616,5618,5620,5623,5625,5627,5629,5631,5634],{"class":134,"line":845},[132,5608,5610],{"class":5609},"s7zQu","  if",[132,5612,3029],{"class":1957},[132,5614,5615],{"class":309},"msg",[132,5617,26],{"class":313},[132,5619,2078],{"class":309},[132,5621,5622],{"class":313}," !==",[132,5624,5498],{"class":313},[132,5626,5131],{"class":149},[132,5628,5504],{"class":313},[132,5630,1688],{"class":1957},[132,5632,5633],{"class":5609},"return",[132,5635,5401],{"class":313},[132,5637,5638,5641,5643,5646,5648,5650,5652,5654,5656],{"class":134,"line":856},[132,5639,5640],{"class":309},"  reloaded",[132,5642,26],{"class":313},[132,5644,5645],{"class":5394},"add",[132,5647,5414],{"class":1957},[132,5649,5615],{"class":309},[132,5651,26],{"class":313},[132,5653,3379],{"class":309},[132,5655,227],{"class":1957},[132,5657,5401],{"class":313},[132,5659,5660,5663,5665,5668,5670,5672,5675,5677,5679,5682],{"class":134,"line":871},[132,5661,5662],{"class":309},"  map",[132,5664,26],{"class":313},[132,5666,5667],{"class":5394},"refreshTiles",[132,5669,5414],{"class":1957},[132,5671,5504],{"class":313},[132,5673,5674],{"class":149},"my-source",[132,5676,5504],{"class":313},[132,5678,227],{"class":1957},[132,5680,5681],{"class":313},";",[132,5683,5684],{"class":138}," \u002F\u002F the style source fed by msg.source\n",[132,5686,5687],{"class":134,"line":884},[132,5688,5689],{"class":313},"};\n",[10,5691,5692,5693,5696,5697,5700,5701,5704,5705,5707,5708,26],{},"Behind a reverse proxy, forward the upgrade headers for ",[19,5694,5695],{},"\u002Fws"," (nginx:\n",[19,5698,5699],{},"proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection \"upgrade\";",") and raise ",[19,5702,5703],{},"proxy_read_timeout",".\n",[19,5706,1342],{}," reports ",[19,5709,5710],{},"live_enabled",[28,5712,5714],{"id":5713},"llm",[19,5715,5716],{},"[llm]",[10,5718,5719,5720,5723,5724,5727,5728,5732],{},"Server-side LLM proxy for the Map AI chat panel. When enabled, the panel offers\na ",[14,5721,5722],{},"Server provider"," option that sends chat requests to ",[19,5725,5726],{},"POST \u002Fapi\u002Fllm\u002Fchat",";\nthe server forwards them to your provider and streams the answer back. The API\nkey is read from an environment variable on every request, so it never appears\nin the config file and never reaches the browser. See\n",[105,5729,5731],{"href":5730},"\u002Fguides\u002Fai-chat#server-proxy","AI Chat"," for the full setup.",[123,5734,5736],{"className":710,"code":5735,"language":712,"meta":128,"style":128},"[llm]\nenabled = true\nprovider = \"anthropic\"                  # or \"openai-compatible\"\nbase_url = \"https:\u002F\u002Fapi.anthropic.com\"\napi_key_env = \"TILESERVER_LLM_API_KEY\"  # env var name, not the key itself\nmodel = \"claude-sonnet-4-5\"\nallow_user_keys = true                  # also allow bring-your-own-key in the browser\ntimeout_secs = 120\nmax_body_bytes = 1048576\nrate_limit_per_minute = 30\nmax_output_tokens = 8192\n",[19,5737,5738,5746,5754,5771,5785,5802,5816,5829,5839,5849,5858],{"__ignoreMap":128},[132,5739,5740,5742,5744],{"class":134,"line":135},[132,5741,314],{"class":313},[132,5743,5713],{"class":145},[132,5745,328],{"class":313},[132,5747,5748,5750,5752],{"class":134,"line":142},[132,5749,4635],{"class":309},[132,5751,730],{"class":313},[132,5753,4431],{"class":864},[132,5755,5756,5759,5761,5763,5766,5768],{"class":134,"line":156},[132,5757,5758],{"class":309},"provider ",[132,5760,730],{"class":313},[132,5762,733],{"class":313},[132,5764,5765],{"class":149},"anthropic",[132,5767,762],{"class":313},[132,5769,5770],{"class":138},"                  # or \"openai-compatible\"\n",[132,5772,5773,5776,5778,5780,5783],{"class":134,"line":166},[132,5774,5775],{"class":309},"base_url ",[132,5777,730],{"class":313},[132,5779,733],{"class":313},[132,5781,5782],{"class":149},"https:\u002F\u002Fapi.anthropic.com",[132,5784,739],{"class":313},[132,5786,5787,5790,5792,5794,5797,5799],{"class":134,"line":772},[132,5788,5789],{"class":309},"api_key_env ",[132,5791,730],{"class":313},[132,5793,733],{"class":313},[132,5795,5796],{"class":149},"TILESERVER_LLM_API_KEY",[132,5798,762],{"class":313},[132,5800,5801],{"class":138},"  # env var name, not the key itself\n",[132,5803,5804,5807,5809,5811,5814],{"class":134,"line":787},[132,5805,5806],{"class":309},"model ",[132,5808,730],{"class":313},[132,5810,733],{"class":313},[132,5812,5813],{"class":149},"claude-sonnet-4-5",[132,5815,739],{"class":313},[132,5817,5818,5821,5823,5826],{"class":134,"line":805},[132,5819,5820],{"class":309},"allow_user_keys ",[132,5822,730],{"class":313},[132,5824,5825],{"class":864}," true",[132,5827,5828],{"class":138},"                  # also allow bring-your-own-key in the browser\n",[132,5830,5831,5834,5836],{"class":134,"line":823},[132,5832,5833],{"class":309},"timeout_secs ",[132,5835,730],{"class":313},[132,5837,5838],{"class":749}," 120\n",[132,5840,5841,5844,5846],{"class":134,"line":834},[132,5842,5843],{"class":309},"max_body_bytes ",[132,5845,730],{"class":313},[132,5847,5848],{"class":749}," 1048576\n",[132,5850,5851,5854,5856],{"class":134,"line":845},[132,5852,5853],{"class":309},"rate_limit_per_minute ",[132,5855,730],{"class":313},[132,5857,4529],{"class":749},[132,5859,5860,5863,5865],{"class":134,"line":856},[132,5861,5862],{"class":309},"max_output_tokens ",[132,5864,730],{"class":313},[132,5866,5867],{"class":749}," 8192\n",[44,5869,5870,5882],{},[47,5871,5872],{},[50,5873,5874,5876,5878,5880],{},[53,5875,908],{},[53,5877,911],{},[53,5879,343],{},[53,5881,346],{},[60,5883,5884,5901,5922,5944,5958,5972,5988,6005,6025,6049],{},[50,5885,5886,5890,5892,5896],{},[65,5887,5888],{},[19,5889,4699],{},[65,5891,1174],{},[65,5893,5894],{},[19,5895,513],{},[65,5897,5898,5899,26],{},"Enable ",[19,5900,5726],{},[50,5902,5903,5908,5910,5915],{},[65,5904,5905],{},[19,5906,5907],{},"provider",[65,5909,2128],{},[65,5911,5912],{},[19,5913,5914],{},"openai-compatible",[65,5916,5917,5918,588,5920,26],{},"Upstream API family: ",[19,5919,5914],{},[19,5921,5765],{},[50,5923,5924,5929,5931,5933],{},[65,5925,5926],{},[19,5927,5928],{},"base_url",[65,5930,927],{},[65,5932,359],{},[65,5934,5935,5936,5939,5940,5943],{},"Upstream base URL. ",[19,5937,5938],{},"https:\u002F\u002F"," only; ",[19,5941,5942],{},"http:\u002F\u002F"," allowed for localhost.",[50,5945,5946,5951,5953,5955],{},[65,5947,5948],{},[19,5949,5950],{},"api_key_env",[65,5952,927],{},[65,5954,359],{},[65,5956,5957],{},"Environment variable holding the key. Omit for keyless local servers.",[50,5959,5960,5965,5967,5969],{},[65,5961,5962],{},[19,5963,5964],{},"model",[65,5966,927],{},[65,5968,359],{},[65,5970,5971],{},"Model sent upstream. Required when enabled; overrides the client's model.",[50,5973,5974,5979,5981,5985],{},[65,5975,5976],{},[19,5977,5978],{},"allow_user_keys",[65,5980,1174],{},[65,5982,5983],{},[19,5984,482],{},[65,5986,5987],{},"Also show the bring-your-own-key providers in the panel.",[50,5989,5990,5995,5997,6002],{},[65,5991,5992],{},[19,5993,5994],{},"timeout_secs",[65,5996,4580],{},[65,5998,5999],{},[19,6000,6001],{},"120",[65,6003,6004],{},"Upstream timeout for one chat response.",[50,6006,6007,6012,6014,6019],{},[65,6008,6009],{},[19,6010,6011],{},"max_body_bytes",[65,6013,3592],{},[65,6015,6016],{},[19,6017,6018],{},"1048576",[65,6020,6021,6022,2825],{},"Largest accepted request body (larger bodies get ",[19,6023,6024],{},"413",[50,6026,6027,6032,6034,6038],{},[65,6028,6029],{},[19,6030,6031],{},"rate_limit_per_minute",[65,6033,1099],{},[65,6035,6036],{},[19,6037,4585],{},[65,6039,6040,6041,6044,6045,6048],{},"Proxy requests per minute across all clients (",[19,6042,6043],{},"429"," when exceeded); ",[19,6046,6047],{},"0"," = no limit.",[50,6050,6051,6056,6058,6063],{},[65,6052,6053],{},[19,6054,6055],{},"max_output_tokens",[65,6057,1099],{},[65,6059,6060],{},[19,6061,6062],{},"8192",[65,6064,6065,6066,80,6069,6072,6073,6076],{},"Cap on ",[19,6067,6068],{},"max_tokens",[19,6070,6071],{},"max_completion_tokens"," and a thinking budget in proxied requests; ",[19,6074,6075],{},"n"," is forced to 1, so a client cannot multiply the cost of your key.",[10,6078,6079,6080,588,6082,6084,6085,6087],{},"Startup fails when the proxy is enabled without a valid ",[19,6081,5928],{},[19,6083,5964],{},",\nor when ",[19,6086,5950],{}," names an unset variable.",[28,6089,6091,1298,6094],{"id":6090},"raster-feature-raster",[19,6092,6093],{},"[raster]",[91,6095,2610,6096,227],{},[19,6097,2647],{},[123,6099,6101],{"className":710,"code":6100,"language":712,"meta":128,"style":128},"[raster]\ndefault_resampling = \"bilinear\"\ntile_size = 256\n",[19,6102,6103,6111,6124],{"__ignoreMap":128},[132,6104,6105,6107,6109],{"class":134,"line":135},[132,6106,314],{"class":313},[132,6108,2647],{"class":145},[132,6110,328],{"class":313},[132,6112,6113,6116,6118,6120,6122],{"class":134,"line":142},[132,6114,6115],{"class":309},"default_resampling ",[132,6117,730],{"class":313},[132,6119,733],{"class":313},[132,6121,2677],{"class":149},[132,6123,739],{"class":313},[132,6125,6126,6129,6131],{"class":134,"line":156},[132,6127,6128],{"class":309},"tile_size ",[132,6130,730],{"class":313},[132,6132,3351],{"class":749},[44,6134,6135,6147],{},[47,6136,6137],{},[50,6138,6139,6141,6143,6145],{},[53,6140,908],{},[53,6142,911],{},[53,6144,343],{},[53,6146,346],{},[60,6148,6149,6168],{},[50,6150,6151,6156,6158,6162],{},[65,6152,6153],{},[19,6154,6155],{},"default_resampling",[65,6157,2128],{},[65,6159,6160],{},[19,6161,2677],{},[65,6163,6164,6165,6167],{},"Default resampler. Per-source ",[19,6166,2670],{}," overrides this",[50,6169,6170,6175,6177,6181],{},[65,6171,6172],{},[19,6173,6174],{},"tile_size",[65,6176,1099],{},[65,6178,6179],{},[19,6180,4602],{},[65,6182,6183,6184,6186],{},"Output tile size in pixels (set to ",[19,6185,4722],{}," for retina-native tiles)",[238,6188,6190],{"id":6189},"open-dataset-cache","Open-dataset cache",[10,6192,6193,6194,6197],{},"COG, VRT, DEM and STAC sources share one process-wide cache of open GDAL\ndatasets. Each file has one entry for the full-resolution base and one per\noverview level (",[19,6195,6196],{},"OVERVIEW_LEVEL=N","). Each entry is a small pool of handles,\none per CPU core at most, so concurrent tiles from the same file render in\nparallel.",[10,6199,6200,6201,6204],{},"The cache is bounded by an estimated byte budget, ",[14,6202,6203],{},"256 MiB"," by default.\nEach base handle counts as 16 MiB and each overview handle as 8 MiB. A pool\nkeeps at most 2 idle handles, and entries expire after 10 minutes.",[10,6206,6207],{},"When the budget is full, the server closes idle handles of other files.\nIf that frees too little, the request waits up to 75 ms for a handle, then\nopens the file for this one tile only. A full budget therefore makes tiles\nslower, but it never fails them. These one-tile opens are limited to two per\nCPU core at a time.",[10,6209,6210,6211,6214,6215,26],{},"Set ",[19,6212,6213],{},"TILESERVER_DATASET_CACHE_MAX_BYTES"," to change the budget, for example\nfor large STAC mosaics on a host with more memory. See\n",[105,6216,6218],{"href":6217},"#environment-variables","Environment variables",[28,6220,6222],{"id":6221},"telemetry",[19,6223,6224],{},"[telemetry]",[10,6226,6227,6228,26],{},"OpenTelemetry tracing + Prometheus metrics. See ",[105,6229,202],{"href":201},[123,6231,6233],{"className":710,"code":6232,"language":712,"meta":128,"style":128},"[telemetry]\nenabled = true\nendpoint = \"http:\u002F\u002Flocalhost:4317\"\nservice_name = \"tileserver-rs\"\nsample_rate = 1.0\nmetrics_enabled = true\nmetrics_export_interval_secs = 30\nprometheus_bind = \"127.0.0.1:9100\"\nprometheus_path = \"\u002Fmetrics\"\nmetrics_label_cardinality = \"strict\"\n",[19,6234,6235,6243,6251,6265,6278,6288,6297,6306,6320,6334],{"__ignoreMap":128},[132,6236,6237,6239,6241],{"class":134,"line":135},[132,6238,314],{"class":313},[132,6240,6221],{"class":145},[132,6242,328],{"class":313},[132,6244,6245,6247,6249],{"class":134,"line":142},[132,6246,4635],{"class":309},[132,6248,730],{"class":313},[132,6250,4431],{"class":864},[132,6252,6253,6256,6258,6260,6263],{"class":134,"line":156},[132,6254,6255],{"class":309},"endpoint ",[132,6257,730],{"class":313},[132,6259,733],{"class":313},[132,6261,6262],{"class":149},"http:\u002F\u002Flocalhost:4317",[132,6264,739],{"class":313},[132,6266,6267,6270,6272,6274,6276],{"class":134,"line":166},[132,6268,6269],{"class":309},"service_name ",[132,6271,730],{"class":313},[132,6273,733],{"class":313},[132,6275,146],{"class":149},[132,6277,739],{"class":313},[132,6279,6280,6283,6285],{"class":134,"line":772},[132,6281,6282],{"class":309},"sample_rate ",[132,6284,730],{"class":313},[132,6286,6287],{"class":749}," 1.0\n",[132,6289,6290,6293,6295],{"class":134,"line":787},[132,6291,6292],{"class":309},"metrics_enabled ",[132,6294,730],{"class":313},[132,6296,4431],{"class":864},[132,6298,6299,6302,6304],{"class":134,"line":805},[132,6300,6301],{"class":309},"metrics_export_interval_secs ",[132,6303,730],{"class":313},[132,6305,4529],{"class":749},[132,6307,6308,6311,6313,6315,6318],{"class":134,"line":823},[132,6309,6310],{"class":309},"prometheus_bind ",[132,6312,730],{"class":313},[132,6314,733],{"class":313},[132,6316,6317],{"class":149},"127.0.0.1:9100",[132,6319,739],{"class":313},[132,6321,6322,6325,6327,6329,6332],{"class":134,"line":834},[132,6323,6324],{"class":309},"prometheus_path ",[132,6326,730],{"class":313},[132,6328,733],{"class":313},[132,6330,6331],{"class":149},"\u002Fmetrics",[132,6333,739],{"class":313},[132,6335,6336,6339,6341,6343,6346],{"class":134,"line":845},[132,6337,6338],{"class":309},"metrics_label_cardinality ",[132,6340,730],{"class":313},[132,6342,733],{"class":313},[132,6344,6345],{"class":149},"strict",[132,6347,739],{"class":313},[44,6349,6350,6362],{},[47,6351,6352],{},[50,6353,6354,6356,6358,6360],{},[53,6355,908],{},[53,6357,911],{},[53,6359,343],{},[53,6361,346],{},[60,6363,6364,6379,6396,6416,6435,6453,6469,6491,6508,6535,6555,6572],{},[50,6365,6366,6370,6372,6376],{},[65,6367,6368],{},[19,6369,4699],{},[65,6371,1174],{},[65,6373,6374],{},[19,6375,513],{},[65,6377,6378],{},"Enable OTLP trace export",[50,6380,6381,6386,6388,6393],{},[65,6382,6383],{},[19,6384,6385],{},"endpoint",[65,6387,927],{},[65,6389,6390],{},[19,6391,6392],{},"\"http:\u002F\u002Flocalhost:4317\"",[65,6394,6395],{},"OTLP gRPC endpoint",[50,6397,6398,6403,6405,6410],{},[65,6399,6400],{},[19,6401,6402],{},"service_name",[65,6404,927],{},[65,6406,6407],{},[19,6408,6409],{},"\"tileserver-rs\"",[65,6411,6412,6415],{},[19,6413,6414],{},"service.name"," resource attribute",[50,6417,6418,6423,6425,6429],{},[65,6419,6420],{},[19,6421,6422],{},"sample_rate",[65,6424,3612],{},[65,6426,6427],{},[19,6428,3156],{},[65,6430,6431,6432,6434],{},"Sampling rate (0.0–1.0). ",[19,6433,3156],{}," = export every span",[50,6436,6437,6442,6444,6448],{},[65,6438,6439],{},[19,6440,6441],{},"metrics_enabled",[65,6443,1174],{},[65,6445,6446],{},[19,6447,482],{},[65,6449,6450,6451,227],{},"Enable OTLP metrics export (requires ",[19,6452,4968],{},[50,6454,6455,6460,6462,6466],{},[65,6456,6457],{},[19,6458,6459],{},"metrics_export_interval_secs",[65,6461,4580],{},[65,6463,6464],{},[19,6465,4585],{},[65,6467,6468],{},"OTLP metrics push interval",[50,6470,6471,6476,6478,6482],{},[65,6472,6473],{},[19,6474,6475],{},"prometheus_bind",[65,6477,1066],{},[65,6479,6480],{},[91,6481,543],{},[65,6483,6484,6485,6487,6488],{},"Bind for standalone Prometheus ",[19,6486,6331],{}," listener (independent of OTLP). E.g. ",[19,6489,6490],{},"\"127.0.0.1:9100\"",[50,6492,6493,6498,6500,6505],{},[65,6494,6495],{},[19,6496,6497],{},"prometheus_path",[65,6499,927],{},[65,6501,6502],{},[19,6503,6504],{},"\"\u002Fmetrics\"",[65,6506,6507],{},"HTTP path for the Prometheus exposition endpoint",[50,6509,6510,6515,6517,6522],{},[65,6511,6512],{},[19,6513,6514],{},"metrics_label_cardinality",[65,6516,2128],{},[65,6518,6519],{},[19,6520,6521],{},"\"strict\"",[65,6523,6524,6526,6527,6530,6531,6534],{},[19,6525,6345],{}," (bucketed zoom, no tile coords), ",[19,6528,6529],{},"standard"," (alias of strict), ",[19,6532,6533],{},"verbose"," (full zoom 0..22)",[50,6536,6537,6542,6544,6548],{},[65,6538,6539],{},[19,6540,6541],{},"dashboard",[65,6543,1174],{},[65,6545,6546],{},[19,6547,513],{},[65,6549,6550,6551],{},"Collect per-request statistics for the admin ",[105,6552,6554],{"href":6553},"#analytics-dashboard","analytics dashboard",[50,6556,6557,6562,6564,6569],{},[65,6558,6559],{},[19,6560,6561],{},"dashboard_recent_requests",[65,6563,3592],{},[65,6565,6566],{},[19,6567,6568],{},"200",[65,6570,6571],{},"Requests kept in the dashboard's recent-requests list (max 10000)",[50,6573,6574,6579,6581,6586],{},[65,6575,6576],{},[19,6577,6578],{},"dashboard_heatmap_zoom",[65,6580,3191],{},[65,6582,6583],{},[19,6584,6585],{},"10",[65,6587,6588],{},"Zoom level (0-16) the dashboard heatmap aggregates requests to",[238,6590,6592],{"id":6591},"analytics-dashboard","Analytics dashboard",[10,6594,1469,6595,6598,6599,6602],{},[19,6596,6597],{},"dashboard = true",", the server keeps request statistics in memory and\nthe admin UI shows them at ",[19,6600,6601],{},"\u002Fadmin\u002Fanalytics",", refreshed every 5 seconds:",[2817,6604,6605,6608,6611,6614,6620,6623],{},[218,6606,6607],{},"totals, cache hit rate, error rate and latency percentiles (p50\u002Fp95\u002Fp99);",[218,6609,6610],{},"requests per minute for the last hour, and a latency histogram;",[218,6612,6613],{},"per-source requests, hit rate, latency and average tile size;",[218,6615,6616,6617,6619],{},"a request heatmap (tiles grouped into cells at ",[19,6618,6578],{},")\nand requests per zoom level;",[218,6621,6622],{},"the most requested tiles and the most recent requests;",[218,6624,6625],{},"the global tile cache size and capacity.",[10,6627,6628,6629,6632,6633,6636,6637,3029,6641,6644,6645,6648,6649,6651],{},"The data is bounded (10,000 tracked tiles, 20,000 heatmap cells, 24 hours of\nper-minute counts) and is lost on restart or when a ",[19,6630,6631],{},"dashboard*"," setting\nchanges. The JSON behind the page is ",[19,6634,6635],{},"GET \u002F__admin\u002Fstats"," on the\n",[105,6638,6640],{"href":6639},"#server","admin listener",[19,6642,6643],{},"[server].admin_bind","), like the other ",[19,6646,6647],{},"\u002F__admin","\nendpoints. Prometheus metrics (",[19,6650,6475],{},") are separate and keep\nworking with the dashboard on or off.",[28,6653,6655,1298,6657],{"id":6654},"postgres-feature-postgres",[19,6656,2629],{},[91,6658,2610,6659,227],{},[19,6660,2142],{},[10,6662,6663,6664,26],{},"Top-level PostgreSQL pool + per-source registries. See the\n",[105,6665,6666],{"href":192},"Postgres + OutDB rasters guide",[123,6668,6670],{"className":710,"code":6669,"language":712,"meta":128,"style":128},"[postgres]\nconnection_string = \"postgres:\u002F\u002Fuser:pass@localhost:5432\u002Fdb\"\npool_size = 10\npool_wait_timeout_ms = 5000\npool_pre_warm = true\n\n[postgres.cache]\nsize_mb = 256\nttl_seconds = 300\n\n[[postgres.functions]]\nid = \"trip_aggregates\"\nschema = \"public\"\nfunction = \"mvt_trip_aggregates\"\nminzoom = 6\nmaxzoom = 14\n\n[[postgres.tables]]\nid = \"buildings\"\nschema = \"public\"\ntable = \"osm_buildings\"\ngeometry_column = \"geom\"\nminzoom = 12\nmaxzoom = 18\nextent = 4096\nbuffer = 64\n",[19,6671,6672,6680,6694,6703,6713,6722,6726,6738,6747,6756,6760,6772,6785,6799,6813,6823,6833,6837,6850,6864,6877,6892,6907,6917,6927,6938],{"__ignoreMap":128},[132,6673,6674,6676,6678],{"class":134,"line":135},[132,6675,314],{"class":313},[132,6677,2142],{"class":145},[132,6679,328],{"class":313},[132,6681,6682,6685,6687,6689,6692],{"class":134,"line":142},[132,6683,6684],{"class":309},"connection_string ",[132,6686,730],{"class":313},[132,6688,733],{"class":313},[132,6690,6691],{"class":149},"postgres:\u002F\u002Fuser:pass@localhost:5432\u002Fdb",[132,6693,739],{"class":313},[132,6695,6696,6698,6700],{"class":134,"line":156},[132,6697,4514],{"class":309},[132,6699,730],{"class":313},[132,6701,6702],{"class":749}," 10\n",[132,6704,6705,6708,6710],{"class":134,"line":166},[132,6706,6707],{"class":309},"pool_wait_timeout_ms ",[132,6709,730],{"class":313},[132,6711,6712],{"class":749}," 5000\n",[132,6714,6715,6718,6720],{"class":134,"line":772},[132,6716,6717],{"class":309},"pool_pre_warm ",[132,6719,730],{"class":313},[132,6721,4431],{"class":864},[132,6723,6724],{"class":134,"line":787},[132,6725,3869],{"emptyLinePlaceholder":3868},[132,6727,6728,6730,6732,6734,6736],{"class":134,"line":805},[132,6729,314],{"class":313},[132,6731,2142],{"class":145},[132,6733,26],{"class":309},[132,6735,4611],{"class":145},[132,6737,328],{"class":313},[132,6739,6740,6743,6745],{"class":134,"line":823},[132,6741,6742],{"class":309},"size_mb ",[132,6744,730],{"class":313},[132,6746,3351],{"class":749},[132,6748,6749,6751,6753],{"class":134,"line":834},[132,6750,4654],{"class":309},[132,6752,730],{"class":313},[132,6754,6755],{"class":749}," 300\n",[132,6757,6758],{"class":134,"line":845},[132,6759,3869],{"emptyLinePlaceholder":3868},[132,6761,6762,6764,6766,6768,6770],{"class":134,"line":856},[132,6763,2355],{"class":313},[132,6765,2142],{"class":145},[132,6767,26],{"class":309},[132,6769,2618],{"class":145},[132,6771,2360],{"class":313},[132,6773,6774,6776,6778,6780,6783],{"class":134,"line":871},[132,6775,2365],{"class":309},[132,6777,730],{"class":313},[132,6779,733],{"class":313},[132,6781,6782],{"class":149},"trip_aggregates",[132,6784,739],{"class":313},[132,6786,6787,6790,6792,6794,6797],{"class":134,"line":884},[132,6788,6789],{"class":309},"schema ",[132,6791,730],{"class":313},[132,6793,733],{"class":313},[132,6795,6796],{"class":149},"public",[132,6798,739],{"class":313},[132,6800,6801,6804,6806,6808,6811],{"class":134,"line":3975},[132,6802,6803],{"class":309},"function ",[132,6805,730],{"class":313},[132,6807,733],{"class":313},[132,6809,6810],{"class":149},"mvt_trip_aggregates",[132,6812,739],{"class":313},[132,6814,6815,6818,6820],{"class":134,"line":3980},[132,6816,6817],{"class":309},"minzoom ",[132,6819,730],{"class":313},[132,6821,6822],{"class":749}," 6\n",[132,6824,6825,6828,6830],{"class":134,"line":3997},[132,6826,6827],{"class":309},"maxzoom ",[132,6829,730],{"class":313},[132,6831,6832],{"class":749}," 14\n",[132,6834,6835],{"class":134,"line":4007},[132,6836,3869],{"emptyLinePlaceholder":3868},[132,6838,6840,6842,6844,6846,6848],{"class":134,"line":6839},18,[132,6841,2355],{"class":313},[132,6843,2142],{"class":145},[132,6845,26],{"class":309},[132,6847,2622],{"class":145},[132,6849,2360],{"class":313},[132,6851,6853,6855,6857,6859,6862],{"class":134,"line":6852},19,[132,6854,2365],{"class":309},[132,6856,730],{"class":313},[132,6858,733],{"class":313},[132,6860,6861],{"class":149},"buildings",[132,6863,739],{"class":313},[132,6865,6867,6869,6871,6873,6875],{"class":134,"line":6866},20,[132,6868,6789],{"class":309},[132,6870,730],{"class":313},[132,6872,733],{"class":313},[132,6874,6796],{"class":149},[132,6876,739],{"class":313},[132,6878,6880,6883,6885,6887,6890],{"class":134,"line":6879},21,[132,6881,6882],{"class":309},"table ",[132,6884,730],{"class":313},[132,6886,733],{"class":313},[132,6888,6889],{"class":149},"osm_buildings",[132,6891,739],{"class":313},[132,6893,6895,6898,6900,6902,6905],{"class":134,"line":6894},22,[132,6896,6897],{"class":309},"geometry_column ",[132,6899,730],{"class":313},[132,6901,733],{"class":313},[132,6903,6904],{"class":149},"geom",[132,6906,739],{"class":313},[132,6908,6910,6912,6914],{"class":134,"line":6909},23,[132,6911,6817],{"class":309},[132,6913,730],{"class":313},[132,6915,6916],{"class":749}," 12\n",[132,6918,6920,6922,6924],{"class":134,"line":6919},24,[132,6921,6827],{"class":309},[132,6923,730],{"class":313},[132,6925,6926],{"class":749}," 18\n",[132,6928,6930,6933,6935],{"class":134,"line":6929},25,[132,6931,6932],{"class":309},"extent ",[132,6934,730],{"class":313},[132,6936,6937],{"class":749}," 4096\n",[132,6939,6941,6944,6946],{"class":134,"line":6940},26,[132,6942,6943],{"class":309},"buffer ",[132,6945,730],{"class":313},[132,6947,6948],{"class":749}," 64\n",[238,6950,6952,6954],{"id":6951},"postgres-root",[19,6953,2629],{}," root",[44,6956,6957,6969],{},[47,6958,6959],{},[50,6960,6961,6963,6965,6967],{},[53,6962,908],{},[53,6964,911],{},[53,6966,343],{},[53,6968,346],{},[60,6970,6971,6988,7004,7021,7038,7055,7071],{},[50,6972,6973,6978,6980,6985],{},[65,6974,6975],{},[19,6976,6977],{},"connection_string",[65,6979,927],{},[65,6981,6982],{},[91,6983,6984],{},"req",[65,6986,6987],{},"Postgres connection URI",[50,6989,6990,6994,6996,7001],{},[65,6991,6992],{},[19,6993,4561],{},[65,6995,3592],{},[65,6997,6998],{},[19,6999,7000],{},"20",[65,7002,7003],{},"Connections in the pool",[50,7005,7006,7011,7013,7018],{},[65,7007,7008],{},[19,7009,7010],{},"pool_wait_timeout_ms",[65,7012,4580],{},[65,7014,7015],{},[19,7016,7017],{},"30000",[65,7019,7020],{},"Max ms to wait for a free connection",[50,7022,7023,7028,7030,7035],{},[65,7024,7025],{},[19,7026,7027],{},"pool_create_timeout_ms",[65,7029,4580],{},[65,7031,7032],{},[19,7033,7034],{},"10000",[65,7036,7037],{},"Max ms to wait when opening a new connection",[50,7039,7040,7045,7047,7052],{},[65,7041,7042],{},[19,7043,7044],{},"pool_recycle_timeout_ms",[65,7046,4580],{},[65,7048,7049],{},[19,7050,7051],{},"5000",[65,7053,7054],{},"Max ms to wait recycling a stale connection",[50,7056,7057,7062,7064,7068],{},[65,7058,7059],{},[19,7060,7061],{},"pool_pre_warm",[65,7063,1174],{},[65,7065,7066],{},[19,7067,513],{},[65,7069,7070],{},"Open all pool connections at startup",[50,7072,7073,7084,7086,7090],{},[65,7074,7075,80,7078,80,7081],{},[19,7076,7077],{},"ssl_cert",[19,7079,7080],{},"ssl_key",[19,7082,7083],{},"ssl_root_cert",[65,7085,1083],{},[65,7087,7088],{},[91,7089,543],{},[65,7091,7092],{},"mTLS \u002F verify-full SSL material",[238,7094,7096],{"id":7095},"postgrescache",[19,7097,7098],{},"[postgres.cache]",[44,7100,7101,7113],{},[47,7102,7103],{},[50,7104,7105,7107,7109,7111],{},[53,7106,908],{},[53,7108,911],{},[53,7110,343],{},[53,7112,346],{},[60,7114,7115,7131],{},[50,7116,7117,7122,7124,7128],{},[65,7118,7119],{},[19,7120,7121],{},"size_mb",[65,7123,4580],{},[65,7125,7126],{},[19,7127,4602],{},[65,7129,7130],{},"Max cache size for Postgres MVT tiles",[50,7132,7133,7137,7139,7144],{},[65,7134,7135],{},[19,7136,4732],{},[65,7138,4580],{},[65,7140,7141],{},[19,7142,7143],{},"300",[65,7145,7146],{},"TTL per entry",[238,7148,7150],{"id":7149},"postgresfunctions",[19,7151,7152],{},"[[postgres.functions]]",[44,7154,7155,7167],{},[47,7156,7157],{},[50,7158,7159,7161,7163,7165],{},[53,7160,908],{},[53,7162,911],{},[53,7164,343],{},[53,7166,346],{},[60,7168,7169,7184,7200,7216,7231,7247],{},[50,7170,7171,7175,7177,7181],{},[65,7172,7173],{},[19,7174,2107],{},[65,7176,927],{},[65,7178,7179],{},[91,7180,6984],{},[65,7182,7183],{},"Source ID",[50,7185,7186,7191,7193,7197],{},[65,7187,7188],{},[19,7189,7190],{},"schema",[65,7192,927],{},[65,7194,7195],{},[91,7196,6984],{},[65,7198,7199],{},"Postgres schema",[50,7201,7202,7207,7209,7213],{},[65,7203,7204],{},[19,7205,7206],{},"function",[65,7208,927],{},[65,7210,7211],{},[91,7212,6984],{},[65,7214,7215],{},"Function name (takes z\u002Fx\u002Fy, returns bytea)",[50,7217,7218,7222,7224,7228],{},[65,7219,7220],{},[19,7221,2236],{},[65,7223,3191],{},[65,7225,7226],{},[19,7227,6047],{},[65,7229,7230],{},"Min zoom",[50,7232,7233,7237,7239,7244],{},[65,7234,7235],{},[19,7236,2251],{},[65,7238,3191],{},[65,7240,7241],{},[19,7242,7243],{},"22",[65,7245,7246],{},"Max zoom",[50,7248,7249,7253,7257,7261],{},[65,7250,7251],{},[19,7252,2421],{},[65,7254,3612,7255,3195],{},[132,7256,3194],{},[65,7258,7259],{},[91,7260,543],{},[65,7262,7263],{},"Geographic bounds",[238,7265,7267],{"id":7266},"postgrestables",[19,7268,7269],{},"[[postgres.tables]]",[44,7271,7272,7284],{},[47,7273,7274],{},[50,7275,7276,7278,7280,7282],{},[53,7277,908],{},[53,7279,911],{},[53,7281,343],{},[53,7283,346],{},[60,7285,7286,7300,7314,7329,7344,7360,7379,7393,7407,7424,7441,7457],{},[50,7287,7288,7292,7294,7298],{},[65,7289,7290],{},[19,7291,2107],{},[65,7293,927],{},[65,7295,7296],{},[91,7297,6984],{},[65,7299,7183],{},[50,7301,7302,7306,7308,7312],{},[65,7303,7304],{},[19,7305,7190],{},[65,7307,927],{},[65,7309,7310],{},[91,7311,6984],{},[65,7313,7199],{},[50,7315,7316,7320,7322,7326],{},[65,7317,7318],{},[19,7319,44],{},[65,7321,927],{},[65,7323,7324],{},[91,7325,6984],{},[65,7327,7328],{},"Table name",[50,7330,7331,7335,7337,7341],{},[65,7332,7333],{},[19,7334,3458],{},[65,7336,1066],{},[65,7338,7339],{},[19,7340,6904],{},[65,7342,7343],{},"Geometry column",[50,7345,7346,7351,7353,7357],{},[65,7347,7348],{},[19,7349,7350],{},"id_column",[65,7352,1066],{},[65,7354,7355],{},[91,7356,543],{},[65,7358,7359],{},"Optional integer ID column carried into MVT features",[50,7361,7362,7367,7371,7376],{},[65,7363,7364],{},[19,7365,7366],{},"properties",[65,7368,927,7369,3195],{},[132,7370],{},[65,7372,7373],{},[91,7374,7375],{},"all",[65,7377,7378],{},"Column allow-list for MVT properties",[50,7380,7381,7385,7387,7391],{},[65,7382,7383],{},[19,7384,2236],{},[65,7386,3191],{},[65,7388,7389],{},[19,7390,6047],{},[65,7392,7230],{},[50,7394,7395,7399,7401,7405],{},[65,7396,7397],{},[19,7398,2251],{},[65,7400,3191],{},[65,7402,7403],{},[19,7404,7243],{},[65,7406,7246],{},[50,7408,7409,7414,7416,7421],{},[65,7410,7411],{},[19,7412,7413],{},"extent",[65,7415,1099],{},[65,7417,7418],{},[19,7419,7420],{},"4096",[65,7422,7423],{},"MVT extent (4096 = standard)",[50,7425,7426,7431,7433,7438],{},[65,7427,7428],{},[19,7429,7430],{},"buffer",[65,7432,1099],{},[65,7434,7435],{},[19,7436,7437],{},"64",[65,7439,7440],{},"Per-tile geometry buffer in pixels (auto-set to 0 for POINT\u002FMULTIPOINT)",[50,7442,7443,7448,7450,7454],{},[65,7444,7445],{},[19,7446,7447],{},"max_features",[65,7449,3133],{},[65,7451,7452],{},[91,7453,543],{},[65,7455,7456],{},"Hard cap on emitted features per tile",[50,7458,7459,7464,7466,7470],{},[65,7460,7461],{},[19,7462,7463],{},"writable",[65,7465,1174],{},[65,7467,7468],{},[19,7469,513],{},[65,7471,7472],{},"Enable OGC API Features POST\u002FPATCH\u002FDELETE on this table",[28,7474,7476,1298,7479],{"id":7475},"mcp-feature-mcp",[19,7477,7478],{},"[mcp]",[91,7480,2610,7481,227],{},[19,7482,560],{},[10,7484,7485,7486,7489],{},"See the ",[105,7487,7488],{"href":196},"MCP guide"," for transport + tool details.",[123,7491,7493],{"className":710,"code":7492,"language":712,"meta":128,"style":128},"[mcp]\nenabled = true\nauth_token = \"supersecret\"           # bearer-token mode\ncors_origins = [\"https:\u002F\u002Fclaude.ai\"]\n\n[mcp.oauth]\nenabled = false                       # mutually exclusive with auth_token\nissuer_url = \"https:\u002F\u002Ftiles.example.com\"\nsigning_key_path = \"\u002Fetc\u002Ftileserver\u002Fmcp-jwt-key.pem\"\napproval_secret = \"${MCP_APPROVAL_SECRET}\"  # operator code the consent page asks for\ntoken_ttl_secs = 3600\n# store_path = \"\u002Fvar\u002Flib\u002Ftileserver-rs\u002Foauth-store.sqlite\"  # requires mcp-persistence\n",[19,7494,7495,7503,7511,7528,7545,7549,7562,7573,7586,7600,7617,7626],{"__ignoreMap":128},[132,7496,7497,7499,7501],{"class":134,"line":135},[132,7498,314],{"class":313},[132,7500,560],{"class":145},[132,7502,328],{"class":313},[132,7504,7505,7507,7509],{"class":134,"line":142},[132,7506,4635],{"class":309},[132,7508,730],{"class":313},[132,7510,4431],{"class":864},[132,7512,7513,7516,7518,7520,7523,7525],{"class":134,"line":156},[132,7514,7515],{"class":309},"auth_token ",[132,7517,730],{"class":313},[132,7519,733],{"class":313},[132,7521,7522],{"class":149},"supersecret",[132,7524,762],{"class":313},[132,7526,7527],{"class":138},"           # bearer-token mode\n",[132,7529,7530,7532,7534,7536,7538,7541,7543],{"class":134,"line":166},[132,7531,755],{"class":309},[132,7533,730],{"class":313},[132,7535,322],{"class":313},[132,7537,762],{"class":313},[132,7539,7540],{"class":149},"https:\u002F\u002Fclaude.ai",[132,7542,762],{"class":313},[132,7544,328],{"class":313},[132,7546,7547],{"class":134,"line":772},[132,7548,3869],{"emptyLinePlaceholder":3868},[132,7550,7551,7553,7555,7557,7560],{"class":134,"line":787},[132,7552,314],{"class":313},[132,7554,560],{"class":145},[132,7556,26],{"class":309},[132,7558,7559],{"class":145},"oauth",[132,7561,328],{"class":313},[132,7563,7564,7566,7568,7570],{"class":134,"line":805},[132,7565,4635],{"class":309},[132,7567,730],{"class":313},[132,7569,865],{"class":864},[132,7571,7572],{"class":138},"                       # mutually exclusive with auth_token\n",[132,7574,7575,7578,7580,7582,7584],{"class":134,"line":823},[132,7576,7577],{"class":309},"issuer_url ",[132,7579,730],{"class":313},[132,7581,733],{"class":313},[132,7583,797],{"class":149},[132,7585,739],{"class":313},[132,7587,7588,7591,7593,7595,7598],{"class":134,"line":834},[132,7589,7590],{"class":309},"signing_key_path ",[132,7592,730],{"class":313},[132,7594,733],{"class":313},[132,7596,7597],{"class":149},"\u002Fetc\u002Ftileserver\u002Fmcp-jwt-key.pem",[132,7599,739],{"class":313},[132,7601,7602,7605,7607,7609,7612,7614],{"class":134,"line":845},[132,7603,7604],{"class":309},"approval_secret ",[132,7606,730],{"class":313},[132,7608,733],{"class":313},[132,7610,7611],{"class":149},"${MCP_APPROVAL_SECRET}",[132,7613,762],{"class":313},[132,7615,7616],{"class":138},"  # operator code the consent page asks for\n",[132,7618,7619,7622,7624],{"class":134,"line":856},[132,7620,7621],{"class":309},"token_ttl_secs ",[132,7623,730],{"class":313},[132,7625,4659],{"class":749},[132,7627,7628],{"class":134,"line":871},[132,7629,7630],{"class":138},"# store_path = \"\u002Fvar\u002Flib\u002Ftileserver-rs\u002Foauth-store.sqlite\"  # requires mcp-persistence\n",[238,7632,7634,6954],{"id":7633},"mcp-root",[19,7635,7478],{},[44,7637,7638,7650],{},[47,7639,7640],{},[50,7641,7642,7644,7646,7648],{},[53,7643,908],{},[53,7645,911],{},[53,7647,343],{},[53,7649,346],{},[60,7651,7652,7671,7698],{},[50,7653,7654,7658,7660,7664],{},[65,7655,7656],{},[19,7657,4699],{},[65,7659,1174],{},[65,7661,7662],{},[19,7663,513],{},[65,7665,7666,7667,7670],{},"Mount the ",[19,7668,7669],{},"\u002Fmcp"," Streamable HTTP service",[50,7672,7673,7678,7680,7684],{},[65,7674,7675],{},[19,7676,7677],{},"auth_token",[65,7679,1066],{},[65,7681,7682],{},[91,7683,543],{},[65,7685,7686,7687,7693,7694,7697],{},"Static bearer token. ",[14,7688,7689,7690],{},"Mutually exclusive with ",[19,7691,7692],{},"oauth.enabled = true",". Startup fails if it is empty or an unset ",[19,7695,7696],{},"${VAR}","; under 16 characters logs a warning",[50,7699,7700,7704,7708,7712],{},[65,7701,7702],{},[19,7703,960],{},[65,7705,927,7706],{},[132,7707],{},[65,7709,7710],{},[19,7711,969],{},[65,7713,7714,7715,7717],{},"CORS allow-list for ",[19,7716,7669],{}," (lock down in production)",[238,7719,7721],{"id":7720},"mcpoauth",[19,7722,7723],{},"[mcp.oauth]",[44,7725,7726,7738],{},[47,7727,7728],{},[50,7729,7730,7732,7734,7736],{},[53,7731,908],{},[53,7733,911],{},[53,7735,343],{},[53,7737,346],{},[60,7739,7740,7755,7774,7792,7812,7828],{},[50,7741,7742,7746,7748,7752],{},[65,7743,7744],{},[19,7745,4699],{},[65,7747,1174],{},[65,7749,7750],{},[19,7751,513],{},[65,7753,7754],{},"Enable RFC 7591 DCR + JWT RS256 OAuth flow",[50,7756,7757,7762,7764,7768],{},[65,7758,7759],{},[19,7760,7761],{},"issuer_url",[65,7763,1066],{},[65,7765,7766],{},[91,7767,543],{},[65,7769,7770,7771,7773],{},"Required when ",[19,7772,4968],{},". Must match the public URL",[50,7775,7776,7781,7783,7787],{},[65,7777,7778],{},[19,7779,7780],{},"signing_key_path",[65,7782,1083],{},[65,7784,7785],{},[91,7786,543],{},[65,7788,7770,7789,7791],{},[19,7790,4968],{},". RSA PKCS#8 PEM private key",[50,7793,7794,7799,7801,7805],{},[65,7795,7796],{},[19,7797,7798],{},"approval_secret",[65,7800,1066],{},[65,7802,7803],{},[91,7804,543],{},[65,7806,7770,7807,7809,7810],{},[19,7808,4968],{},". Operator code the consent page asks for before it issues an authorization code. Without it, anyone could approve themselves. Startup fails if it is empty or an unset ",[19,7811,7696],{},[50,7813,7814,7819,7821,7825],{},[65,7815,7816],{},[19,7817,7818],{},"token_ttl_secs",[65,7820,4580],{},[65,7822,7823],{},[19,7824,4739],{},[65,7826,7827],{},"Access-token TTL (clamped to 86400)",[50,7829,7830,7835,7837,7841],{},[65,7831,7832],{},[19,7833,7834],{},"store_path",[65,7836,1083],{},[65,7838,7839],{},[91,7840,543],{},[65,7842,7843,7844,7847],{},"SQLite file persisting OAuth state across restarts. Requires ",[19,7845,7846],{},"mcp-persistence","; fails fast without it",[28,7849,7851],{"id":7850},"top-level-fields","Top-level fields",[44,7853,7854,7866],{},[47,7855,7856],{},[50,7857,7858,7860,7862,7864],{},[53,7859,908],{},[53,7861,911],{},[53,7863,343],{},[53,7865,346],{},[60,7867,7868,7887],{},[50,7869,7870,7875,7877,7881],{},[65,7871,7872],{},[19,7873,7874],{},"fonts",[65,7876,1083],{},[65,7878,7879],{},[91,7880,543],{},[65,7882,7883,7884],{},"Directory of PBF glyph files served at ",[19,7885,7886],{},"\u002Ffonts\u002F{stack}\u002F{range}.pbf",[50,7888,7889,7894,7896,7900],{},[65,7890,7891],{},[19,7892,7893],{},"files",[65,7895,1083],{},[65,7897,7898],{},[91,7899,543],{},[65,7901,7902,7903],{},"Directory of static files served at ",[19,7904,7905],{},"\u002Ffiles\u002F{filename}",[28,7907,2299],{"id":7908},"cloud-sources",[10,7910,7911,7912,7914,7915,213],{},"For PMTiles hosted on S3, GCS, or Azure, set the URL on ",[19,7913,2165],{}," and pass\ncredentials via ",[19,7916,2288],{},[123,7918,7920],{"className":710,"code":7919,"language":712,"meta":128,"style":128},"[[sources]]\nid = \"global\"\ntype = \"pmtiles\"\npath = \"s3:\u002F\u002Ftiles-bucket\u002Fglobal.pmtiles\"\n\n[sources.options]\naws_region = \"us-east-1\"\naws_access_key_id = \"...\"\naws_secret_access_key = \"...\"\n",[19,7921,7922,7930,7943,7955,7968,7972,7984,7998,8011],{"__ignoreMap":128},[132,7923,7924,7926,7928],{"class":134,"line":135},[132,7925,2355],{"class":313},[132,7927,2066],{"class":145},[132,7929,2360],{"class":313},[132,7931,7932,7934,7936,7938,7941],{"class":134,"line":142},[132,7933,2365],{"class":309},[132,7935,730],{"class":313},[132,7937,733],{"class":313},[132,7939,7940],{"class":149},"global",[132,7942,739],{"class":313},[132,7944,7945,7947,7949,7951,7953],{"class":134,"line":156},[132,7946,2379],{"class":309},[132,7948,730],{"class":313},[132,7950,733],{"class":313},[132,7952,2136],{"class":149},[132,7954,739],{"class":313},[132,7956,7957,7959,7961,7963,7966],{"class":134,"line":166},[132,7958,2393],{"class":309},[132,7960,730],{"class":313},[132,7962,733],{"class":313},[132,7964,7965],{"class":149},"s3:\u002F\u002Ftiles-bucket\u002Fglobal.pmtiles",[132,7967,739],{"class":313},[132,7969,7970],{"class":134,"line":772},[132,7971,3869],{"emptyLinePlaceholder":3868},[132,7973,7974,7976,7978,7980,7982],{"class":134,"line":787},[132,7975,314],{"class":313},[132,7977,2066],{"class":145},[132,7979,26],{"class":309},[132,7981,2288],{"class":145},[132,7983,328],{"class":313},[132,7985,7986,7989,7991,7993,7996],{"class":134,"line":805},[132,7987,7988],{"class":309},"aws_region ",[132,7990,730],{"class":313},[132,7992,733],{"class":313},[132,7994,7995],{"class":149},"us-east-1",[132,7997,739],{"class":313},[132,7999,8000,8003,8005,8007,8009],{"class":134,"line":823},[132,8001,8002],{"class":309},"aws_access_key_id ",[132,8004,730],{"class":313},[132,8006,733],{"class":313},[132,8008,5433],{"class":149},[132,8010,739],{"class":313},[132,8012,8013,8016,8018,8020,8022],{"class":134,"line":834},[132,8014,8015],{"class":309},"aws_secret_access_key ",[132,8017,730],{"class":313},[132,8019,733],{"class":313},[132,8021,5433],{"class":149},[132,8023,739],{"class":313},[10,8025,8026,8027,8029,8030,8037],{},"Keys in ",[19,8028,2288],{}," are forwarded verbatim to\n",[105,8031,8034],{"href":8032,"rel":8033},"https:\u002F\u002Fdocs.rs\u002Fobject_store\u002Flatest\u002Fobject_store\u002Ffn.parse_url_opts.html",[109],[19,8035,8036],{},"object_store::parse_url_opts",".\nSee the object_store docs for the full list per backend.",[28,8039,4394],{"id":8040},"sftp-sources",[10,8042,8043,8044,8046],{},"With the opt-in ",[19,8045,4387],{}," feature, PMTiles can be served straight over SSH:",[123,8048,8050],{"className":710,"code":8049,"language":712,"meta":128,"style":128},"[[sources]]\nid = \"remote\"\ntype = \"pmtiles\"\npath = \"sftp:\u002F\u002Ftileuser@tiles.example.com:22\u002Fvar\u002Fdata\u002Fplanet.pmtiles\"\n\n[sources.options]\nssh_identity = \"\u002Fhome\u002Ftileserver\u002F.ssh\u002Fid_ed25519\"  # optional override\n",[19,8051,8052,8060,8073,8085,8098,8102,8114],{"__ignoreMap":128},[132,8053,8054,8056,8058],{"class":134,"line":135},[132,8055,2355],{"class":313},[132,8057,2066],{"class":145},[132,8059,2360],{"class":313},[132,8061,8062,8064,8066,8068,8071],{"class":134,"line":142},[132,8063,2365],{"class":309},[132,8065,730],{"class":313},[132,8067,733],{"class":313},[132,8069,8070],{"class":149},"remote",[132,8072,739],{"class":313},[132,8074,8075,8077,8079,8081,8083],{"class":134,"line":156},[132,8076,2379],{"class":309},[132,8078,730],{"class":313},[132,8080,733],{"class":313},[132,8082,2136],{"class":149},[132,8084,739],{"class":313},[132,8086,8087,8089,8091,8093,8096],{"class":134,"line":166},[132,8088,2393],{"class":309},[132,8090,730],{"class":313},[132,8092,733],{"class":313},[132,8094,8095],{"class":149},"sftp:\u002F\u002Ftileuser@tiles.example.com:22\u002Fvar\u002Fdata\u002Fplanet.pmtiles",[132,8097,739],{"class":313},[132,8099,8100],{"class":134,"line":772},[132,8101,3869],{"emptyLinePlaceholder":3868},[132,8103,8104,8106,8108,8110,8112],{"class":134,"line":787},[132,8105,314],{"class":313},[132,8107,2066],{"class":145},[132,8109,26],{"class":309},[132,8111,2288],{"class":145},[132,8113,328],{"class":313},[132,8115,8116,8119,8121,8123,8126,8128],{"class":134,"line":805},[132,8117,8118],{"class":309},"ssh_identity ",[132,8120,730],{"class":313},[132,8122,733],{"class":313},[132,8124,8125],{"class":149},"\u002Fhome\u002Ftileserver\u002F.ssh\u002Fid_ed25519",[132,8127,762],{"class":313},[132,8129,8130],{"class":138},"  # optional override\n",[10,8132,8133,8134,8137,8138,8141,8142,8145,8146,2311,8149,8152,8153,8156,8157,8160,8161,8164,8165,8169],{},"Identity resolution precedence: per-source ",[19,8135,8136],{},"options.ssh_identity"," →\n",[19,8139,8140],{},"TILESERVER_SSH_IDENTITY"," env var → ",[19,8143,8144],{},"--ssh-identity"," CLI flag →\n",[19,8147,8148],{},"~\u002F.ssh\u002Fid_ed25519",[19,8150,8151],{},"~\u002F.ssh\u002Fid_rsa"," → SSH agent (",[19,8154,8155],{},"SSH_AUTH_SOCK",").\nHost keys are verified against ",[19,8158,8159],{},"known_hosts"," (fail-closed); set a global\ndefault via ",[19,8162,8163],{},"[sftp] known_hosts_path",". See the\n",[105,8166,8168],{"href":8167},"\u002Fguides\u002Fsftp","SFTP Sources guide"," for the full reference and security\nguidance.",[28,8171,8173],{"id":8172},"cargo-features","Cargo features",[10,8175,4912,8176,8180,8181,26],{},[105,8177,8179],{"href":8178},"\u002Fgetting-started\u002Finstallation#build-from-source","building from source",",\ntoggle feature flags to slim the binary or enable optional integrations.\nThe values below are the source of truth, mirrored from\n",[105,8182,8185],{"href":8183,"rel":8184},"https:\u002F\u002Fgithub.com\u002Fvinayakkulkarni\u002Ftileserver-rs\u002Fblob\u002Fmain\u002Fcrates\u002Ftileserver-rs\u002FCargo.toml",[109],[19,8186,8187],{},"crates\u002Ftileserver-rs\u002FCargo.toml",[44,8189,8190,8201],{},[47,8191,8192],{},[50,8193,8194,8197,8199],{},[53,8195,8196],{},"Feature",[53,8198,343],{},[53,8200,346],{},[60,8202,8203,8215,8226,8237,8252,8265,8278,8294,8312,8323,8334,8345,8358],{},[50,8204,8205,8209,8212],{},[65,8206,8207],{},[19,8208,2142],{},[65,8210,8211],{},"Yes",[65,8213,8214],{},"PostgreSQL \u002F PostGIS tile sources (tables + functions); OGC API Features; CQL2 filter",[50,8216,8217,8221,8223],{},[65,8218,8219],{},[19,8220,2647],{},[65,8222,8211],{},[65,8224,8225],{},"GDAL-based COG \u002F VRT raster sources with colormap + band math",[50,8227,8228,8232,8234],{},[65,8229,8230],{},[19,8231,2280],{},[65,8233,8211],{},[65,8235,8236],{},"MLT (MapLibre Tiles) ↔ MVT on-the-fly transcoding",[50,8238,8239,8244,8246],{},[65,8240,8241],{},[19,8242,8243],{},"cloud",[65,8245,8211],{},[65,8247,8248,8249],{},"Cloud PMTiles (S3 \u002F GCS \u002F Azure \u002F HTTPS) via ",[19,8250,8251],{},"object_store",[50,8253,8254,8258,8260],{},[65,8255,8256],{},[19,8257,2157],{},[65,8259,8211],{},[65,8261,8262,8263,227],{},"STAC catalog source (implies ",[19,8264,2647],{},[50,8266,8267,8271,8273],{},[65,8268,8269],{},[19,8270,3019],{},[65,8272,8211],{},[65,8274,8275,8276,227],{},"DEM terrain-RGB tile encoding — Terrarium & Mapbox-RGB (implies ",[19,8277,2647],{},[50,8279,8280,8285,8287],{},[65,8281,8282],{},[19,8283,8284],{},"cel",[65,8286,8211],{},[65,8288,8289,8290],{},"Per-feature CEL filtering of vector tiles — see ",[105,8291,8293],{"href":8292},"\u002Fguides\u002Fcel-filters","CEL Feature Filters",[50,8295,8296,8300,8303],{},[65,8297,8298],{},[19,8299,4387],{},[65,8301,8302],{},"No",[65,8304,8305,8306,8308,8309],{},"PMTiles over SSH (",[19,8307,2185],{}," URLs) via russh — see ",[105,8310,8311],{"href":8167},"SFTP Sources",[50,8313,8314,8318,8320],{},[65,8315,8316],{},[19,8317,2151],{},[65,8319,8302],{},[65,8321,8322],{},"Serve tiles from GeoParquet files on-the-fly (Arrow + Parquet)",[50,8324,8325,8329,8331],{},[65,8326,8327],{},[19,8328,2154],{},[65,8330,8302],{},[65,8332,8333],{},"Embedded DuckDB SQL-driven tile source",[50,8335,8336,8340,8342],{},[65,8337,8338],{},[19,8339,560],{},[65,8341,8302],{},[65,8343,8344],{},"MCP server (stdio + Streamable HTTP) with optional OAuth",[50,8346,8347,8351,8353],{},[65,8348,8349],{},[19,8350,7846],{},[65,8352,8302],{},[65,8354,8355,8356,227],{},"Disk-backed SQLite store for the MCP OAuth state (implies ",[19,8357,560],{},[50,8359,8360,8365,8367],{},[65,8361,8362],{},[19,8363,8364],{},"frontend",[65,8366,8302],{},[65,8368,8369],{},"Embed the Nuxt web UI into the binary (always-on for prebuilt artifacts)",[123,8371,8373],{"className":125,"code":8372,"language":127,"meta":128,"style":128},"# Minimal API-only build (no GDAL, no Postgres, no MLT, no cloud):\ncargo build --release --no-default-features\n\n# Default features (postgres + raster + mlt + cloud + stac + dem + cel):\ncargo build --release\n\n# Everything, including the web UI and MCP server:\ncargo build --release --all-features\n",[19,8374,8375,8380,8394,8398,8403,8412,8416,8421],{"__ignoreMap":128},[132,8376,8377],{"class":134,"line":135},[132,8378,8379],{"class":138},"# Minimal API-only build (no GDAL, no Postgres, no MLT, no cloud):\n",[132,8381,8382,8385,8388,8391],{"class":134,"line":142},[132,8383,8384],{"class":145},"cargo",[132,8386,8387],{"class":149}," build",[132,8389,8390],{"class":149}," --release",[132,8392,8393],{"class":149}," --no-default-features\n",[132,8395,8396],{"class":134,"line":156},[132,8397,3869],{"emptyLinePlaceholder":3868},[132,8399,8400],{"class":134,"line":166},[132,8401,8402],{"class":138},"# Default features (postgres + raster + mlt + cloud + stac + dem + cel):\n",[132,8404,8405,8407,8409],{"class":134,"line":772},[132,8406,8384],{"class":145},[132,8408,8387],{"class":149},[132,8410,8411],{"class":149}," --release\n",[132,8413,8414],{"class":134,"line":787},[132,8415,3869],{"emptyLinePlaceholder":3868},[132,8417,8418],{"class":134,"line":805},[132,8419,8420],{"class":138},"# Everything, including the web UI and MCP server:\n",[132,8422,8423,8425,8427,8429],{"class":134,"line":823},[132,8424,8384],{"class":145},[132,8426,8387],{"class":149},[132,8428,8390],{"class":149},[132,8430,8431],{"class":149}," --all-features\n",[3003,8433,8434],{"type":3005},[10,8435,1483,8436,8438,8439,8441],{},[19,8437,8364],{}," feature is intentionally ",[14,8440,4760],{}," a default feature so the\nbackend can be compiled without building the Nuxt frontend first.\nPre-built binaries, Docker images, and Homebrew bottles always ship with\nit included.",[28,8443,6218],{"id":8444},"environment-variables",[238,8446,8448],{"id":8447},"server-rust-binary","Server (Rust binary)",[44,8450,8451,8462],{},[47,8452,8453],{},[50,8454,8455,8458,8460],{},[53,8456,8457],{},"Variable",[53,8459,911],{},[53,8461,346],{},[60,8463,8464,8477,8492,8504,8517,8529,8549,8569],{},[50,8465,8466,8470,8472],{},[65,8467,8468],{},[19,8469,376],{},[65,8471,2165],{},[65,8473,8474,8475],{},"Equivalent to ",[19,8476,254],{},[50,8478,8479,8483,8485],{},[65,8480,8481],{},[19,8482,393],{},[65,8484,2165],{},[65,8486,8474,8487,8489,8490,227],{},[19,8488,388],{}," (overrides ",[19,8491,404],{},[50,8493,8494,8498,8500],{},[65,8495,8496],{},[19,8497,416],{},[65,8499,927],{},[65,8501,8474,8502],{},[19,8503,411],{},[50,8505,8506,8510,8512],{},[65,8507,8508],{},[19,8509,437],{},[65,8511,945],{},[65,8513,8474,8514],{},[19,8515,8516],{},"--port \u003CPORT>",[50,8518,8519,8523,8525],{},[65,8520,8521],{},[19,8522,456],{},[65,8524,5420],{},[65,8526,8474,8527],{},[19,8528,451],{},[50,8530,8531,8535,8537],{},[65,8532,8533],{},[19,8534,477],{},[65,8536,1174],{},[65,8538,8474,8539,2311,8541,8543,8544,1039,8546,227],{},[19,8540,472],{},[19,8542,492],{}," (string ",[19,8545,3661],{},[19,8547,8548],{},"\"false\"",[50,8550,8551,8555,8557],{},[65,8552,8553],{},[19,8554,6213],{},[65,8556,4580],{},[65,8558,8559,8560,8564,8565,8568],{},"Byte budget of the ",[105,8561,8563],{"href":8562},"#open-dataset-cache","open-dataset cache"," (default ",[19,8566,8567],{},"268435456",", 256 MiB). Zero or an invalid value uses the default",[50,8570,8571,8576,8579],{},[65,8572,8573],{},[19,8574,8575],{},"RUST_LOG",[65,8577,8578],{},"log spec",[65,8580,8581,8584,8585],{},[19,8582,8583],{},"tracing_subscriber::EnvFilter"," directives, e.g. ",[19,8586,8587],{},"tileserver_rs=debug",[238,8589,8591],{"id":8590},"client-nuxt-dev-server","Client (Nuxt dev server)",[10,8593,8594,8595,8598],{},"These only affect ",[19,8596,8597],{},"pnpm dev:client",". Production builds embed the SPA in\nthe Rust binary and serve same-origin, so no proxy is involved.",[44,8600,8601,8611],{},[47,8602,8603],{},[50,8604,8605,8607,8609],{},[53,8606,8457],{},[53,8608,343],{},[53,8610,346],{},[60,8612,8613,8627],{},[50,8614,8615,8620,8624],{},[65,8616,8617],{},[19,8618,8619],{},"TILESERVER_BACKEND_PORT",[65,8621,8622],{},[19,8623,950],{},[65,8625,8626],{},"Port of the public Rust backend the Vite dev proxy forwards to",[50,8628,8629,8634,8639],{},[65,8630,8631],{},[19,8632,8633],{},"TILESERVER_ADMIN_PORT",[65,8635,8636],{},[19,8637,8638],{},"8081",[65,8640,8641,8642,8644,8645,8648],{},"Port of the admin backend (",[19,8643,6643],{},") for ",[19,8646,8647],{},"\u002F__admin\u002F*"," proxying",[3003,8650,8651],{"type":4764},[10,8652,8653,8654,8656,8657,8660,8661,8664,8665,8668,8669,8672],{},"The client env vars are deliberately ",[14,8655,4760],{}," prefixed ",[19,8658,8659],{},"NUXT_",". The\n",[19,8662,8663],{},"NUXT_*"," prefix is reserved by Nuxt for ",[19,8666,8667],{},"runtimeConfig"," auto-mapping;\nthese are build-time env vars read by ",[19,8670,8671],{},"nuxt.config.ts"," directly.",[10,8674,2723,8675,8679],{},[105,8676,8678],{"href":8677},"\u002Fdevelopment\u002Ffrontend-dev","Frontend development"," for more.",[8681,8682,8683],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}",{"title":128,"searchDepth":142,"depth":142,"links":8685},[8686,8687,8690,8694,8699,8707,8708,8709,8711,8712,8713,8714,8717,8718,8722,8725,8733,8739,8740,8741,8742,8743],{"id":30,"depth":142,"text":31},{"id":205,"depth":142,"text":206,"children":8688},[8689],{"id":240,"depth":156,"text":241},{"id":296,"depth":142,"text":297,"children":8691},[8692,8693],{"id":519,"depth":156,"text":520},{"id":573,"depth":156,"text":573},{"id":705,"depth":142,"text":422,"children":8695},[8696,8697,8698],{"id":1244,"depth":156,"text":1240},{"id":1479,"depth":156,"text":1480},{"id":1728,"depth":156,"text":1164},{"id":2066,"depth":142,"text":2069,"children":8700},[8701,8702,8703,8705],{"id":2082,"depth":156,"text":2083},{"id":2302,"depth":156,"text":2303},{"id":3678,"depth":156,"text":8704},"Pixel selection (feature: stac or raster)",{"id":3807,"depth":156,"text":8706},"ColorMap (feature: raster)",{"id":4119,"depth":142,"text":4122},{"id":4248,"depth":142,"text":4251},{"id":4379,"depth":142,"text":8710},"[sftp] (feature: sftp)",{"id":4486,"depth":142,"text":4489},{"id":4611,"depth":142,"text":4614},{"id":4784,"depth":142,"text":4787},{"id":4959,"depth":142,"text":4962,"children":8715},[8716],{"id":5167,"depth":156,"text":5168},{"id":5713,"depth":142,"text":5716},{"id":6090,"depth":142,"text":8719,"children":8720},"[raster] (feature: raster)",[8721],{"id":6189,"depth":156,"text":6190},{"id":6221,"depth":142,"text":6224,"children":8723},[8724],{"id":6591,"depth":156,"text":6592},{"id":6654,"depth":142,"text":8726,"children":8727},"[postgres] (feature: postgres)",[8728,8730,8731,8732],{"id":6951,"depth":156,"text":8729},"[postgres] root",{"id":7095,"depth":156,"text":7098},{"id":7149,"depth":156,"text":7152},{"id":7266,"depth":156,"text":7269},{"id":7475,"depth":142,"text":8734,"children":8735},"[mcp] (feature: mcp)",[8736,8738],{"id":7633,"depth":156,"text":8737},"[mcp] root",{"id":7720,"depth":156,"text":7723},{"id":7850,"depth":142,"text":7851},{"id":7908,"depth":142,"text":2299},{"id":8040,"depth":142,"text":4394},{"id":8172,"depth":142,"text":8173},{"id":8444,"depth":142,"text":6218,"children":8744},[8745,8746],{"id":8447,"depth":156,"text":8448},{"id":8590,"depth":156,"text":8591},"Every CLI flag, TOML \u002F YAML option, and environment variable tileserver-rs reads","md",{},"\u002Fgetting-started\u002Fconfig",{"title":5,"description":8747},"1.getting-started\u002F3.config","b_5pAglAsK79dQBY9TPgQ0ESiYg-vDLgz0Kr7W8wxu4",1794845340158]