Self-hosting

Sésame Éclair is a Next.js application that needs Postgres and, for files, S3-compatible storage. An official Docker image and Helm chart are provided to enterprise customers.

Environment variables

DATABASE_URL=postgres://…          # empty = embedded database (development only)
PUBLIC_BASE_URL=https://secrets.example.fr
CRON_SECRET=…                      # calls GET /api/v1/cron/purge
RATE_LIMIT_SECRET=…                # derives the daily rate-limit keys
S3_ENDPOINT=https://…  S3_REGION=…  S3_BUCKET=…
S3_ACCESS_KEY_ID=…     S3_SECRET_ACCESS_KEY=…
ADMIN_TOKEN=…                      # abuse report handling (32 characters minimum)
WEBHOOK_SIGNING_SECRET=…           # derives each webhook's signing key
VERCEL_TOKEN=…  VERCEL_PROJECT_ID=… # automatic domain attachment (optional)
DOWNLOADS_ORIGIN=https://…          # public storage for the Download page files (optional)
PROBE_TOKEN=…                      # external probe for the Service status page (32 characters minimum)
MAX_FILE_BYTES=104857600  FILE_MAX_TTL_SECONDS=604800  PIN_MAX_ATTEMPTS=5

Key points

  • Migrations are applied automatically on start.
  • Schedule the purge: GET /api/v1/cron/purge with Authorization: Bearer $CRON_SECRET (hourly recommended).
  • The bucket must allow PUT and GET from your domain (CORS).
  • Always serve the app over HTTPS: browser-side encryption depends on it.