Skip to content
genticsPublic

About

Gentics Mesh - The open source headless CMS for developers

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

595 stars

Watchers

23 watching

Forks

Latest commit

 

History

11,892 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Gentics Mesh

The headless content repository of Gentics CMP – API-first, permission-aware, AI-ready

Core: Apache-2.0 Enterprise Modules: BUSL-1.1 Docker Latest release Stack Overflow CLA assistant

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.

Where it sits in Gentics CMP

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.

What you get

Repository map

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

Getting started

Run it

docker run -p 8080:8080 gentics/mesh:latest

Then 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.

Talk to it

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.

Build it

Requirements: Java 17, Maven 3.9+, Docker (for the tests).

git clone https://github.com/gentics/mesh.git
cd mesh
mvn clean install -DskipTests

The 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.

Branches

  • dev – next release
  • hotfix-<version> – maintenance of released versions
  • f-<ticket> – feature branches

Documentation and help

Licensing

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 in ee/LICENSE.

The core runs without ee/. LICENSING.md has the details, the cmp repository the overview across the platform.

Contributing

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 touches ee/.

See CONTRIBUTING.md. Found a bug? Open an issue in this repository.

Commercial services

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.

About

Gentics Mesh - The open source headless CMS for developers

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

595 stars

Watchers

23 watching

Forks

Releases

Packages

Used by

Contributors

Languages