Knowledgeroot

Structured Knowledge Management for Teams and Organizations

Version 1.1.0 is the stable release Coming in 1.2: live collaboration, single sign-on, notifications and full-text search

Modern Technology, Proven Concept

Knowledgeroot is a self-hosted wiki for teams and public knowledge bases. Pages live in a tree, every change is kept, and access is controlled per page. Everything below ships in the stable release 1.1.0; items marked 1.2 are part of the upcoming release.

Content

Tree Structure

Organize pages in a hierarchy with unlimited depth. Move a page together with its subtree; links, labels, comments and attachments stay intact.

Rich Text Editor

Tiptap-based editor with headings, lists, quotes, code blocks, tables, links and images. MIT-licensed, no editor license key required. 1.2: autosave into a working copy, drafts, page templates per space and live collaboration with visible carets.

Version History

Every change is archived before it is overwritten. Compare versions side by side, restore an earlier one, and bring back deleted pages.

Search and Attachments

Search titles and content, with results limited to what the current user may read. Attach files to pages, stored on disk or in an S3-compatible bucket. 1.2: a full-text index over titles, labels, content and the text of attachments including PDF, best matches first.

Collaboration and Access

Page Permissions

Read and edit rights per page for users and groups. Subpages inherit from their parent by default; explicit exceptions are possible where needed.

Public and Private

Run a fully public knowledge base, a strictly internal one, or both in a single installation. Guest access is granted per page and can be revoked for a whole subtree.

Conflict Protection

Saving checks the page revision. If someone else saved first, your draft stays in the browser and nothing is silently overwritten. 1.2: several people edit the same page at once and see each other's changes as they type; watchers are notified when a page is published, commented on or moved.

Account Security

PBKDF2 password hashing, login throttling per account and address, two-factor authentication and optional password recovery by email. 1.2: single sign-on through any OpenID Connect provider such as Keycloak, Authentik, Entra ID or Google.

Operations

Container Images

Official images on Docker Hub, built and vulnerability-scanned in CI, running as a non-root user. The production profile refuses unsafe settings at startup.

Monitoring

Liveness and readiness endpoints for orchestrators and reverse proxies, plus metrics for Prometheus-style scraping.

Client API and MCP

JSON endpoints for pages, files, users and groups, enforcing the same permissions as the web interface, and an MCP server for AI assistants. 1.2: templates, attachment uploads, watching and notifications over the API; one MCP prompt per template.

Open Source

BSD-2-Clause licensed. Java 25, Spring Boot 4 and MariaDB; schema upgrades run automatically with Liquibase.

Coming in 1.2

The 1.2 line is feature-complete on master and in final testing; the release follows the same verification as 1.1. Until then, 1.1.0 stays the stable release. Progress and details are in the roadmap.

Autosave, Working Copies and Drafts

The editor saves as you type into a working copy that readers never see; publishing creates the version. Pages can start as drafts visible only to editors, and the working copy survives a closed tab.

Live Collaboration

Several people edit the same page at once and see each other's carets, names and changes as they type, title and labels included. Built on Yjs over one WebSocket per editor, no extra service to run.

Single Sign-On

Sign in through any OpenID Connect provider: Keycloak, Authentik, Entra ID, Google. Accounts are created or linked by verified e-mail on the first sign-in; groups and the administrator role can follow a claim.

Page Templates

Space administrators prepare a title, content and labels per space. "New page" offers them, the client API and MCP use them, and every template becomes an MCP prompt for assistants.

Watching and Notifications

Watch a page or a whole space and hear about publications, comments and moves, or be mentioned with @login in a comment. In-app history with an unread badge, mails per event or as an hourly or daily summary, sent through a durable queue administrators can inspect.

Full-Text Search

A full-text index over titles, labels, content and the text of attachments including PDF. Title hits come first, then labels, content and attachments; a hit inside an attachment names the file and quotes it.

What's new in 1.1

Version 1.1.0 is the stable release of the 1.1 line, published on 6 November 2026. It upgrades a 1.0 installation in place; see how to upgrade below.

Spaces

Give each team its own page tree with its own permissions, like a Confluence space. A switcher in the header moves between spaces; search, favourites and the sidebar follow. Existing pages land in a default space on upgrade.

Two-Factor Authentication

Time-based one-time codes from any authenticator app, with recovery codes. Administrators decide whether the second factor is off, optional, required for administrators or required for everyone.

MCP Server for AI Assistants

Connect Claude or any other MCP client with OAuth 2.1 and your own account. Assistants search, read and, with your consent, write pages with exactly your permissions. Every call is recorded in an audit log for administrators.

Graphite Theme

A calmer dark mode in graphite grey instead of black, inspired by modern IDE themes, and a matching dark header in light mode.

Mobile App

A Flutter app for Android and iOS against the new client API: page tree, editor, attachments, comments, history, spaces and the second login step. Source on GitHub.

Smaller Things

The interface in English, German, French, Spanish, Italian and Dutch, chosen per user. Markdown as the exchange format for assistants, labels and change filters in search, page resources and prompts for summaries and stale-page reviews, and tighter dependency pinning with a clean security scan.

Knowledgeroot Insights

Taken from a 1.1 installation with a small demo wiki.

Page view with the space switcher, page tree, labels, a table, a code block and an attachment

Page view with space, labels, table and code

The same page in the graphite dark mode

Graphite dark mode

Editor with name, labels, formatting toolbar and the page content

Editor with labels and permissions tab

Open space switcher listing Company Wiki, Engineering, Operations and People

Space switcher

Two-factor setup with QR code and manual key

Two-factor authentication setup

Administrator view of the MCP server with the audit log of assistant calls

MCP server audit log for administrators

Search results across spaces with highlighted matches

Search across spaces

Page history with version comparison

Page history and version comparison

Getting Started

Download

Current stable release: v1.1.0, Docker tags v1.1.0 and database-v1.1.0. The previous line stays available as v1.0.0; the latest image follows the main branch and is not meant for production. The JAR needs Java 25 and MariaDB; verify it with the SHA256SUMS from the release page, see below.

Docker Setup

Quick Start

Save the configuration below as docker-compose.yml and start it:

docker compose up -d

After starting, visit http://localhost:8080

Default Logins:

Login: user
Password: password

Login: admin
Password: password

This setup is meant for trying Knowledgeroot locally: the demo logins and database password are public. For a hardened deployment behind HTTPS see docs/production.md.

Docker Compose Configuration

Run the JAR without Docker

Every release tag also publishes the verified JAR as a GitHub release, together with SHA256SUMS, the release manifest and the audit reports. It is the same JAR that ships inside the Docker image. You need Java 25 and a MariaDB server.

base=https://github.com/lordlamer/jknowledgeroot/releases/download/v1.1.0
curl -fsSLO "$base/knowledgeroot-1.1.0.jar"
curl -fsSLO "$base/SHA256SUMS"
sha256sum -c --ignore-missing SHA256SUMS

export SPRING_PROFILES_ACTIVE=development
export KR_DB_URL='jdbc:mariadb://localhost:3306/knowledgeroot?createDatabaseIfNotExist=true'
export KR_DB_USER=root
export KR_DB_PASSWORD=knowledgeroot
export KR_STORAGE_DRIVER=file
export KR_FILE_STORAGE_DIR=./files
java -jar knowledgeroot-1.1.0.jar

The application listens on http://localhost:8081 with the same demo logins as above. For a production setup use the production profile with the variables described in docs/installation.md and docs/production.md.

Upgrading from 1.0

v1.1.0 is published as a release on GitHub and as Docker tags v1.1.0 and database-v1.1.0. Compared with the release candidate it adds the interface languages and the November security updates of the base images. A 1.0 installation upgrades in place:

  1. Take a backup of the database and the file storage; there is no downgrade path, a rollback restores the backup.
  2. Set KR_MASTER_KEY for the production profile: it encrypts the authenticator secrets and the OAuth signing keys and must stay the same afterwards.
  3. Start the new version; the schema migrations run on startup and move all existing pages into a default space.
  4. Optional: enable the MCP server and the two-factor policy under Admin → Settings.

Connect an AI assistant

Point an MCP client such as Claude at https://your-host/mcp. The client registers itself, you sign in with your Knowledgeroot account and choose read or read-and-write access. Details in docs/mcp.md.

Found a problem? Please open an issue on GitHub with the version and the steps to reproduce.

Documentation

The documentation lives in the GitHub repository next to the code. The README is in English; the detailed guides are currently written in German.

README

Build, tests, initial administrator, page permissions, login and configuration overview.

Installation and Upgrades

First start, bootstrap administrator, demo mode and upgrading an existing installation.

Production Deployment

Hardened compose setup, reverse proxy and HTTPS, separate database roles, backups.

Permissions

Permission matrix, inheritance, guest access and how rights are enforced in UI and API.

History and Conflicts

Concurrent editing, viewing and restoring versions, deleted pages.

Editor and Live Collaboration

The Tiptap editor, autosave and working copies, shared editing over WebSockets and page templates (1.2).

Product Functions

What the application does, feature by feature: spaces, search, templates, notifications, assistants and more.

File Storage

Local and S3-compatible storage, upload limits and cleanup.

Authentication

Password rules, hash migration, login throttling, sessions and, from 1.2, single sign-on through OpenID Connect.

Monitoring

Health probes, metrics, logs and alerting for container deployments.

Roadmap and Releases

What 1.0 and 1.1 contain, what 1.2 brings, what is planned for 1.3, and how releases are built and verified.

AI Assistants (MCP)

Enabling the server, connecting a client, the tool set, resources, prompts, audit log and limits.

Product Functions

Spaces, two-factor authentication, moving page trees, comparing versions and changing your password.

Client API and Mobile App

The JSON API under /api/v1 used by the Flutter app for Android and iOS.

Important Migration Notice

The PHP version of Knowledgeroot is no longer supported. Please migrate to the Java version. There is no automated upgrade path from the PHP version yet; content has to be migrated manually.

Upgrades between releases of the Java version are automatic: the database schema is migrated on startup. See docs/installation.md for the upgrade checklist.