Installation
Installez Sovrium globalement ou comme dépendance de projet à l'aide de Bun.
Prérequis
Les tables et l'authentification fonctionnent d'emblée sur une base de données SQLite embarquée — aucune configuration requise. PostgreSQL 15+ est optionnel et débloque des fonctionnalités avancées (SQL brut, recherche vectorielle). L'exécution depuis les sources ou en tant que bibliothèque nécessite Bun 1.3+.
Binaire autonome (recommandé)
Sovrium est distribué sous forme de binaire autonome — c'est la méthode d'installation recommandée. Aucun environnement d'exécution à installer séparément.
# Script d'installation
curl -fsSL https://sovrium.com/install | sh
# Homebrew
brew install sovrium/tap/sovrium
# Docker
docker pull ghcr.io/sovrium/sovrium:latest
Après l'installation, la commande sovrium est disponible depuis n'importe où.
En tant que bibliothèque
Pour utiliser Sovrium par programmation depuis un projet Bun, ajoutez-le comme dépendance :
bun add sovrium
Vous rédigez votre configuration en TypeScript ? Installez le paquet sans dépendance @sovrium/types pour l'autocomplétion dans l'IDE (bun add -d @sovrium/types) et rédigez votre configuration avec defineConfig. Voir Fichiers de configuration.
Vérifier l'installation
Exécutez la commande d'aide pour vérifier que Sovrium est correctement installé :
sovrium --help
Créer un fichier de configuration
Sovrium lit un fichier de configuration YAML ou JSON. Créez un fichier app.yaml avec la configuration valide la plus simple :
name: my-app
YAML ou JSON. Sovrium prend en charge les fichiers .yaml/.yml et .json. Le YAML est recommandé pour sa lisibilité.
Configuration de la base de données
Sovrium utilise par défaut une base de données SQLite embarquée — les tables et l'authentification fonctionnent sans aucune configuration. Définissez DATABASE_URL uniquement pour choisir l'emplacement du fichier SQLite ou pour passer à PostgreSQL :
# Par défaut : SQLite embarqué — aucun DATABASE_URL nécessaire
# Optionnel — choisir l'emplacement du fichier SQLite :
export DATABASE_URL="file:./data/app.db"
# Optionnel — utiliser PostgreSQL pour les fonctionnalités avancées :
export DATABASE_URL="postgresql://user:password@localhost:5432/myapp"
SQLite par défaut. Laissez DATABASE_URL non défini et Sovrium stocke les données dans un fichier SQLite local. Utilisez une URL file: pour choisir son emplacement, ou une URL postgresql:// pour changer de moteur. Les sites purement statiques (pages et thème uniquement) n'ont besoin d'aucune base de données.
Étapes suivantes
- Démarrage rapide — créez et exécutez votre première application.
- Concepts fondamentaux — l'anatomie d'une application Sovrium.
- Fichiers de configuration — YAML, JSON, TypeScript et
$ref.