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.

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.

erxes is a secure, self-hosted, and scalable source available experience management infrastructure that enables SaaS providers and digital marketing agencies/developers to create unique experiences that work for all types of business.

erxes is composed of 2 main components: Core & Plugins

Core: It contains the core five modules which goes with all plugins - 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.
• erxes | Accounting – Simplify finances with accounting and salary management built into your workflow.
• erxes | Tour – Run tours and properties seamlessly with booking and management systems in one place.
• erxes | Property – Oversee real estate with stacking plans, financing & leasing, asset management, community, and investment platforms.
• erxes | Team – Empower people with directories, time clocks, chat, updates, training, and rewards.
• erxes | Finance – Power your bank and non-banking organization with e-banking, mobile apps, core banking, and scoring systems and many more.

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 │
└─────────┘ └──────┘ └──────┘

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

# 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

# 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

• Official Documentation - Complete guides and API references
• Local Setup Guide - Detailed installation requirements
• CLAUDE.md - Comprehensive codebase guide for AI assistants and developers
• Contributing Guide - How to contribute to erxes
• Roadmap - What's coming next
• Changelog - Release notes and updates

See CLAUDE.md for:

• Detailed architecture and plugin system documentation
• Development workflows and patterns
• Code conventions and best practices
• Testing strategies
• CI/CD pipeline details
• Multi-tenancy and service communication patterns

We recommend always using the latest version of erxes to start your new projects. Enjoy 🎉

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

Learn more in CLAUDE.md - Plugin System

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

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

For general help using erxes, please refer to the erxes documentation. For additional help, you can use one of these channels to ask a question:

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

• LinkedIn
• Facebook
• Instagram
• Twitter

See the LICENSE file for licensing information.