Pre-Installation Guide

AutoLead setup before first login

Pick where the application stores authentication, module data, files, screenshots, widgets, extension data, and employee activity before creating the first admin account.

Firebase Managed

Fast SaaS deployment with managed Firestore and Storage.

AUTOLEAD_DATA_BACKEND=firebase
AUTOLEAD_FILE_BACKEND=firebase
FIREBASE_SERVICE_ACCOUNT={...}
FIREBASE_STORAGE_BUCKET=your-project.firebasestorage.app

Built-In SQLite

Single-server installs, demos, and smaller self-hosted buyers.

AUTOLEAD_DATA_BACKEND=sqlite
AUTOLEAD_FILE_BACKEND=local
SQLITE_DATABASE_PATH=/data/autolead.sqlite
LOCAL_STORAGE_DIR=/data/storage
LOCAL_STORAGE_SIGNING_SECRET=change-this-long-secret

Built-In Postgres

Production self-hosting, larger customers, and multi-instance servers.

AUTOLEAD_DATA_BACKEND=postgres
AUTOLEAD_FILE_BACKEND=local
POSTGRES_URL=postgres://user:password@host:5432/database
LOCAL_STORAGE_DIR=.data/storage

Installation Order

1

Choose Firebase, SQLite, or Postgres before first login. If no Firebase config is present, the app auto-starts in SQLite mode.

2

Add ADMIN_SETUP_KEY so the first admin account can be created securely.

3

For Railway SQLite installs, mount a volume at /data before production use.

4

Set NEXT_PUBLIC_APP_URL to the final domain for signed storage URLs, agents, widgets, and extensions.

5

Configure storage: Firebase Storage for managed mode, or LOCAL_STORAGE_DIR for built-in mode.

6

Run the app, open /setup, and create the primary admin account.

7

After login, open Guide and Settings to configure SMTP, IMAP, Stripe, Twilio, AI keys, widgets, and automation.