Install the Knowledge Service
- Last Updated: November 20, 2026
- 1 minute read
- Semaphore
- Version 5.13
- Documentation
Note: Before installing, see Requirements software prerequisites or required technical specifications for Semaphore.
The Knowledge Service provides a highly available read-only version of published models. For general information about the Knowledge Service, refer to Knowledge Service Documentation.
Knowledge Service requires Java 21 or later and a reachable, initialized MarkLogic Server. If replacing Concepts Server, follow Upgrading from Concepts Server rather than treating it as an ordinary same-name package upgrade.
If required, install the Knowledge Service by executing the following command:
yum install Semaphore-KnowledgeService-<version>.noarch.rpm
The installer creates the semaphore-knowledge-service service. Before starting it, edit /etc/opt/semaphore/knowledgeService/marklogic.properties as described in Configuring the Knowledge Service.
Once configured, start the service with the following command:
systemctl start semaphore-knowledge-service
If you prefer to run the Knowledge Service without using the systemd service, for example, in a Docker container, change to the following directory:
/opt/semaphore/knowledgeService
Then, run the following command:
bin/start.sh
The script sets the following environment variable:
SEMAPHORE_LOG_DIR=/var/opt/semaphore/knowledgeService/logs
Note: After upgrading to a newer version of the Knowledge Service, it is recommended to republish your Semaphore models.