Ambiente e configurazione

La configurazione risiede in un file .env, copiato da .env.example. I valori vengono convalidati all'avvio dell'app, quindi un valore mancante o malformato causa un fallimento rapido.

Core

• APP_URL: l'URL pubblico della tua istanza.
• NODE_ENV: development o production.

Database

• DATABASE_URL: la stringa di connessione Postgres. Postgres deve avere l'estensione pgvector.

Autenticazione

• BETTER_AUTH_SECRET: un segreto casuale robusto. Cambialo per la produzione.
• BETTER_AUTH_URL: l'URL base dell'autenticazione, solitamente uguale a APP_URL.
• GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET: accesso sociale opzionale. Lascia vuoto per solo email e password.

Archiviazione

• STORAGE_DRIVER: minio per il default self-host, oppure s3 per un bucket cloud.
• S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_ACCESS_KEY, S3_SECRET_KEY, S3_FORCE_PATH_STYLE: la connessione di archiviazione.

Fatturazione

• BILLING_ENABLED: false su self-host, che rende tutte le quote illimitate e salta l'elaborazione dei pagamenti. I valori STRIPE_* servono solo se attivi la fatturazione.

Email

• EMAIL_PROVIDER: console registra le email per lo sviluppo, smtp invia tramite il tuo server di posta, resend utilizza un servizio ospitato.
• EMAIL_FROM, e SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS per SMTP.

AI e stock

• AI_VECTOR: pgvector, così la ricerca AI usa il tuo database Postgres.
• STOCK_UNSPLASH_KEY, STOCK_PEXELS_KEY, STOCK_PIXABAY_KEY: chiavi opzionali per la ricerca di contenuti stock.

Tenancy

• MULTI_TENANT: false per un self-host a singola organizzazione.

Mantieni i segreti solo in .env

Non commettere mai segreti reali. Conservali in .env, che è ignorato dal controllo versione, e ruota tutto ciò che viene compromesso.