Installation

Installation

Installation is very simple. Just download the current version from https://github.com/thmarx/cms/releases and extract into desired folder. cms comes with an embedded web server, so there is no need to run an apache, nginx or any other web server.

Configuration

We have two kinds of configuration, global and per host configurations.

Global config

First there is the application.properties. Here you can config the port and the ip the server will listen on. Setting the dev mode to true, will disable most caches. For production you should definitly set this to false.

Example server config

server.port=8080
server.ip=127.0.0.1
dev=true

Per host config

The per host config is not shared between virtual hosts.

hostname is the hostname under which the virtual host should be reachable.
tempate.engine the template engine to be used for this virtual host. Your options here are currently freemarker, thymeleaf and pebble. markdown.engine the markdown rendering engine used for this virtual host. Options are flexmark, markedjs and markedj. modules.active, all used module have to be listed here. In case you miss one, maybe there will be no markdown renderer available. Most times you just need one markdown renderer and one template engine.

Example host config

hostname: localhost
template:
  engine: thymeleaf
markdown:
  engine: flexmark
modules:
  active:
    - flexmark-module
    - thymeleaf-module

Starting

Linux

java -Dlog4j2.configurationFile=log4j2.xml -jar cms-server-2.2.0.jar

Windows

java "-Dlog4j2.configurationFile=log4j2.xml" -jar cms-server-2.2.0.jar