Environnement et configuration

La configuration se trouve dans un fichier .env, copié depuis .env.example. Les valeurs sont validées au démarrage de l'application, donc une valeur manquante ou malformée échoue rapidement.

Cœur

• APP_URL : l'URL publique de votre instance.
• NODE_ENV : development ou production.

Base de données

• DATABASE_URL : la chaîne de connexion Postgres. Postgres doit avoir l'extension pgvector.

Authentification

• BETTER_AUTH_SECRET : un secret fort et aléatoire. Modifiez-le pour la production.
• BETTER_AUTH_URL : l'URL de base d'authentification, généralement identique à APP_URL.
• GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET : connexion sociale facultative. Laissez vide pour une connexion par email et mot de passe uniquement.

Stockage

• STORAGE_DRIVER : minio pour le défaut auto-hébergé, ou s3 pour un bucket cloud.
• S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_ACCESS_KEY, S3_SECRET_KEY, S3_FORCE_PATH_STYLE : la connexion au stockage.

Facturation

• BILLING_ENABLED : false en auto-hébergé, ce qui rend tous les quotas illimités et ignore le traitement des paiements. Les valeurs STRIPE_* ne sont nécessaires que si vous activez la facturation.

Email

• EMAIL_PROVIDER : console enregistre les emails pour le développement, smtp les envoie via votre serveur de messagerie, resend utilise un service hébergé.
• EMAIL_FROM, et SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS pour SMTP.

IA et médias libres

• AI_VECTOR : pgvector, donc la recherche IA utilise votre base de données Postgres.
• STOCK_UNSPLASH_KEY, STOCK_PEXELS_KEY, STOCK_PIXABAY_KEY : clés de recherche de médias libres facultatives.

Multilocataire

• MULTI_TENANT : false pour un auto-hébergement à organisation unique.

Conservez les secrets uniquement dans .env

Ne commettez jamais de secrets réels. Gardez-les dans .env, qui est ignoré par le contrôle de version, et faites tourner tout ce qui fuit.