Getting Started Guide

Here you will find everything to get you started with Gentics Mesh.

If you don’t have much time:

  • Try the Quickstart for playing around with Gentics Mesh and it’s user interface.

  • Head over to the TL;DR section to find out everything you need to know and what makes Gentics Mesh special.

Quickstart

Java Runtime 1.8.0_40 or newer is required to run Gentics Mesh.
  1. Download Gentics Mesh from http://getmesh.io/Download into an empty folder

  2. Start the JAR-file by executing java -jar mesh-demo-X.X.X.jar

  3. Point your browser to http://localhost:8080/mesh-ui/ to reach the Mesh Admin UI

TL;DR

Gentics Mesh Overview of Core Concepts

  • You organize your contents and media assets in projects.

  • A schema is used to define the structure of a content type (e.g. product, blogpost). It has a set of standard fields (uuid, name, version etc.) and defines the types of an arbitrary number of custom fields for your content type (i.e. string, number, HTML, date, binary, list, node reference, micronode, boolean).

  • The actual content items of your project are called nodes and always follow a schema.

  • Everything is a node, there is no separate concept for media assets.To get you started, we ship with schemas for image, video, document, and audio that you may customize to your needs and liking!

  • Nodes can be tagged. A tag family groups tags that semantically belong together and is defined for a specific project.

  • Gentics Mesh supports building content trees. Nodes can be hierarchically structured if a container-schema is provided. While it’s possible to organize your contents in a simple, flat structure with tagging and referencing, content trees are the basis for leveraging the power of automatic navigation menus, breadcrumbs, pretty URLs and link resolving. For your convenience, Gentics Mesh is shipped with a generic folder schema that you may choose for hierarchically organizing your content in a tree and ultimately following the well-known file system paradigm.

  • With micronodes it is possible to build complex object data structures as they are basically representing subnodes of nodes. They allow for creating custom content components, e.g. media elements of your blogpost such as YouTube videos, image galleries, Google maps, image with caption, vcards, quotes, or text paragraphs to be mixed and matched.

  • Supporting multi-language and localisation, nodes can hold several language variants of your content.

  • Each user (a physical person or client app) has a user object counter part in Gentics Mesh, which can be extended by referencing a custom user node. By defining your custom user schema Gentics Mesh supports extensible user profiles for your apps.

  • Groups are used to organize users, e.g., of same access levels.

  • Roles are used to manage permissions between a role and other elements in Gentics Mesh (i.e., nodes, schemas, users, roles, etc.). Roles can be assigned to groups, thus efficiently granting the role’s permissions to a set of users.

Startup

Run Gentics Mesh by executing java -jar mesh-demo-X.X.X.jar. All neccessary configuration files and directories will be created and an AngularJS demo project is deployed automatically.

Once the demo setup is completed you will be able to access the following urls

Demo Credentials

  • Admin: admin/admin

  • Editor: editor/editor

  • Webclient: webclient/webclient

Demo

Once the Mesh setup is complete, a demo application will be automatically deployed to the install location under the demo folder. This demo app is accessible at http://localhost:8080/demo/, and is intended as a simple example of how Mesh can be used.

The app is composed of static files and can therefore be edited in place. The two JavaScript files which make up the app contain in-line documentation to help you get started.