Gentics Mesh holds your content and hands it out through REST and GraphQL, with permissions, versioning, multi-language support, search and events built in. You bring the frontend: a portal, a mobile app, a static site generator, a digital signage screen or an AI agent. In Gentics CMP it is the hub between Gentics CMS, which publishes into it, and the portals, which render from it. It also runs perfectly well on its own.
| Repository | Component |
|---|---|
| gentics/cms-oss | Gentics CMS – editing, publishing, Workspace, MCP tools |
| gentics/mesh | This repo. Gentics Mesh – headless content repository, search, Content RAG, MCP server |
| gentics/cmp-portals | Portal | php and Portal | java – render content from Mesh |
| gentics/cmp | Umbrella: platform changelog, guides, Helm chart, licensing overview |
The cmp README has the big picture and the cross-repository getting-started guide.
- GraphQL API and a full REST API, including a webroot API that maps URL paths to content for modern routing frameworks
- Users, roles and document-level permissions that apply to every API, every search and every AI tool
- Versioned content, multi-language fields, tagging
- Search powered by Elasticsearch and an image manipulation API
- Content events via websocket, clustering and monitoring
- MCP server (
mcp-server): the Model Context Protocol adapter for Mesh, with stdio transport for Claude Desktop, Cursor and friends and HTTP transport for agent frameworks; same tools on both, same permissions as the REST API - Content RAG (
content-rag): permission-filtered semantic search and source-cited answers over Mesh content, indexed by the standard Mesh sync into Elasticsearch
mesh/
├── api, rest-model, rest-client public API, REST models, Java client
├── core the content repository: schemas, nodes, permissions, versioning
├── services, verticles, server the server (Docker image gentics/mesh)
├── elasticsearch search integration
├── distributed, distributed-coordinator clustering
├── mcp-server MCP server (stdio + HTTP)
├── content-rag RAG index handler, chunking, rag-service
├── connectors database connectors (core)
├── plugin-api, plugin-*, plugins plugin system and the open-source plugins
├── doc, changelog, bom
├── tests, database-tests
└── ee/ Enterprise Modules (BUSL-1.1)
├── connectors/ mssql, oracle, postgres, common-enterprise
├── plugins/ keycloak-plugin, search-plugin, favorite-plugin
└── helm-chart enterprise Helm chart
docker run -p 8080:8080 gentics/mesh:latestThen log in via the API as shown below. The
Getting Started Guide explains the building blocks
(projects, schemas, nodes, branches), the
Administration Guide covers databases, clustering
and production setups. For Kubernetes there is the Helm chart in ee/helm-chart and the
Gentics CMP umbrella chart.
Authenticate first – JSON body, basic auth or a JWT header, your choice:
curl -X POST http://localhost:8080/api/v2/auth/login \
-H 'Content-Type: application/json' \
-d '{"username":"<user>","password":"<password>"}'Then fetch content with GraphQL (the IntrospectionQuery is supported, so any GraphQL-aware REST tool
gives you code assistance):
query webroot($path: String) {
node(path: $path) {
... on vehicle {
fields {
name
description
vehicleImage {
uuid
path
... on vehicleImage {
fields { image { height width dominantColor } }
}
}
}
}
}
}The full REST API reference and the GraphQL documentation are in the Mesh docs.
Requirements: Java 17, Maven 3.9+, Docker (for the tests).
git clone https://github.com/gentics/mesh.git
cd mesh
mvn clean install -DskipTestsThe reactor builds the core, the MCP server, Content RAG and the ee/ modules. The
Contributing Guidelines explain the IDE setup and the
codebase; mcp-server/README.md and content-rag/README.md
have the details of those two modules.
dev– next releasehotfix-<version>– maintenance of released versionsf-<ticket>– feature branches
- Gentics Mesh documentation
- Gentics CMP changelog and guides across all components
- Questions: Stack Overflow or the gitter channel
- Issues: github.com/gentics/mesh/issues
Gentics Mesh is open core:
- Core – Apache License 2.0. Everything outside
ee/. OSI-approved open source: run it in production, modify it, redistribute it. - Enterprise Modules – Business Source License 1.1. Everything inside
ee/: the MS SQL, Oracle and PostgreSQL connectors, the Keycloak, search and favorite plugins and the enterprise Helm chart. The source is public and free to use for development, testing, evaluation and demonstration. Production use requires a commercial license – contact sales@gentics.com. Every module converts to Apache 2.0 three years after its release (Change Date); the exact dates are inee/LICENSE.
The core runs without ee/. LICENSING.md has the details, the
cmp repository the overview across the platform.
Pull requests are welcome.
- Contributions to the core are accepted under the Apache License 2.0 with a DCO sign-off (
git commit -s). - Contributions to
ee/additionally need our Contributor License Agreement (corporate version). The CLA bot asks on your first pull request that touchesee/.
See CONTRIBUTING.md. Found a bug? Open an issue in this repository.
Gentics Software GmbH, the company behind Gentics Mesh, offers product maintenance, developer support, consulting and custom development. Contact sales@gentics.com.
Copyright (c) 2014-2026 Gentics Software GmbH. Gentics is a registered trademark of Gentics Software GmbH,
see TRADEMARKS.md.