Carbonio Docs Core

Carbonio Docs Core is the build and packaging repository for the LibreOffice-based document processing engine that powers the Zextras Carbonio Docs collaborative editing feature. It compiles a headless, server-optimized LibreOffice core, producing DEB and RPM packages for deployment.

Overview

This repository contains packaging definitions (PKGBUILD files) and build configurations for:

• docs-core - A customized, headless LibreOffice core (v26.04.2), sourced from the CollaboraOnline/online.mirror engine/ tree, configured for server-side document processing. GUI, desktop integration, and optional features are disabled to produce a lean document conversion and rendering engine.

Packages are installed under /opt/zextras/docs/ with COKit (formerly LibreOfficeKit) headers in /opt/zextras/common/include/COKit, an engine build-tree subset in /opt/zextras/docs/engine (static POCO, OpenSSL, expat, libpng and zstd, which carbonio-docs-editor links coolwsd against) and PyUNO Python bindings symlinked into the system Python path.

Quick Start

Prerequisites

Building requires yap (version 1.48 or later) and podman installed on the host system. The PKGBUILD files declare all distribution-specific build and runtime dependencies, which are resolved automatically during the build process.

Note: This project requires YAP version 1.48 or later.

Ubuntu (APT) build dependencies include: autoconf, automake, bison, clang, flex, cmake, ninja-build, and various development libraries.

RHEL (YUM) build dependencies include: automake, bison, clang, cmake, ninja-build, gcc-c++, and various development libraries.

See docs-core/PKGBUILD for the complete dependency lists.

Dependencies

This project requires custom packages from carbonio-thirds (e.g. carbonio-openssl, carbonio-curl). To build them locally:

git clone https://github.com/zextras/carbonio-thirds.git ../carbonio-thirds
cd ../carbonio-thirds
make build TARGET=ubuntu-noble
cd -

Then pass the artifacts directory when building this project (see below).

Building Packages

# Build all packages for Ubuntu 24.04 (with local dependencies)
make build TARGET=ubuntu-noble DEPS_DIR=../carbonio-thirds/artifacts

# Build for Rocky Linux 9
make build TARGET=rocky-9 DEPS_DIR=../carbonio-thirds/artifacts

# Build RHEL-only packages (e.g., libepoxy) for Rocky Linux 8
make build-rhel-only TARGET=rocky-8 DEPS_DIR=../carbonio-thirds/artifacts

Supported Targets

• ubuntu-jammy - Ubuntu 22.04 LTS
• ubuntu-noble - Ubuntu 24.04 LTS
• rocky-8 - Rocky Linux 8
• rocky-9 - Rocky Linux 9

Build Commands

• make build - Build the docs-core package
• make build-rhel-only - Build RHEL-only packages (Rocky only, skips Node.js installation)
• make clean - Remove build artifacts

Run make help to see all available options.

Installation

These packages are distributed as part of the Carbonio platform. To install:

Ubuntu (Jammy/Noble)

apt-get install <package-name>

Rocky Linux (8/9)

yum install <package-name>

Contributing

See CONTRIBUTING.md for information on how to contribute to this project.

License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE.md file for details.