Getting started
SoliCRM is a complete CRM — sales, service, commerce and automation — built on the Soli web framework. You run it on your own server, your data stays in your own SoliDB database, and every screen is code you can read and change.
What you need
- Soli 2.5 or newer (
soli --version) - SoliDB running locally (default
http://localhost:6745) - Optional: SoliKV for caching and an SMTP server for outgoing email
Install and run
git clone <your fork> solicrm && cd solicrm
cp .env.example .env # database, secrets, public URL
soli db:migrate up # create collections and indexes
soli db:seed # demo team, accounts, deals, cases, invoices…
soli serve . --dev # http://localhost:5011
Tailwind CSS is compiled automatically when the server starts.
Your first sign-in
The demo seed creates four users who all share the password demo-password-2026:
| User | Role | Good for trying |
|---|---|---|
| Morgan Lee | Admin | Setup, layouts, flows, company information |
| Priya Shah | Member | Sales: pipeline, quotes, forecasts |
| Diego Alvarez | Member | Territories, leads |
| Hannah Kim | Member | Service: cases, console, live chat |
In development, the sign-in page offers a Quick login list: one click signs you in as any demo user.
Find your way around
- The top bar searches every object and opens your user menu (security, language, setup, log out).
- The navigation lists the main objects; More holds the rest (quotes, orders, invoices, credit notes, contracts, console…).
- Every list page has search, filters, sorting and saved list views; every record page has details, related lists, activity and field history.
Choose your language
SoliCRM speaks English, French and Spanish. Pick yours in the user menu (or on the sign-in page): it is saved on your profile and follows you on every device. Dates, numbers and amounts follow the language too.
Configure for production
| Setting | Where |
|---|---|
| Public URL used in emails and chat links | APP_BASE_URL in .env |
| Public host names behind a proxy | SOLI_APP_HOSTS |
| Company identity, bank details, currency, tax | Setup → Company |
| Two-factor encryption key | TOTP_ENCRYPTION_KEY |
| Web push keys | VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY, VAPID_SUBJECT |
| Sign in with Google / Microsoft | GOOGLE_CLIENT_ID, MICROSOFT_CLIENT_ID (+ secrets) |
| AI assistant | SOLI_LLM_URL, SOLI_LLM_MODEL |