Admin guide
Install, configure, run and maintain your own NextCRM instance.
This guide is for people who host and administer NextCRM: installing it, configuring integrations, managing users, and keeping the instance backed up and up to date.
A NextCRM instance is the Next.js app plus PostgreSQL with pgvector, S3-compatible storage and Inngest. The repository's Docker Compose files run all four. Login is passwordless by email code, so plan to set up Resend early.
Get it running
Requirements
What the instance needs, and which services are optional.
Install with Docker Compose
Quick start, which variables reach the app, first admin login.
Configuration reference
Every environment variable the code reads, grouped by area.
Deployment
Coolify, Portainer, build packs, reverse proxy, file storage.
Run it
Administration panel
AI keys, services, CRM picklists, funnel timing, currencies, invoices.
Users and roles
Invitations, approvals, roles, API tokens.
Plugins
Install, configure, upgrade and uninstall plugins.
Audit log
Change history and restoring deleted records.
Background jobs
What runs in Inngest and how to run Inngest in production.
Integrations
Resend for login codes and system mail, SMTP for notifications, user mailboxes.
Calendar
Google Calendar OAuth app and the Calendly webhook.
Enrichment
OpenAI, Firecrawl, Anthropic and the E2B sandbox template.