# Typesense

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 open source and self-hosted, installable on Docker Hub, Proxmox, Unraid and Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/73/typesense

## Description

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, Proxmox, Helm, Any server.

## Health score

72/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 22 days ago)
- Popular: 89 (27,064 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Light to run: 60 (2 GB minimum RAM, runs on ARM)
- Security check: 20 (1 serious finding, 15 minor, CI, tests, OpenSSF Scorecard 7.2/10)

## Security check

1 serious finding: Uses form-data 4.0.1, which has a known critical vulnerability.
Automated checks on commit a2bb526, 13 Oct 2026. Not an audit.

## Links

- Docker Hub: https://hub.docker.com/r/typesense/typesense
- Official website: https://typesense.org
- GitHub: https://github.com/typesense/typesense
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=typesense
- Unraid: https://ca.unraid.net/apps/typesense-1ghov370tei8gv?q=Typesense
- Kubernetes (Helm): https://artifacthub.io/packages/helm/hmphu/typesense

## 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.

## Alternatives

- 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/73/typesense), the self-hosted and open-source app directory.
