Databases and search, checked 2026-09-07

Typesense: Docker configuration reference

Self-hosted typo-tolerant search engine built in C++, aimed at fast setup and predictable relevance tuning.

At a glance

Image: typesense/typesense
Tags: 30.2, 30.1, 30.0, 29.1, 29.0
Licence: GPL-3.0
Source: https://github.com/typesense/typesense
Docs: https://typesense.org/docs/

Ports

Ports
Port	What listens	Source
`8108`	HTTP listener for the API. Set with the api-port config option or the TYPESENSE_LISTEN_PORT environment variable.	source for port 8108

Environment variables

Environment variables
Variable	Required	What it does	Example	Source
`TYPESENSE_API_KEY`	Yes	Admin API key. Required to start the server; there is no default and no way to run without one.	`a random string`	source for TYPESENSE_API_KEY
`TYPESENSE_DATA_DIR`	Yes	Directory where all index data is stored. Required at startup.	`/data`	source for TYPESENSE_DATA_DIR
`TYPESENSE_LISTEN_PORT`	No	Port the API server listens on. Maps to the listen-port config key.	`8108`	source for TYPESENSE_LISTEN_PORT
`TYPESENSE_ENABLE_CORS`	No	Whether cross-origin requests are allowed. Defaults to enabled, narrowed by TYPESENSE_CORS_DOMAINS.	`true`	source for TYPESENSE_ENABLE_CORS

Volumes that must persist

Volumes
Path	What is in it	Source
`/data`	Backs TYPESENSE_DATA_DIR. All collections and their documents live here; losing it loses the whole index.	source for /data

Behind a reverse proxy

Route the domain to container port 8108, or whatever TYPESENSE_LISTEN_PORT is set to. source for this reverse-proxy note
There is no unauthenticated mode: TYPESENSE_API_KEY must be set before the server will start, so the proxy is not the only thing standing between the internet and the data. source for this reverse-proxy note

Release timeline

Releases
Version	Date	Breaking	What changed	Source
`v30.2`	2026-04-19	No	Fixes incorrect handling of numeric not-equals filters and a highlighting bug introduced in v30.1.	source for release v30.2
`v29.1`	2026-04-19	No	Fixes scoped API key handling for embedded collection parameters in multi-search requests. Published the same day as v30.2, on the older 29.x line.	source for release v29.1
`v30.1`	2026-01-29	No	Fixes an overflow in the search latency metric reported by the stats.json endpoint.	source for release v30.1
`v30.0`	2026-01-27	No	Adds result diversification with Maximum Marginal Relevance and API changes for synonyms, curation and analytics rules.	source for release v30.0
`v29.0`	2025-06-30	No	Adds natural language search, letting Typesense convert a plain-language query into a structured search using an LLM.	source for release v29.0

If it is not coming up

Read from the upstream documentation, repository and container registry by Keita Emsden on 2026-09-07. Every row links the page it came from. Upstream changes without telling anyone, so check the source link before you rely on a value.

Other app references

All app references