Installation

Vous pouvez installer Sovrium sur votre propre machine ou le déployer chez un hébergeur cloud en un clic. Choisissez la voie qui correspond à l'endroit où votre application s'exécutera.

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 nécessite Bun 1.3+.

Installation locale

Sovrium est distribué sous forme de binaire autonome : il n'y a donc aucun environnement d'exécution à installer séparément. Choisissez la méthode qui correspond à votre système d'exploitation.

# Script d'installation (macOS, Linux)
curl -fsSL https://sovrium.com/install | sh

# Homebrew (macOS, Linux)
brew install sovrium/tap/sovrium

# Scoop (Windows)
scoop bucket add sovrium https://github.com/sovrium/scoop-bucket
scoop install sovrium

# Docker
docker pull ghcr.io/sovrium/sovrium:latest

Après l'installation, la commande sovrium est disponible depuis n'importe où.

Installation cloud

Exécutez Sovrium sur un hébergeur géré sans provisionner vous-même de serveur.

Déploiement en un clic

Chaque bouton ci-dessous provisionne un serveur durable à partir de l'image Sovrium et vous guide tout au long de la configuration.

Chaque hébergeur vous demande quelques variables d'environnement : AUTH_SECRET (requise), BASE_URL (requise), DATABASE_URL (optionnelle — par défaut, SQLite embarqué) et SMTP_* (optionnelles, pour l'envoi d'e-mails). Render, Railway et Heroku exécutent l'image pré-construite ghcr.io/sovrium/sovrium ; Scalingo déploie avec le buildpack Sovrium, qui télécharge le binaire publié et vérifié par somme de contrôle.

Platform.sh, Fly.io et Coolify exécutent également Sovrium à partir de la même image.

Vercel n'est pas pris en charge, car cette plateforme est serverless : elle n'offre ni serveur ni conteneur durable, et Sovrium a besoin d'un processus de longue durée pour servir votre application et stocker ses données.

Docker sur votre propre serveur

Pour exécuter Sovrium sur un VPS ou tout hôte que vous contrôlez, démarrez le conteneur directement et placez-le derrière un proxy inverse :

docker run -p 3000:3000 \
  -e AUTH_SECRET="votre-secret" \
  -e BASE_URL="https://app.example.com" \
  -v ./data:/app/data \
  ghcr.io/sovrium/sovrium:latest start app.yaml

L'option -v monte un volume de données afin que votre base SQLite et vos fichiers téléversés survivent aux redémarrages.

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

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"

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