Repository navigation
Home

On this page: Where to start · Getting started · AI in Granary · Using Granary · Administration · Developers · A few things worth knowing
Granary is an open-source, self-hosted, AI-native ERP for small and mid-sized companies. Its AI, Nary, is part of the business processes, from the first customer message to the project kickoff, not a chatbot on the side (its chat is one keystroke away on every page). It sorts new customer conversations and turns prospects into leads, scores and researches them, drafts replies, quotations, proposals, contracts and invoices, follows up after a quotation, starts the project when a deal is won, and answers from your own SOPs and documents. Nary works with each person's own permissions, and its drafts and proposed changes arrive as cards that a person applies, edits or rejects. You choose the AI provider (Anthropic, OpenAI or any OpenAI-compatible service, DeepSeek, Gemini, or local models through Ollama), and you can also connect your own AI client over MCP. See AI Across Granary for the full map.
One web application covers CRM and sales, finance and accounting, HR and payroll, projects, manufacturing and inventory, procurement, partners, marketing, internal messaging and video calls. The backend is written in Rust, the frontend in Next.js, and everything runs with Docker Compose on one server. Granary is dual-licensed under MIT OR Apache-2.0.

Try it first: the live demo runs in your browser with sample data. You can click through every module and apply Nary's cards. Nothing is saved, and its AI chat gives a scripted answer.
| You are | Start here |
|---|---|
| Installing Granary on a server | Installation, then First Steps |
| The person who set it up (the Owner) | First Steps, then Administration and Configuration |
| A staff member | Find your module in the list below |
| Curious what the AI does in each module | AI Across Granary |
| Connecting an outside AI client | MCP for AI Clients |
| A developer | Developer Guide |
| Stuck | Troubleshooting and the FAQ |
| Page | What it covers |
|---|---|
| Installation | Requirements, Docker Compose, .env, first start, reverse proxy, TURN |
| First Steps | What to set right after installing |
| FAQ | Short practical answers |
| Page | What it covers |
|---|---|
| AI Across Granary | What the AI does in each module, what starts it and who approves it |
| Nary AI Assistant | The assistant, confirm cards, autonomy, AI knowledge, provider keys |
| MCP for AI Clients | Connecting an outside AI client: browser login, tokens, levels |
| Page | What it covers |
|---|---|
| CRM | Leads, contacts, organizations, deals and the pipeline, activities, follow-ups, duplicates |
| CRM Inboxes | Shared email inboxes, scheduled sends, the WhatsApp inbox |
| Sales | Quotations, proposals, contracts, the product catalog |
| Marketing | Campaigns, content calendar, email campaigns |
| Partners | Partner accounts, deal registration, commissions, the partner portal |
| Page | What it covers |
|---|---|
| Approvals and Signing | Approval policies, verification QR codes, e-signature, sending documents |
| Page | What it covers |
|---|---|
| Finance | Invoices, payments, expenses, ledger, bank, taxes, reports, assets, budgets |
| Multi-Currency | Functional currency, exchange rates, FX gain and loss |
| Page | What it covers |
|---|---|
| Procurement | Vendors, RFQs, purchase orders, receipts, vendor invoices, the vendor portal |
| Manufacturing and Inventory | Products, bills of materials, production, QC, warehouses, warranty |
| Operations | Fleet, maintenance, helpdesk |
| Page | What it covers |
|---|---|
| HR and Payroll | Employees, attendance, leave, payroll, hiring, offer letters |
| Face Clock-In | Face matching, liveness, geofence, kiosk tablets |
| Page | What it covers |
|---|---|
| Projects | Projects, tasks, time logs |
| R&D | Product lines, R&D projects, backlog, GitLab issue sync |
| Knowledge and Documents | Articles, SOPs, the document library |
| Collaboration | Channels and direct messages, personal email, video calls |
| Page | What it covers |
|---|---|
| Configuration | How settings work, environment variables, the settings areas |
| Administration | Users, roles, portal users, two-factor sign-in, sessions, security |
| Backups and Upgrades | Backups, restores, updating Granary, routine checks |
| Troubleshooting | Common problems and their fixes |
| Page | What it covers |
|---|---|
| Developer Guide | Architecture, repository layout, building, tests, CI, contributing |
- Business numbers are settings. Tax rates, payroll contributions, approval limits, reminder schedules and currency decimals are edited in Settings, not in code. When one is missing, the action fails with a message that names the setting. See Configuration.
- The AI asks before it acts. Nary's drafts and proposed changes wait as cards until a person confirms them. The few things that run without a card (lead intake, enrichment of new organizations, buttons you click) are listed in AI Across Granary. See also Nary AI Assistant.
- WhatsApp needs a bridge you provide. Granary does not ship a WhatsApp Web bridge. Without one, the WhatsApp features show as disconnected and everything else works.
- Security problems are reported privately through the repository's Security tab, never in a public issue. See Administration.
Next: Installation →
Getting started
AI in Granary
Using Granary
- Sell
- Approve and sign
- Money
- Buy and make
- People
- Work together
Administration
Developers