# Krayin CRM

MIT Laravel CRM for leads, contacts, quotes and email, configured through .env and packages.

A modular Laravel and Vue CRM with leads, contacts, products, quotes, activities, email parsing and web forms. Configuration is the standard Laravel .env plus config/*.php; features ship as Webkul packages. The core has no API for agents: routes/api.php is the framework stub and the separate rest-api package is stale.

Alternative to: HubSpot, Zoho CRM

- Capabilities: adaptable
- Vertical: smb-ops-crm
- Shape: business-app
- Form factor: web-app
- Execution model: deterministic
- Provenance: human-written (recorded, never ranked)
- Repo: https://github.com/krayin/laravel-crm (MIT), 23828 stars, last commit 2026-09-01
- Last activity: 2026-09-01
- Page: apps/krayin--laravel-crm.html
- JSON: apps/krayin--laravel-crm.json

## Use it when

- I need a free CRM on our own server with leads, quotes and inbound email, and the team knows PHP
- I want a permissive license so we can bundle a customized CRM for clients

## Gotchas

- No built-in API: routes/api.php is the Laravel stub (one auth:api /user route); the official krayin/rest-api package was last pushed 2025-09-01
- Default branch is 2.2; README installs from the main tag
- Needs 3 GB RAM and MySQL 8.0.32+; PostgreSQL not supported

## Editions

- Community: Free, open source
  - source: https://github.com/krayin/laravel-crm
  - installable: composer create-project krayin/laravel-crm
  - container: https://devdocs.krayincrm.com/2.0/introduction/docker.html
- Cloud Hosting: Free, closed source
  - hosted: https://krayincrm.com/crm-cloud-hosting

## Adaptable: make it yours

Effort: config-only (28 things to edit)

Copy .env, set APP_URL, database and mail values, run php artisan krayin-crm:install. IMAP_* variables turn on inbound email parsing; GOOGLE_CLIENT_* enables Google contact sync. Deeper changes are Laravel packages under packages/Webkul (Lead, Contact, Quote, Automation, WebForm) and config/*.php; paid extensions (WhatsApp, VoIP, multi-tenant) are sold separately.

- Env vars: APP_URL, APP_NAME, APP_LOCALE, APP_TIMEZONE, APP_CURRENCY, DB_CONNECTION, DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD, MAIL_MAILER, MAIL_HOST, MAIL_FROM_ADDRESS, MAIL_RECEIVER_DRIVER, IMAP_HOST, IMAP_USERNAME, IMAP_PASSWORD, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REDIRECT_URI, QUEUE_CONNECTION, REDIS_HOST
- Config files: .env.example, config/app.php, config/mail.php, config/mail-receiver.php, config/imap.php, config/concord.php
- Prompt files: none
- Accounts you'll need: SMTP provider; Google Cloud OAuth client (optional, contacts); SendGrid (optional, email parsing)

## Code stack

- Languages: PHP, JavaScript
- Frameworks: Laravel, Vue.js, Vite
- Package manager: composer
- Database: MySQL
- Hosting target: Apache/NGINX, Docker

## Skills

contributor: Repo carries contributor-facing development skills for CRM package development and Pest testing. [contributor tooling, not adopter-facing]
- Paths: .github/skills/*/SKILL.md

## Evidence and confidence

- formFactor: README: Laravel plus Vue admin panel (confidence 0.95)
- executionModel: No model SDK in .env.example or README (confidence 0.85)
- operability: routes/api.php (branch 2.2) contains only the default auth:api /user route; gh repos/krayin/rest-api pushed 2025-09-01 (confidence 0.8)
- effort: README Installation: edit .env APP_URL, mail and database; config/ directory with 24 files (confidence 0.9)
- editions: README License: MIT; Krayin Cloud Hosting page (confidence 0.8)
- active: GitHub pushedAt 2026-09-01
- reach:  (confidence 0)

## Open questions

- Will krayin/rest-api be revived for 2.x? If so this becomes Operable (official, api)
- Cloud hosting price

## Sources

- https://github.com/krayin/laravel-crm (sourcing:smb-ops-crm:github)
- https://github.com/krayin/rest-api (sourcing:smb-ops-crm:github)
