dd6ca2958d
- Implement tests for `isOrgAdminProvider` to validate admin roles based on organization membership and role. - Create tests for `saved_views_provider` to ensure correct API interactions for saving, renaming, and deleting saved views. - Enhance ticket tree tests to accurately reflect inactive and merged ticket handling. - Update CSV import tests to verify error handling and file saving functionality. - Introduce tests for deal cards to ensure correct display of next steps and task statuses. |
||
|---|---|---|
| .github/workflows | ||
| backend | ||
| docker | ||
| docs | ||
| frontend | ||
| mobile | ||
| .coveragerc | ||
| .dockerignore | ||
| .env.docker | ||
| .gitignore | ||
| .jshintrc | ||
| .readthedocs.yaml | ||
| .runcode.yaml | ||
| CONTRIBUTING.md | ||
| DESIGN_SYSTEM.md | ||
| docker-compose.yml | ||
| Dockerfile | ||
| LICENSE | ||
| MANIFEST.in | ||
| mkdocs.yml | ||
| README.md | ||
| RLS_SETUP.md | ||
| schema.yml | ||
BottleCRM: Open Source Django CRM for Startups & Enterprises
A free, self-hosted, multi-tenant CRM built with Django REST Framework, SvelteKit and Flutter.
BottleCRM is an open source CRM you run on your own infrastructure. It covers the full customer lifecycle: leads, accounts, contacts, opportunities, support tickets, tasks and invoices: through a SvelteKit web app, a native Flutter mobile app, and a documented REST API sharing one Django backend. PostgreSQL Row-Level Security isolates each organization's data at the database layer, so a single deployment serves one startup or hundreds of tenants.
No per-seat pricing, no user caps, no feature paywall. MIT licensed: fork it, self-host it, own your data.
Try it free → · Features · Product docs · Pricing · Migrate from Salesforce or HubSpot
(That's the marketing site's product documentation. For the technical documentation (self-hosting, architecture, the API, contributing) see Documentation below.)
Why BottleCRM
- Free forever, MIT licensed: unlimited users and records, no subscription. A genuinely self-hosted CRM alternative to Salesforce, HubSpot and Pipedrive.
- Multi-tenant by design: PostgreSQL Row-Level Security enforces tenant isolation in the database, not just in application code. Run it for a single company or as a SaaS for many.
- Agent-ready REST API: point Claude, Cursor, Codex, Gemini or any agent at the API with a personal access token and let it search, create and update records as you, inheriting your role, org and permissions. An OpenAPI schema ships with it, so the agent can discover the endpoints itself.
- Web, native mobile and API: one Django REST backend behind a Svelte 5 web app and a Flutter app for iOS and Android.
- A stack you can actually hack on: Django 6 / DRF and Svelte 5, not a bespoke in-house framework. If your team writes Python, it can extend this on day one.
- Real support tooling: a full helpdesk with SLA timers, approvals, escalations, macros and a knowledge base, not a bolted-on ticket list.
How it compares
| BottleCRM | SaaS CRM (Salesforce, HubSpot) | Typical open source CRM | |
|---|---|---|---|
| Cost | Free, unlimited users | Per seat, per month | Free core, often paid tiers |
| Hosting | Self-hosted (managed hosting available) | Vendor cloud only | Self-hosted |
| Data ownership | Total. It is your database | Vendor-controlled | Total |
| Multi-tenancy | Database-level RLS | Not applicable | Uncommon |
| Native mobile app | Yes, Flutter, iOS + Android | Yes | Uncommon |
| AI agent access | Full REST API, per-user tokens | Proprietary add-ons | Uncommon |
| Stack | Django REST + SvelteKit | Closed source | Varies |
| License | MIT | Proprietary | Varies, often GPL/AGPL |
Quick start
git clone https://github.com/django-crm/Django-CRM.git
cd Django-CRM
docker compose up --build
Frontend at http://localhost:5181, API and Swagger UI at http://localhost:8000/swagger-ui/. See the Docker quick start guide for the default admin login, loading demo data, and what each service does.
Documentation
The full documentation (setup, self-hosting, architecture, the REST API, and contributing) is
built from this repository's docs/ with MkDocs Material and publishes to Read the Docs
at https://django-crm.readthedocs.io/en/latest/. Four starting points:
- Getting started: Docker and manual setup, first sign-in, demo data.
- Self-hosting: requirements, production deployment, PostgreSQL and Row-Level Security, backups, security hardening.
- API reference: authentication, conventions, and every documented endpoint.
- Contributing: local development setup, testing, code style, and how to open a pull request.
Contributing
We welcome contributions! See CONTRIBUTING.md for setup instructions, development checks, and pull request guidance.
Community
- Issues: GitHub Issues
- Twitter: @micropyramid
- Commercial Support: Contact us
License
This project is licensed under the MIT License - see the LICENSE file for details.
Sponsors
We are grateful to the sponsors who support BottleCRM's continued development and maintenance.
We warmly welcome new sponsors. If you would like to support BottleCRM and help the project grow, please get in touch.
Contributors
This project exists thanks to all the people who contributed.