mintjams/cms repository overview

⁠MintJams CMS

MintJams CMS is a lightweight, high-performance Content Management System built on a simplified implementation of the Content Repository for Java Technology API 2.0 (JSR 283).

It bundles a JCR-backed server runtime on Apache Felix alongside a modern, browser-based virtual desktop ("Webtop") for content authoring, enterprise integrations, and system administration. It features zero-configuration SAML 2.0 authentication out of the box.

⁠Key Features

• JCR-Backed Server Runtime: Runs on Apache Felix with JCR content repository, integrated with Apache Camel and Camunda BPM.
• Webtop Virtual Desktop: Rich client desktop environment equipped with built-in applications:
  • Content Browser & Identity Manager
  • BPM Console & BPMN / EIP Modeler
  • OSGi Console, Mail, Chat, and collaborative games
• Zero-Configuration SAML 2.0: Built-in Service Provider (SP) and Identity Provider (IdP) with seamless in-JVM trust.
• Modern Security:
  • Passkey (WebAuthn) support (face/fingerprint recognition, security keys)
  • Two-Step Verification (TOTP) with single-use recovery codes
  • AES-encrypted credentials store
• Multi-Architecture Support: Native linux/amd64 and linux/arm64 images (supports x86_64 and Apple Silicon/ARM64 servers without emulation).

⁠Quick Start

Run the container with CMS_PUBLIC_BASE_URL specified (required for SAML SP/IdP URL generation):

docker run -d \
  -p 8080:8080 \
  -e CMS_PUBLIC_BASE_URL=http://localhost:8080 \
  -v cms-repository:/data/repository \
  -v cms-secrets:/data/secrets \
  -v cms-index:/data/index \
  --name mintjams-cms \
  mintjams/cms:latest

Open http://localhost:8080 in your browser.

⁠Docker Compose

services:
  cms:
    image: mintjams/cms:latest
    restart: unless-stopped
    environment:
      CMS_PUBLIC_BASE_URL: "http://localhost:8080"
    ports:
      - "8080:8080"
    volumes:
      - cms-repository:/data/repository
      - cms-secrets:/data/secrets
      - cms-index:/data/index

volumes:
  cms-repository:
  cms-secrets:
  cms-index:

⁠First Login

On the first start, a random password for the built-in admin user is generated and stored in the repository volume. Retrieve it using:

docker exec mintjams-cms cat /data/repository/INITIAL_PASSWORD.txt

Log in as admin, change the password via Preferences, and delete the password file:

docker exec mintjams-cms rm /data/repository/INITIAL_PASSWORD.txt

Alternatively, set the initial password on startup by passing -e CMS_INITIAL_ADMIN_PASSWORD=your_password.

⁠Configuration & Volume Mounts

⁠Environment Variables

⁠Persistent Volumes

⁠Links & Documentation

• GitHub Repository: mintjamsinc/cms0⁠
• Official Website: MintJams Inc.⁠
• License: MIT

⁠Trademarks

All trademarks are the property of their respective owners.

Built with ❤️ by MintJams Inc.⁠