BottleCRM: CRM for AI and People
A free, open-source, self-hosted, multi-tenant CRM built with Django REST Framework, SvelteKit and Flutter.
!License !Python !Django !SvelteKit !Svelte !Flutter !Coverage
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
- Multi-tenant by design: PostgreSQL Row-Level Security enforces tenant isolation in the
- Agent-ready REST API: point Claude, Cursor, Codex, Gemini or any agent at the API with a
- Web, native mobile and API: one Django REST backend behind a Svelte 5 web app and a
- A stack you can actually hack on: Django 6 / DRF and Svelte 5, not a bespoke in-house
- Real support tooling: a full helpdesk with SLA timers, approvals, escalations, macros and
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 --buildFrontend 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.
One-click deploy
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
- 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
- Commercial support: Contact us
- LinkedIn: BottleCRM on LinkedIn
License
This project is licensed under the MIT License - see the LICENSE file for details.
Sponsors
BottleCRM is developed and maintained by RunCode Inc.
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.