Experience Operating System (XOS) that unifies marketing, sales, operations, and support — run your core business seamlessly while replacing HubSpot, Zendesk, Linear, Wix and more.

Website | Invest | Docs | Roadmap | Changelog | Discord

🚀 Nx Monorepo • 🔌 Plugin Architecture • ⚡ GraphQL Federation • 🎨 Module Federation • 🔒 Self-Hosted

Achieving growth and unity within your company is possible with erxes, because it is:

• 100% free & sustainable: erxes offers a sustainable business model in which both developers and users win. It is the source available software, but even better.
• 100% customizable: Our plugin-based architecture provides unlimited customization and lets you meet all your needs, no matter how specific they are.
• 100% privacy: We've designed the erxes platform to retain complete control over your company's sensitive data with no third-party monitoring.
• 100% in control: You can build any experience you want, where all the channels your business operates on are connected and integrated.

What does erxes mean? How do you pronounce it?

erxes (pronounced 'erk-sis') is a Mongolian word meaning “galaxy”. A galaxy is a system of stars, stellar remnants, interstellar gas, dust, and dark matter bound together by gravity. The word is derived from the Greek galaxias (γαλαξίας), literally 'milky', a reference to the Milky Way galaxy that contains the Solar System. It is branded as “erxes” with all lowercase letters.

erxes - Improving everyday experiences can significantly enhance the quality of life. These small, incremental improvements can lead to substantial benefits and better living. Better living and happier people will have a contagious effect on everything they touch, eventually improving the universe.

What is erxes?

erxes Core & Plugins

Core: It contains the core five modules which goes with all plugins - My inbox, Contacts, Products, Segments, Automation, Documents

Plugins: erxes comes with a set of plugins that allow you to create unique business experiences. Below is a list of some plugins you can choose from our marketplace after you’ve finished installing erxes XOS:

• erxes | Frontline - Frontline powers your customer-facing teams in one place. Omnichannel conversations, tickets, tasks - all seamless.
• erxes | Operation – Keep projects on track with tasks, team resources, and cycle management in one workspace.
• erxes | Sales – Turn regular visitors into qualified leads by capturing them with a customizable landing page, forms, pop-up, or embed placements.
• erxes | Content - Publish anywhere with headless website, corporate sites, e-commerce, scheduling, knowledge base, and help center tools. !EE License Only
• erxes | Accounting – Simplify finances with accounting and salary management built into your workflow. !EE License Only
• erxes | Tourism – Run tours and properties seamlessly with booking and management systems in one place. !EE License Only
• erxes | Property – Oversee real estate with stacking plans, financing & leasing, asset management, community, and investment platforms. !EE License Only
• erxes | Team – Empower people with directories, time clocks, chat, updates, training, and rewards. !EE License Only
• erxes | Finance – Power your bank and non-banking organization with e-banking, mobile apps, core banking, and scoring systems and many more. !EE License Only

Architecture Overview

erxes is built as an Nx-powered monorepo with a modern microservices architecture:

• Backend: GraphQL Federation + tRPC microservices (Node.js, TypeScript, MongoDB, Redis, BullMQ)
• Frontend: Module Federation micro-frontends (React 18, Rspack, TailwindCSS)
• Apps: Standalone applications (Next.js customer portal, POS client, widgets)

┌─────────────────────────────────────────┐
│    API Gateway (Port 4000)              │
│    Apollo Router + Service Discovery     │
└─────────────────────────────────────────┘
              │
    ┌─────────┼─────────┐
    ▼         ▼         ▼
┌─────────┐ ┌──────┐ ┌──────┐
│Core API │ │Plugin│ │Plugin│
│  (3300) │ │ APIs │ │ APIs │
└─────────┘ └──────┘ └──────┘

Quick Start

Prerequisites

• Node.js 18+
• pnpm ≥ 8 (required)
• MongoDB 27017
• Redis 6379

Installation

# Clone the repository
git clone https://github.com/erxes/erxes.git
cd erxes
Install dependencies (must use pnpm)
pnpm install
Set up environment variables
cp .env.example .env
Edit .env and configure MONGO_URL, REDIS_HOST, etc.
Start core services (Gateway + Core API)
pnpm dev:core-api
Or start all APIs
pnpm dev:apis
Start all UI plugins (in another terminal)
pnpm dev:uis

Access the application at http://localhost:3001

Development with Nx

# Run specific service
pnpm nx serve sales_api
pnpm nx serve sales_ui
Build specific project
pnpm nx build core-api
Run tests
pnpm nx test sales_api
Run only affected projects (smart rebuilds)
pnpm nx affected:build
pnpm nx affected:test

Technology Stack

| Layer | Technologies | |-------|-------------| | Backend | Node.js, TypeScript 5.7, Express, Apollo Server v4, tRPC v11 | | Database | MongoDB, Mongoose, Redis, Elasticsearch | | Frontend | React 18, Rspack, Module Federation, TailwindCSS 4, Jotai | | Build | Nx 20.0, pnpm 9.12, Docker | | Apps | Next.js 14-16, PWA support |

📚 Documentation

• Official Documentation - Complete guides and API references
• Local Setup Guide - Detailed installation requirements
• Contributing Guide - How to contribute to erxes
• Roadmap - What's coming next
• Changelog - Release notes and updates

Creating Custom Plugins

erxes uses a powerful plugin architecture that allows you to extend functionality:

# Generate a new plugin (both backend and frontend)
pnpm create-plugin
Follow the prompts to create your plugin
Plugin name: inventory
Module name: products
Enable your plugin in .env
ENABLED_PLUGINS=operation,sales,frontline,inventory
Start developing
pnpm nx serve inventory_api
pnpm nx serve inventory_ui

Each plugin includes:

• Backend: GraphQL schema, tRPC endpoints, business logic, database models
• Frontend: Module Federation remote, React components, routing
• Auto-generated: Nx configuration, Docker setup, boilerplate code

Become a partner

Offer your expertise to the world and introduce your community to erxes. Let’s start growing together. Join our Discord.

Contributing

Please read our contributing guide before submitting a Pull Request to the project.

• Discord For live discussion with the community
• GitHub Bug reports, contributions
• Feedback section Roadmap, feature requests & bugs

Stay updated instantly on social media

• LinkedIn
• Facebook
• Instagram
• Twitter

License

⚡ Quick Start (5 minutes)

docker compose up -d open http://localhost:3000