TellurionField guide

Documentation / public evidence

Read the terrain
before you deploy.

Tellurion is a geospatial serving engine for features, tiles, rasters, multidimensional arrays, STAC and 3D. This guide separates the current public evidence from optional capabilities, previews and future work.

Truthful statusCanonical instructionsBounded claims

Documentation snapshot: 2026-08-31 · Product evidence: public Tellurion v0.4.0 release-candidate source, its quickstart and installation manual, plus bounded demo artifacts.

Station 01

Capability status

These labels describe the current source tree, not a promise that every capability is present in every build or deployment.

Available Optional Preview Planned
Available

Core serving surface

Landing pages, conformance declarations, API descriptions, Features, Tiles, read-only Styles and catalog routes are represented in the public demonstrations.

Public demos: inspect the routes →
Available

PostGIS

PostGIS is enabled in the documented default build and provides the shared database route for catalogs, features, tiles, writes, outbox, derived index, search and volumes.

Review the public evidence boundary →
Available

Embedded GeoPackage

The public vector demonstration uses the embedded GeoPackage path for a self-contained, read-only evaluation.

Inspect the GeoPackage demo →
Optional

Valkey cache and browser UI

Valkey adds an opt-in L2 tile cache; the embedded browser UI is a separate opt-in build feature. Neither is required for the default serving engine.

Review what is publicly inspectable →
Preview

Interactive evaluation

The public gallery demonstrates bounded vector, raster, Zarr, 3D, CQL2, STAC, Maps and Styles paths. Demo availability is evidence, not a production SLA or benchmark.

Open the demo gallery →
Planned

Approved v0.4 binaries

Tellurion v0.4.0 source is public. Platform archives are intended, but there is no verified public v0.4 binary release today; build from source using the installation manual.

See the source and download state →
Driver capabilities at the documented evidence revision. “No” means the driver does not expose that capability.
DriverShipping statusSource accessRead / writeTiles or render
PostGISAvailable · defaultDatabase service, local or networkFeatures read/writeMVT and styled PNG
GeoPackageAvailable · defaultLocal fileFeatures read/writeMVT and styled PNG
PMTilesOptionalLocal archiveRead-only tilesStored MVT plus server-rendered PNG with applicable styles; no Features lane
FlatGeobufOptionalLocal fileFeatures read-onlyNo
GeoParquetPreview · public sourceLocal file or HTTPS byte rangesFeatures read-onlyMVT when CRS84 metadata and covering are usable
COGOptionalLocal file or HTTPS byte rangesRaster read-onlyPNG raster tiles
ZarrOptionalLocal or HTTPS chunk storeRaster read-onlyPNG from a configured, bounded 2D x/y slice; leading indexes are fixed, not selected per request
IcebergOptionalREST catalog; local or S3-protocol table dataFeatures read-onlyNo
DuckDBOptionalLocal database fileFeatures read-onlyNo
ShapefilePreview · public sourceLocal or HTTPS ZIP, bounded secure spoolFeatures read-onlyServer wiring and a public demo remain incomplete.

Station 02

Choose your first route

Begin with the smallest shape that answers your evaluation question.

  1. A

    Look first

    Use the public demo gallery when you want to inspect outputs before installing anything. Services may cold-start and are not load-test environments.

    Explore visual demos →
  2. B

    Run v0.4.0 source

    Use the public release-candidate source and its self-contained GeoPackage quickstart for a self-hosted evaluation.

    Open the quickstart →
  3. C

    Read the installation manual

    Build v0.4.0 source with the documented platform prerequisites and commands. The checksummed 0.3.0 binaries remain historical evidence.

    Open the installation manual →

Station 03

Download state

Tellurion v0.4.0 source is public.

v0.4.0 is a release candidate for self-hosted evaluation. Start with the source and quickstart, then use the installation manual to build it. No verified public v0.4 binary is available yet; the checksummed 0.3.0 archives remain historical.

Before production

Read the licence that applies to the version and intended use. The licence text controls.

Read the public licence notice →

Historical binaries

The checksummed 0.3.0 archives are retained as historical release evidence, not as the primary v0.4 evaluation path.

Review historical release assets →

Station 04

Use the public source and evidence set

The v0.4.0 release-candidate source, quickstart and installation manual are public. Tellurion is self-hosted: no Tellurion Cloud, SLA or support service is offered.

Station 05

What is not supported

Refusing unsupported behavior is safer than returning an answer that looks plausible.

  • No universal read/write promise. Driver capabilities differ; several optional formats are explicitly read-only.
  • No automatic production readiness. A successful demo or local run does not replace security, capacity and operational review.
  • No benchmark claim from hosted demos. Shared infrastructure and cold starts make those timings unsuitable for comparison.
  • No DGGS or geometry/3D statistics API today. Current use cases deliberately exclude them.
  • No implied conformance. Consult each deployment’s /conformance response and the documented deviations.

Field index

Search documentation