All apps · 0 apps

ServiceControl-DB

Overview

Particular Software ServiceControl DB The 'particular/servicecontrol-ravendb' image is part of the Particular Service Platform, which includes the following images: - particular/servicecontrol-ravendb | The database used by the error/audit instances (https://docs.particular.net/servicecontrol/ravendb/containers) - particular/servicecontrol | The primary/error instance, which includes error handling and recoverability (https://docs.particular.net/servicecontrol/servicecontrol-instances/) - particular/servicecontrol-audit | The audit instance, which stores audit data, and can be scaled out to multiple audit instances (https://docs.particular.net/servicecontrol/audit-instances/) - particular/servicecontrol-monitoring | The monitoring instance, which tracks runtime information like throughput, queue length, and other metrics (https://docs.particular.net/servicecontrol/monitoring-instances/) - particular/servicepulse | The web application that provides a front end for recoverability and monitoring features (https://docs.particular.net/servicepulse/) This image is the database used by the particular/servicecontrol (https://hub.docker.com/r/particular/servicecontrol) and particular/servicecontrol-audit (https://hub.docker.com/r/particular/servicecontrol-audit) images, based on the official RavenDB image (https://hub.docker.com/r/ravendb/ravendb). The purpose of this image is to provide version parity between ServiceControl and database containers. Users can be sure that a given version of the servicecontrol and servicecontrol-audit container images have been tested with and are known to work with the matching version of servicecontrol-ravendb.

Readme

View on GitHub

NServiceBus.RavenDB

NServiceBus.RavenDB is the official NServiceBus persistence implementation for RavenDB.

It is part of the Particular Service Platform, which includes NServiceBus and tools to build, monitor, and debug distributed systems.

See the RavenDB Persistence documentation for more details on how to use it.

Running tests locally

Running the tests requires RavenDB 5.2 and two environment variables:

CommaSeparatedRavenClusterUrls containing the URLs, separated by commas, to connect to a RavenDB cluster to run cluster-wide transaction tests
RavenSingleNodeUrl containing the URL of a single node RavenDB instance to run non-cluster-wide tests

The tests can be run with RavenDB servers hosted on a Docker container.

CI Workflow

The CI workflow requires the following secret, unique to RavenDB, to be defined both as an Actions and Dependabot secret:

RAVENDB_LICENSE: A RavenDB development license, expressed as JSON, but all on one line, with escaped quotes \"

The value used by Particular is stored in a secure note called "RavenDB CI Secrets".

Spinning up the necessary infrastructure

This assumes docker and docker-compose are properly setup. It currently works on Windows with Docker Desktop but not on docker hosted in WSL2 only.

Acquire a developer license
Convert the multi-line license JSON to a single line JSON and set the LICENSE variable. Alternatively the license can be set using an .env file.
Inside the root directory of the repository issue the following command: docker-compose up -d.

The single node server is reachable under http://localhost:8080. The cluster leader is reachable under http://localhost:8081.

Install ServiceControl-DB on Unraid in a few clicks.

Find ServiceControl-DB in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for ServiceControl-DB Review the template variables and paths Click Install

Explore Unraid OS

Requirements

IMPORTANT: A single database container should not be shared between multiple ServiceControl instances in production scenarios.

See "https://docs.particular.net/servicecontrol/ravendb/containers" and "https://github.com/Particular/PlatformContainerExamples".

Related apps

Explore more like this

Explore all

Utilities apps

Links

Projectgithub.com Supportdiscuss.particular.net Docker Hubhub.docker.com Templateraw.githubusercontent.com

Details

Repository

particular/servicecontrol-ravendb:latest

Registry

https://hub.docker.com/r/particular/servicecontrol-ravendb

Last Updated2026-06-23

First Seen2025-08-05

Runtime arguments

Web UI: http://[IP]:[PORT:8080]/
Network: bridge
Shell: sh
Privileged: false

Template configuration

configPathrw

Target: /var/lib/ravendb/config
Default: /mnt/cache/appdata/servicecontrol_db/
Value: /

dataPathrw

Target: /var/lib/ravendb/data
Default: /mnt/cache/appdata/servicecontrol_db/data/

Web UIPorttcp

Target: 8080
Default: 8080
Value: 8080

PUIDVariable

Default: 99
Value: 99

PGIDVariable

Default: 100
Value: 100

Library

Curated

Categories