Typesense

Typesense is an open-source, typo-tolerant search engine that delivers fast full-text search with faceting, filtering, synonyms, geosearch and vector search.

  • Databases
  • Other
  • Web & Publishing
Typesense is an open-source, typo-tolerant search engine that delivers fast full-text search with faceting, filtering, synonyms, geosearch and vector search. It is aimed at developers who want a self-hosted, easy-to-operate alternative to Algolia or Elasticsearch. This Unraid template deploys the official Typesense container (v29.0), exposing the HTTP API on port 8108 and persisting data to /data. Set the bootstrap Admin API key (TYPESENSE_API_KEY) on first start and keep the Admin API behind a reverse proxy rather than exposing it publicly.

Platform availability

Available on 4 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

72/100 Good

Maintained
100last commit 22 days ago
Popular
8927,064 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
602 GB minimum RAM, runs on ARM
Security check
201 serious finding, 15 minor, CI, tests, OpenSSF Scorecard 7.2/10

Availability: platform listings confirmed today, links checked 10 days ago

GitHub stars
27,064
Open issues
922
Last commit
2026-10-30
Latest release
v30.2
License
GPL-3.0
Activity
rising

Checked 22 days ago - source: GitHub (typesense/typesense)

Resources & Compatibility

Minimum requirements: 2 GB RAM, 1 CPU core(s), 10 GB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Start Typesense on port 8108 Run the Docker command with -p 8108:8108 so your computer can reach Typesense’s search API on port 8108 (the network address number it listens on). Without that port open, apps cannot connect. source
  • Save your data folder Map a real data folder to /data with -v so the Typesense container keeps your search indexes and settings across restarts. If you skip this, your data can disappear when the container is removed or restarted. source
  • Set a working API key Include --api-key in the Docker command, then use that same key in your app’s Typesense client. The API key is the password-like token that proves a request is allowed; without a matching key, Typesense rejects connections. source
  • Data directory is required TYPESENSE_DATA_DIR=/data must be set (already included in this template); otherwise Typesense exits with 'Invalid configuration: Data directory is not specified'. source
  • Secure the admin API Do not expose the Admin API publicly; place Typesense behind a reverse proxy and use scoped API keys for front-end clients. CORS for browser apps can be enabled via TYPESENSE_ENABLE_CORS. source

Fetched 43 days ago - each note links to its source

Alternatives (5)

  • Algolia - Algolia helps product teams connect their users with information by providing the building blocks they need to create fast, relevant, perso…
  • Elasticsearch - Elasticsearch is a distributed search and analytics engine that indexes and queries full-text, log, metric, and vector data in near real ti…
  • FreeFind - Free site search engine.
  • OpenSearch - OpenSearch is an open-source search and observability suite for self-hosters who need scalable indexing, analysis, and visualization of log…
  • Qdrant - Qdrant is a vector similarity search engine and vector database for storing, searching, and managing vectors with associated payload.

Checked 51 days ago - source: AlternativeTo

Common questions

What port should I expose for the Typesense API?

Expose port 8108 so applications can reach the search API; without that port open, clients cannot connect.

Which container directory must I persist?

Map a real data folder to /data so search indexes and settings survive restarts; if you skip this, your data can disappear when the container is removed or restarted.

How should my app authenticate to a self-hosted Typesense instance?

Start the server with an API key and use that same key in your app’s Typesense client; Typesense rejects requests with a non-matching key.

How do I run Typesense in production?

Run the single self-contained Typesense binary as a daemon using Docker or a process manager, with DEB and RPM packages doing this for you.

Are there reported freezes on self-hosted Typesense instances?

A user reported intermittent one-minute freezes, once or twice daily, on a self-hosted instance with under 10,000 records and a 400MB memory limit.

Answers sourced from github.com, threads.typesense.org, typesense.org

Community

Collected 54 days ago - public community threads