# Install Typesense

You can either self-host Typesense, run it on your local machine or use our managed Typesense Cloud service.

# Typesense Cloud

The easiest way to run Typesense is using our managed Cloud service called Typesense Cloud (opens new window).

Sign-in with Github, pick a configuration and you'll have a production-grade cluster in a few minutes.

# Local Machine / Self-Hosting

You can also run Typesense on your local machine or self-host it.

You'll find DEB, RPM and pre-built binaries for Linux (X86_64) and macOS on our downloads (opens new window) page.

We also publish official Docker images for Typesense on Docker hub (opens new window).

# 📥 Download & Install

# Mac Binary

# Linux Binary

# Docker

# DEB package on Ubuntu/Debian

# RPM package on CentOS/RHEL

# 🎬 Start

# From the pre-built binary

If you downloaded the pre-built binary for Mac / Linux, you can start Typesense with minimal options like this:

# From the Docker image

If you want to use Docker, you can run Typesense like this:

# From DEB / RPM package

If you had installed Typesense from a DEB/RPM package, the Typesense server is automatically started as a systemd service when installation is complete. You can check the status via:

By default, Typesense will start on port 8108, and the installation will generate a random API key, which you can view/change from the configuration file at /etc/typesense/typesense-server.ini


We are starting a single node here, but Typesense can also run in a clustered mode. See the High Availability section for more details.

# 🆗 Health Check

You can use the /health API end-point to verify that the server is ready to accept requests.

Last Updated: 6/15/2021, 4:16:29 AM