How do I set up FaceAiPro on my server?

Install

1. Download the ZIP from your DEV3 account and unzip it. Open Documentation/index.html in a browser for the full guide.

2. Copy the environment template and fill it in:

   cp .env.example .env.local

   Set MONGODB_URI, MONGODB_DB, AUTH_SECRET (for example openssl rand -base64 32), NEXT_PUBLIC_SITE_URL and your AI key. Leave the Stripe, SMTP and Google values empty to start: billing runs in simulated mode and emails are printed to the console.

3. Install everything and seed the demo data (plans, settings, demo logins, preset presenters and the bundled sample reels):

   npm run setup

   This runs npm install, creates the Python environment for the free voices and runs the seed. The seed refuses to write into a non-empty database it did not create.

4. Start the web app and the render worker together:

   npm run dev:all

   Open the address the web process prints and use one of the one-click demo accounts on the sign-in page.

Production

1. Web app: npm run build and npm start behind a TLS reverse proxy.
2. Render worker: npm run start:worker on one or more machines with ffmpeg, the fonts, Python edge-tts and access to the same STORAGE_DIR. WORKER_CONCURRENCY sets jobs per worker. On Linux: apt install ffmpeg python3-venv fonts-dejavu-core, then npm run setup:tts.
3. Stripe: set STRIPE_SECRET_KEY, add the webhook endpoint https://<your domain>/api/stripe/webhook with the events listed in the deployment guide, put its signing secret in STRIPE_WEBHOOK_SECRET, and enable the Customer Portal.
4. Optional caption fonts: drop open .ttf/.otf fonts into engine/fonts/ and they appear in the font pickers.

npm run verify runs the typecheck, lint and tests against throwaway databases.