Typesense

À propos de Typesense

Ce qui est installé

Prêt au démarrage du VPS

OS compatibles

Ubuntu 24.04

Application

Typesense

Stack technique

DockerC++

RAM minimum

1 Go (4 Go pour les grands corpus ou la recherche vectorielle)

CPU minimum

1 vCPU

Port par défaut

8108

Accès

root par SSH

Fonctionnalités clés

• Tolérance aux fautes de frappe — une requête 'Mohamad' trouve 'Mohamed' sans dictionnaire ni configuration
• Facettes et filtres en temps réel — filtrez par catégorie, prix ou toute propriété avec des comptages live
• Recherche vectorielle / sémantique intégrée — stockez des embeddings et lancez des requêtes hybrides mot-clé + ANN
• Moteur C++ avec index en mémoire et persistance RAFT — sans JVM, sans pauses de ramasse-miettes
• Clés d'API à portée — générez des clés search-only ou par collection pour sécuriser le front-end
• GPLv3, 26 k+ ⭐ GitHub, maintenu activement — versions hebdomadaires, SDKs pour 9 langages

Quand utiliser cette solution ?

Guide

Déployer Typesense sur votre VPS

1. 1

   Commander le VPS ServOrbit

   Typesense reste sous 150 Mo de RAM pour les corpus courants ; un VPS 1 Go suffit pour démarrer. Le provisionnement installe Docker sur l'image Ubuntu et prépare la stack.

2. 2

   Déployer depuis le Marketplace

   Depuis votre espace client ServOrbit, allez dans Marketplace → Développement → Typesense → Installer. Un seul conteneur typesense/typesense:29.0 démarre avec un volume nommé pour /data et une clé d'API admin générée aléatoirement, affichée dans votre espace client.

3. 3

   Premier accès

   Typesense n'a pas d'écran de connexion : c'est un moteur de recherche piloté par API, protégé par une clé. Utilisez la clé fournie dans l'espace client avec l'en-tête X-TYPESENSE-API-KEY, par exemple : curl -H 'X-TYPESENSE-API-KEY: <votre-clé>' http://127.0.0.1:8108/health

4. 4

   Rendre l'API accessible depuis vos applications

   L'API REST écoute sur le port 8108, publié sur la boucle locale du VPS. Exposez-la derrière un vhost Nginx ou Caddy sur votre domaine en HTTPS pour vos applications distantes, ou ouvrez un tunnel SSH : ssh -L 8108:127.0.0.1:8108 root@<ip-du-vps> puis http://localhost:8108.

5. 5

   Indexer vos premières données et les interroger

   Créez une collection et ajoutez des documents : curl -X POST 'http://127.0.0.1:8108/collections' -H 'X-TYPESENSE-API-KEY: <clé>' -H 'Content-Type: application/json' -d '{"name":"produits","fields":[{"name":"nom","type":"string"},{"name":"prix","type":"float"}]}'. Puis lancez une recherche : curl 'http://127.0.0.1:8108/collections/produits/documents/search?q=vps&query_by=nom' -H 'X-TYPESENSE-API-KEY: <clé>'.