---
title: 'CELUM Extensions'
url: 'https://doc.brix.ch/celum_extensions'
markdown: 'https://doc.brix.ch/celum_extensions.md'
lang: en
date: '2026-10-26'
description: 'Technical documentation for CELUM Extensions – Software developed by brix'
taxonomy:
  category:
    - docs
---

[](#) 

  [ Welcome ](https://doc.brix.ch/)      CELUM Extensions    

# CELUM Extensions

#### Table of Contents

- [Property format](#property-format)
- [Naming Scheme](#naming-scheme)
- [Plugin Installation / Update](#plugin-installation-updat)
- [Nova Plugin Installation / Update](#nova-plugin-installation-)
- [Logging](#logging)
- [Translations](#translations)
- [License Issues](#license-issues)
- [CELUM version vs. CELUM release](#celum-version-vs-celum-re)

Here you'll find the configurable properties of our reusable CELUM Extensions.

## Property format

The general property format in the docs is:

##### pluginName.propertyName

> type: some-type, required: yes/no, default: xyz

Description and more infos about the property

## Naming Scheme

We use [Semantic Versioning](https://semver.org), with the lowest compatible CELUM API version tacked on.

Our naming scheme for JAR files is *pluginName-{version of the plugin}-{minimum celum api version}.jar*

e.g. `somePlugin-2.8.5-6.8.jar` means that **somePlugin** has version **2.8.5** and requires *at least* CELUM **6.8** to run. They usually also work on later versions ([6.20](https://brix.getoutline.com/s/68c4d71c-126f-4b1f-b2e2-f85f28f0b5d9) and [7.1](https://brix.getoutline.com/s/81b2e815-3196-4866-aaca-3f245d3a91d0) being an exception to this rule).

## Plugin Installation / Update

1. Copy the JAR file to your *celum/home/appserver/lib* folder. Make sure the plugin version is compatible to your CELUM version (see naming scheme above).
2. Delete or remove any old versions of the plugin from the *lib* folder. This step could cause CELUM to stop working properly until it is restarted.
3. Update the *celum/home/appserver/conf/custom.properties* file with all the required properties (consult the individual plugin page).
4. Further customize the plugin by adding other properties to the *custom.properties* file (optional).
5. Restart the CELUM appserver.
6. Delete all files starting with the plugin's prefix in *celum/server/app/work/Catalina/localhost/ROOT/org/apache/jsp/jsp*. The folder could be named slightly different, depending on your installation. This step is only required for GUI plugin updates.
7. For GUI plugin updates it is also recommended to either clear the browser cache or press *Ctrl+Shift+R* after opening the plugin's GUI to reload CSS and JavaScript files.

## Nova Plugin Installation / Update

1. Copy the Plugin folder to your *celum/home/nova-plugins* folder (or whatever your `nova.app.plugins` points to). Make sure the plugin version is compatible to your CELUM version. (the plugin folder is normally shipped in a zip folder by brix)
2. Update the *celum/home/nova-plugins/plugins-config.json* file to register the nova plugin (you can find the content you have to add in the plugin-config.json file in the zip, shipped by brix).
3. Install the backend plugin (See Plugin Installation / Update).
4. Restart the CELUM appserver.
5. It is also recommended to either clear the browser cache or press *Ctrl+Shift+R* after opening the plugin's GUI to reload CSS and JavaScript files.

## Logging

If you prefer to have our plugins log to their own log file, add the following to your `celum/home/appserver/log4j2.xml`:

in the `<Appenders>` section:

```xml
    <!-- brix log -->
    <RollingFile name="brixlog" fileName="${sys:celum.home}/appserver/log/brix.log"
                 filePattern="${sys:celum.home}/appserver/log/brix.%d{yyyy-MM-dd}.log.zip">
      <PatternLayout pattern="%d{yyyy:MM:dd HH:mm:ss} %C{1} %-5p %m%n"/>
      <Policies>
        <TimeBasedTriggeringPolicy interval="1"/>
      </Policies>
      <DefaultRolloverStrategy compressionLevel="5">
        <Delete basePath="${sys:celum.home}/appserver/log">
          <IfFileName glob="brix.*.log.zip" />
          <IfLastModified age="30d" />
        </Delete>
      </DefaultRolloverStrategy>
    </RollingFile>
```

and in the `<Loggers>` section:

```xml
    <!-- brix log -->
    <Logger name="ch.brix" level="DEBUG" additivity="false">
      <AppenderRef ref="brixlog" />
    </Logger>
```

... set the `level=` to one of ERROR, INFO, DEBUG or TRACE as you desire, and don't leave it at verbose levels in production (or as soon as you've found the issue).

## Translations

To change the translations of terms used in our plugins:

1. Open/extract the JAR file as you would a ZIP file
2. For your desired language, search for a `<lang>.properties` file, e.g. `de.properties` for German
3. In said file, search for the term you wish to change, e.g. `Foo Bar` might be listed as `pluginName.fooBar=Foo Bar`
4. Copy the line over to your `<home>/appserver/lang/customMessages_<lang>.properties` and adapt right-hand side, e.g. `pluginName.fooBar=Foo Baz`
5. Restart the appserver

## License Issues

- **License file not found**: Since 6.8, the environment variable `synergy.home` has been renamed to `celum.home` - supposedly this should have been backwards-compatible, but apparently it's not. Therefore we'd recommend that you have both `-Dsynergy.home=...` **and** `-Dcelum.home=...` pointed to the same location in order to achieve backwards-compatibility with older releases.

## CELUM version vs. CELUM release

Starting with CELUM 6 (aka ContentHub), the notion of "releases" was introduced, which has nothing to do with the actual version. But sometimes this matters, so we'll stick with the version. Here's a lookup table:

| CELUM Version | CELUM Release Name | CELUM API |
|---|---|---|
| 5.x | 5.x | 1.x |
| 6.0.0 | 18.12 | 2.0 |
| 6.0.1 | 19.1 | 2.0 |
| 6.1.x | 19.3 | 2.1 |
| 6.2.0 | 19.6 | 2.2 |
| 6.2.1 - 6.2.x | 19.8 | 2.2.2 |
| 6.3.x | 19.10 | 2.3 |
| 6.4.0 | 19.12 | 3.0 |
| 6.4.1 - 6.4.x | 20.2 | 3.0 |
| 6.5.x | 20.3 | 3.1 |
| 6.6.x | 20.6 | 3.2 |
| 6.7.x | 20.7 | 3.3 |
| 6.8.x | 20.9 (ESR) | 3.4 |
| 6.9.x | 21.2 | 3.5 |
| 6.10.x | 21.5 | 3.6 |
| 6.11.x | 21.9 | 3.7 |
| 6.12.x | 22.1 (ESR) | 3.8 |
| 6.13.x | 22.4 | 3.9 |
| 6.14.x | 22.9 | 3.10 |
| 6.15.x | 23.1 | 3.11 |
| 6.16.x | 23.5 (ESR) | 3.12 |
| 6.17.x | 23.12 | 3.13 |
| 6.18.x | 24.4 | 3.14 |
| 6.19.x | 24.7 | 3.15 |
| 6.20.x | 25.1 (ESR) | 3.16 |
| 7.0.x | 25.7 | 3.17 |
| 7.1.x | 26.7 (ESR) | 3.18 |

*ESR = Extended Support Release*

 [ ](https://doc.brix.ch/) [](https://doc.brix.ch/celum_extensions/direct_download)

---

## Navigation

- Previous: [Welcome](https://doc.brix.ch/index.md)
- Next: [CELUM Connectors](https://doc.brix.ch/celum_connectors.md)
- Children:
  - [Direct Download](https://doc.brix.ch/celum_extensions/direct_download.md)
  - [Event Dispatcher](https://doc.brix.ch/celum_extensions/event_dispatcher.md)
  - [Copy Structure](https://doc.brix.ch/celum_extensions/structure_copy.md)
  - [Global Statistics](https://doc.brix.ch/celum_extensions/global_statistics.md)
  - [Metadata Importer](https://doc.brix.ch/celum_extensions/metadata_importer.md)
  - [Asset Exporter](https://doc.brix.ch/celum_extensions/asset_exporter.md)
  - [Create Collection](https://doc.brix.ch/celum_extensions/create_collection.md)
  - [Carbon Copy](https://doc.brix.ch/celum_extensions/carbon_copy.md)
  - [Asset Statistics](https://doc.brix.ch/celum_extensions/asset_statistics.md)
  - [Node Merger](https://doc.brix.ch/celum_extensions/node_merger.md)
  - [Batch Rename & Sort](https://doc.brix.ch/celum_extensions/sort_and_rename.md)
  - [Metadata Mapper](https://doc.brix.ch/celum_extensions/metadata_mapper.md)
  - [Duplicate Check & Sync](https://doc.brix.ch/celum_extensions/duplicate_check.md)
  - [Asset Approval](https://doc.brix.ch/celum_extensions/asset_approval.md)
  - [Remove from Node](https://doc.brix.ch/celum_extensions/remove_from_node.md)
  - [Expiration Notifier](https://doc.brix.ch/celum_extensions/expiration_notifier.md)
  - [Asset Marker](https://doc.brix.ch/celum_extensions/asset_marker.md)
  - [Batch Search & Download](https://doc.brix.ch/celum_extensions/batch_search_download.md)
  - [Asset Order](https://doc.brix.ch/celum_extensions/asset_order.md)
  - [Share Listing](https://doc.brix.ch/celum_extensions/share_listing.md)
  - [Asset Validation](https://doc.brix.ch/celum_extensions/asset_validation.md)
  - [Auto Delete Task](https://doc.brix.ch/celum_extensions/auto_delete_task.md)
  - [Autotranslator](https://doc.brix.ch/celum_extensions/auto_translator.md)
  - [Smart Collections](https://doc.brix.ch/celum_extensions/smart_collections.md)
  - [Date to Availability Sync](https://doc.brix.ch/celum_extensions/date_to_availability_sync.md)
  - [Delete empty Nodes](https://doc.brix.ch/celum_extensions/delete_empty_nodes.md)
  - [Multi Relation Assignment](https://doc.brix.ch/celum_extensions/multi_relation_assigment.md)
  - [Focal Point Setter](https://doc.brix.ch/celum_extensions/focal_point_setter.md)
  - [Widget Quicklinks](https://doc.brix.ch/celum_extensions/widget_quicklinks.md)
  - [Node Name to Infofield](https://doc.brix.ch/celum_extensions/node_name_to_infofield.md)
  - [REST Infofield Setter](https://doc.brix.ch/celum_extensions/rest_infofield_setter.md)
  - [Relation Marker](https://doc.brix.ch/celum_extensions/relation_marker.md)
  - [Image Rotator](https://doc.brix.ch/celum_extensions/image_rotator.md)
  - [Custom Previews](https://doc.brix.ch/celum_extensions/custom_previews.md)
  - [User Sync Field](https://doc.brix.ch/celum_extensions/user_sync_field.md)
  - [Share Menu](https://doc.brix.ch/celum_extensions/share_menu.md)
  - [Multi Node Reference Editor](https://doc.brix.ch/celum_extensions/multi_noderef_edit.md)
  - [Public URL for Conversions](https://doc.brix.ch/celum_extensions/public_url_download.md)
  - [Message Editor](https://doc.brix.ch/celum_extensions/message_editor.md)
  - [Forced Subscription](https://doc.brix.ch/celum_extensions/forced_subscription.md)
  - [Search util](https://doc.brix.ch/celum_extensions/search_util.md)
  - [EyeEm Autotagger](https://doc.brix.ch/celum_extensions/eyeem.md)
  - [Configurable Filenames](https://doc.brix.ch/celum_extensions/configurable_filename_resolver.md)
  - [Upload Request 3](https://doc.brix.ch/celum_extensions/upload_request_3.md)
  - [Custom Preview Setter](https://doc.brix.ch/celum_extensions/custom_preview_setter.md)
  - [Version Viewer](https://doc.brix.ch/celum_extensions/version_viewer.md)
  - [Asset De-Duplicator](https://doc.brix.ch/celum_extensions/asset_deduplicator.md)
  - [Sidebar Map](https://doc.brix.ch/celum_extensions/sidebar_map.md)
  - [MS Azure Autotagger](https://doc.brix.ch/celum_extensions/azure_computer_vision.md)
  - [Search util 2](https://doc.brix.ch/celum_extensions/search_util_2.md)
  - [Archive Manager](https://doc.brix.ch/celum_extensions/archive_manager.md)
  - [Login Management](https://doc.brix.ch/celum_extensions/login_management.md)
  - [Local Hotfolder](https://doc.brix.ch/celum_extensions/local_hotfolder.md)
  - [Configurable Date Sync](https://doc.brix.ch/celum_extensions/configurable-date-sync.md)
  - [Assignment Handler](https://doc.brix.ch/celum_extensions/assignment-handler.md)
  - [Celum User Service](https://doc.brix.ch/celum_extensions/celumuserservice.md)
  - [MS Azure Face Recognition](https://doc.brix.ch/celum_extensions/azure_face_recognition.md)
  - [MS Azure Custom Tags](https://doc.brix.ch/celum_extensions/azure_custom_tags.md)
  - [Email Ingest](https://doc.brix.ch/celum_extensions/email_ingest.md)
  - [SCIM Endpoint](https://doc.brix.ch/celum_extensions/scim_endpoint.md)
  - [Asset Review](https://doc.brix.ch/celum_extensions/asset_review.md)
  - [Video Dimension Translator](https://doc.brix.ch/celum_extensions/video_dimension_translator.md)
  - [Campaign Management](https://doc.brix.ch/celum_extensions/campaign_management.md)
  - [Azure Video Analyzer](https://doc.brix.ch/celum_extensions/azure_video_analyzer.md)
  - [Date-controlled Infofields](https://doc.brix.ch/celum_extensions/datecontrolled_info_fields.md)
  - [Filename Decoder](https://doc.brix.ch/celum_extensions/filename_decoder.md)
  - [Versioned Infofields](https://doc.brix.ch/celum_extensions/versioned_infofields.md)
  - [Clone Binary Sync](https://doc.brix.ch/celum_extensions/clone_binary_sync.md)
  - [Anura EasyShare](https://doc.brix.ch/celum_extensions/anura_easy_share.md)
  - [DNG Validate](https://doc.brix.ch/celum_extensions/dng_validate.md)
  - [Asset Metadata Copy](https://doc.brix.ch/celum_extensions/asset_metadata_copy.md)
  - [GDPR API](https://doc.brix.ch/celum_extensions/gdpr_api.md)
  - [File Extractor](https://doc.brix.ch/celum_extensions/file_extractor.md)
  - [Carbon Copy Plus (Premium)](https://doc.brix.ch/celum_extensions/carbon_copy_plus.md)
  - [Shadow Assets](https://doc.brix.ch/celum_extensions/shadow_assets.md)
  - [Batch Search And Apply Metadata](https://doc.brix.ch/celum_extensions/batch_search_and_apply_metadata.md)
  - [Asset Report](https://doc.brix.ch/celum_extensions/asset_report.md)
  - [Mail Inquiry](https://doc.brix.ch/celum_extensions/mail_inquiry.md)
  - [Table Editor](https://doc.brix.ch/celum_extensions/table_editor.md)
  - [Version Cleanup](https://doc.brix.ch/celum_extensions/version_cleanup.md)
  - [Multinode Check](https://doc.brix.ch/celum_extensions/multinode.md)
