## Introduction - [About ServiceControl](https://docs.particular.net/servicecontrol/index.md): An overview of ServiceControl and what it does. - [How does it work](https://docs.particular.net/servicecontrol/how.md): An overview of how ServiceControl collects and processes messages and data from an NServiceBus system. - [Licensing](https://docs.particular.net/servicecontrol/license.md): Configure and manage ServiceControl license. - [Hosting](https://docs.particular.net/servicecontrol/hosting.md): Hosting options for running ServiceControl instances. - [Support policy](https://docs.particular.net/servicecontrol/upgrades/support-policy.md): Versions of ServiceControl that are currently supported. - [Supported versions](https://docs.particular.net/servicecontrol/upgrades/supported-versions.md): Supported versions of ServiceControl. ## Upgrade Guides - [Upgrade tips](https://docs.particular.net/servicecontrol/upgrades/index.md): Tips for upgrading to newer versions of ServiceControl. - [Version 6.4 to 6.5](https://docs.particular.net/servicecontrol/upgrades/6.4to6.5.md): Instructions on how to upgrade ServiceControl from version 6.4 to 6.5. - [Version 6.3 to 6.4](https://docs.particular.net/servicecontrol/upgrades/6.3to6.4.md): Instructions on how to upgrade ServiceControl from version 6.3 to 6.4. - [Version 5 to 6](https://docs.particular.net/servicecontrol/upgrades/5to6.md): Instructions on how to upgrade ServiceControl from version 5 to 6. - [Version 5.1 to 5.2](https://docs.particular.net/servicecontrol/upgrades/5.1to5.2.md): Instructions on how to upgrade ServiceControl from version 5.1.x to 5.2.x. - [Version 4 to 5](https://docs.particular.net/servicecontrol/upgrades/4to5/index.md): Instructions on how to upgrade ServiceControl from version 4 to 5. - [Version 3 to 4](https://docs.particular.net/servicecontrol/upgrades/3to4/index.md): Instructions on how to upgrade ServiceControl from version 3 to 4. - [Version 2 to 3](https://docs.particular.net/servicecontrol/upgrades/2to3.md): Instructions on how to upgrade ServiceControl from version 2 to 3. - [Version 1 to 2](https://docs.particular.net/servicecontrol/upgrades/1to2.md): Instructions on how to upgrade ServiceControl from version 1 to 2. ## Security - [Overview](https://docs.particular.net/servicecontrol/security/index.md): Enable authentication and HTTPS to protect access to ServiceControl and ServicePulse. - [Authentication](https://docs.particular.net/servicecontrol/security/configuration/authentication.md): How to enable and configure authentication for ServiceControl. - [Role-Based Access Control](https://docs.particular.net/servicecontrol/security/configuration/authorization.md): Restrict what authenticated users can do in ServiceControl and ServicePulse using roles. - [Forward Headers for Reverse Proxy](https://docs.particular.net/servicecontrol/security/configuration/forward-headers.md): How to enable and configure forward headers for ServiceControl instances. - [TLS](https://docs.particular.net/servicecontrol/security/configuration/tls.md): How to enable and configure TLS for ServiceControl instances. - [CORS](https://docs.particular.net/servicecontrol/security/configuration/cors.md): How to configure Cross-Origin Resource Sharing for ServiceControl instances. - [Hosting guide](https://docs.particular.net/servicecontrol/security/hosting-guide.md): Example hosting options for ServiceControl instances. - [Microsoft Entra ID Authentication Guide](https://docs.particular.net/servicecontrol/security/entra-id-authentication.md): Set up authentication with Microsoft Entra ID for ServiceControl and ServicePulse. ## Planning - [Optimizing for use in different environments](https://docs.particular.net/servicecontrol/servicecontrol-in-practice.md): Optimize ServiceControl installation and deployment for better performance; hardware, message throughput, plugin and performance considerations. - [Hardware Considerations](https://docs.particular.net/servicecontrol/servicecontrol-instances/hardware.md): Hardware recommendations for running ServiceControl instances. - [Capacity planning](https://docs.particular.net/servicecontrol/capacity-and-planning.md): Outlines the ServiceControl capacity, throughput, and storage considerations for planning and supporting production environments. - [Security](https://docs.particular.net/servicecontrol/securing-servicecontrol.md): How security is addressed in ServiceControl and how to limit access to ServiceControl data. - [Non-Privileged accounts](https://docs.particular.net/servicecontrol/configure-non-privileged-service-account.md): Using a low privilege account for ServiceControl. - [Business continuity / disaster recovery](https://docs.particular.net/servicecontrol/bcdr.md): Use multiple ServiceControl instances with error and audit log forwarding for business continuity and disaster recovery. - [Cluster deployment](https://docs.particular.net/servicecontrol/deploying-servicecontrol-in-a-cluster.md): A guide to deploying ServiceControl on a Windows failover cluster. - [Remote instances](https://docs.particular.net/servicecontrol/servicecontrol-instances/remotes.md): Aggregate data from other ServiceControl instances using the ServiceControl Remotes feature. ## Error instances - [ServiceControl Error instances](https://docs.particular.net/servicecontrol/servicecontrol-instances/index.md): A guide to ServiceControl Error Instances. Learn about how ServiceControl persists message data and the health monitoring options available. - [Integrated ServicePulse](https://docs.particular.net/servicecontrol/servicecontrol-instances/integrated-servicepulse.md): A guide to hosting ServicePulse and ServiceControl within the same host process. - [Remote access to integrated ServicePulse](https://docs.particular.net/servicecontrol/servicecontrol-instances/integrated-servicepulse-remote-access.md): How to make integrated ServicePulse reachable from other machines without installing IIS or a standalone ServicePulse. - [Deployment](https://docs.particular.net/servicecontrol/servicecontrol-instances/deployment/index.md): Learn about the deployment options for ServiceControl Error instances. Recommendations for setting up ServiceControl instances on production systems. - [Using Containers](https://docs.particular.net/servicecontrol/servicecontrol-instances/deployment/containers.md): A guide to setting up and deploying ServiceControl Error instances using Containers. - [Using PowerShell](https://docs.particular.net/servicecontrol/servicecontrol-instances/deployment/powershell.md): A guide to setting up and deploying ServiceControl Error instances using PowerShell. Prerequisites, installation and deployment. - [Using ServiceControl Management Utility](https://docs.particular.net/servicecontrol/servicecontrol-instances/deployment/scmu.md): A guide to using ServiceControl Management Utility to set up ServiceControl instances. Information about installing and upgrading ServiceControl instances. - [Queues](https://docs.particular.net/servicecontrol/queues.md): A breakdown of all of the queues required by each ServiceControl instance. - [Settings](https://docs.particular.net/servicecontrol/servicecontrol-instances/configuration.md): Categorized list of ServiceControl Error instance configuration settings. - [Transport configuration](https://docs.particular.net/servicecontrol/transports.md): ServiceControl can be configured to use one of the supported message transports, which are configured for each instance type. - [Configure the URI](https://docs.particular.net/servicecontrol/setting-custom-hostname.md): How to configure ServiceControl to be exposed through a custom hostname and IP port. - [RavenDB location](https://docs.particular.net/servicecontrol/configure-ravendb-location.md): Increase space for monitored data by configuring ServiceControl to save data in a location other than the default. - [Logging](https://docs.particular.net/servicecontrol/logging.md): Understand about ServiceControl logs; change log location and customize logging. - [Forwarding queues](https://docs.particular.net/servicecontrol/errorlog-auditlog-behavior.md): Details of the ServiceControl audit and error configuration and forwarding behavior. ## Audit instances - [ServiceControl Audit instances](https://docs.particular.net/servicecontrol/audit-instances/index.md): Information about ServiceControl Audit instances. - [Deployment](https://docs.particular.net/servicecontrol/audit-instances/deployment/index.md) - [Using Containers](https://docs.particular.net/servicecontrol/audit-instances/deployment/containers.md) - [Using PowerShell](https://docs.particular.net/servicecontrol/audit-instances/deployment/powershell.md) - [Using ServiceControl Management Utility](https://docs.particular.net/servicecontrol/audit-instances/deployment/scmu.md) - [Settings](https://docs.particular.net/servicecontrol/audit-instances/configuration.md): Categorized list of ServiceControl Audit instance configuration settings. ## Monitoring instances - [ServiceControl monitoring instances](https://docs.particular.net/servicecontrol/monitoring-instances/index.md): Information about monitoring instances in ServiceControl. - [Deployment](https://docs.particular.net/servicecontrol/monitoring-instances/deployment/index.md) - [Using Containers](https://docs.particular.net/servicecontrol/monitoring-instances/deployment/containers.md) - [Using PowerShell](https://docs.particular.net/servicecontrol/monitoring-instances/deployment/powershell.md) - [Using ServiceControl Management Utility](https://docs.particular.net/servicecontrol/monitoring-instances/deployment/scmu.md) - [Settings](https://docs.particular.net/servicecontrol/monitoring-instances/configuration.md): Categorized list of ServiceControl Monitoring instance configuration settings. - [Configure the URI](https://docs.particular.net/servicecontrol/monitoring-instances/configure-the-uri.md): How to configure a Monitoring instance to be exposed through a custom hostname and IP port. ## Data Management - [Data expiration](https://docs.particular.net/servicecontrol/how-purge-expired-data.md): Configuring ServiceControl's data retention policy. - [Accessing ServiceControl database](https://docs.particular.net/servicecontrol/ravendb/accessing-database.md): How to get direct access to the database used by ServiceControl Error and Audit instances. - [Backup](https://docs.particular.net/servicecontrol/backup-sc-database.md): How to backup the ServiceControl RavenDB instance. - [Containers](https://docs.particular.net/servicecontrol/ravendb/containers.md) (supported: [5.0.0, )) - [Compacting the database](https://docs.particular.net/servicecontrol/db-compaction.md): How to compact the RavenDB database backing ServiceControl for RavenDB 5 and RavenDB 3.5 instances. - [Move database location](https://docs.particular.net/servicecontrol/move-database-location.md): Move Database to Another Location. ## Integration - [Integration events](https://docs.particular.net/servicecontrol/contracts.md): Build custom notifications by subscribing to ServiceControl events. - [Transport adapter](https://docs.particular.net/servicecontrol/transport-adapter.md): How to decouple ServiceControl from an endpoint's transport. ## MassTransit - [Introduction](https://docs.particular.net/servicecontrol/masstransit/index.md): Introduction to the MassTransit Connector for ServiceControl. - [Deployment](https://docs.particular.net/servicecontrol/masstransit/docker-deployment.md): Configuring and running the MassTransit Connector and the rest of the Particular Platform. ## Migrations - [Overview](https://docs.particular.net/servicecontrol/migrations/index.md): Instructions for how to migrate ServiceControl instances in various scenarios. - [Windows hosting to Containers](https://docs.particular.net/servicecontrol/migrations/windows-to-containers.md): Instructions on how to migrate ServiceControl instances from Windows to container-based hosting. - [Retaining data between instances](https://docs.particular.net/servicecontrol/migrations/retain-data-between-instances.md): Instructions on how to retain ServiceControl data between instances. - [Replacing Error instances](https://docs.particular.net/servicecontrol/migrations/replacing-error-instances/index.md): Instructions on how to replace a ServiceControl Error instance with zero downtime. - [using ServiceControl Management](https://docs.particular.net/servicecontrol/migrations/replacing-error-instances/scmu.md): Instructions on how to replace a ServiceControl Error instance with zero downtime. - [using PowerShell](https://docs.particular.net/servicecontrol/migrations/replacing-error-instances/powershell.md): Instructions on how to replace a ServiceControl Error instance with zero downtime. - [using Containers](https://docs.particular.net/servicecontrol/migrations/replacing-error-instances/containers.md): Instructions on how to replace a ServiceControl Error instance with zero downtime. - [Replacing Audit instances](https://docs.particular.net/servicecontrol/migrations/replacing-audit-instances/index.md): Instructions on how to replace a ServiceControl Audit instance with zero downtime. - [using ServiceControl Management](https://docs.particular.net/servicecontrol/migrations/replacing-audit-instances/scmu.md): Instructions on how to replace a ServiceControl Audit instance with zero downtime. - [using PowerShell](https://docs.particular.net/servicecontrol/migrations/replacing-audit-instances/powershell.md): Instructions on how to replace a ServiceControl Audit instance with zero downtime. - [using Containers](https://docs.particular.net/servicecontrol/migrations/replacing-audit-instances/containers.md): Instructions on how to replace a ServiceControl Audit instance with zero downtime. - [New persistence format](https://docs.particular.net/servicecontrol/migrations/new-persistence.md): How to migrate ServiceControl Audit instances to the new persistence format introduced in version 4.26. ## Troubleshooting - [ServiceControl troubleshooting](https://docs.particular.net/servicecontrol/troubleshooting.md): Troubleshooting ServiceControl installation and common issues. - [Retry importing messages](https://docs.particular.net/servicecontrol/import-failed-messages.md): How to attempt to re-process messages that failed to be imported. - [Sequence contains no matching element](https://docs.particular.net/servicecontrol/sequence-contains-no-matching-element.md): ServiceControl Management Utility shows System.InvalidOperationException: Sequence contains no matching element. ## Other pages - [ServiceControl RavenDB](https://docs.particular.net/servicecontrol/ravendb/index.md) ## security - [ServiceControl Security Configuration](https://docs.particular.net/servicecontrol/security/configuration/index.md): How to secure ServiceControl instances. ## upgrades - [Alternative ServiceControl v4 upgrade option](https://docs.particular.net/servicecontrol/upgrades/4to5/alternative.md): Advanced alternative ServiceControl v4 upgrade option for environments that cannot retry all messages immediately. ## Version-specific pages - [Audit Instance Configuration Settings (servicecontrol_4)](https://docs.particular.net/servicecontrol/audit-instances/configuration_servicecontrol_4.md): Categorized list of ServiceControl Audit instance configuration settings. - [Audit Instance Configuration Settings (servicecontrol_5)](https://docs.particular.net/servicecontrol/audit-instances/configuration_servicecontrol_5.md): Categorized list of ServiceControl Audit instance configuration settings. - [ServiceControl Audit instances deployment options (servicecontrol_4)](https://docs.particular.net/servicecontrol/audit-instances/deployment/index_servicecontrol_4.md) - [ServiceControl Audit instances deployment options (servicecontrol_5)](https://docs.particular.net/servicecontrol/audit-instances/deployment/index_servicecontrol_5.md) - [Deploying ServiceControl Audit instances using PowerShell (servicecontrol_4)](https://docs.particular.net/servicecontrol/audit-instances/deployment/powershell_servicecontrol_4.md) - [Deploying ServiceControl Audit instances using PowerShell (servicecontrol_5)](https://docs.particular.net/servicecontrol/audit-instances/deployment/powershell_servicecontrol_5.md) - [Licensing ServiceControl (servicecontrol_4)](https://docs.particular.net/servicecontrol/license_servicecontrol_4.md): Configure and manage ServiceControl license. - [Licensing ServiceControl (servicecontrol_5)](https://docs.particular.net/servicecontrol/license_servicecontrol_5.md): Configure and manage ServiceControl license. - [ServiceControl Monitoring instances deployment options (servicecontrol_4)](https://docs.particular.net/servicecontrol/monitoring-instances/deployment/index_servicecontrol_4.md) - [ServiceControl Monitoring instances deployment options (servicecontrol_5)](https://docs.particular.net/servicecontrol/monitoring-instances/deployment/index_servicecontrol_5.md) - [Deploying ServiceControl Monitoring instances using PowerShell (servicecontrol_4)](https://docs.particular.net/servicecontrol/monitoring-instances/deployment/powershell_servicecontrol_4.md) - [Deploying ServiceControl Monitoring instances using PowerShell (servicecontrol_5)](https://docs.particular.net/servicecontrol/monitoring-instances/deployment/powershell_servicecontrol_5.md) - [Managing ServiceControl RavenDB instances via Containers (servicecontrol_5)](https://docs.particular.net/servicecontrol/ravendb/containers_servicecontrol_5.md) (supported: [5.0.0, )) - [Error Instance Configuration Settings (servicecontrol_4)](https://docs.particular.net/servicecontrol/servicecontrol-instances/configuration_servicecontrol_4.md): Categorized list of ServiceControl Error instance configuration settings. - [Error Instance Configuration Settings (servicecontrol_5)](https://docs.particular.net/servicecontrol/servicecontrol-instances/configuration_servicecontrol_5.md): Categorized list of ServiceControl Error instance configuration settings. - [ServiceControl Error instances deployment options (servicecontrol_4)](https://docs.particular.net/servicecontrol/servicecontrol-instances/deployment/index_servicecontrol_4.md): Learn about the deployment options for ServiceControl Error instances. Recommendations for setting up ServiceControl instances on production systems. - [ServiceControl Error instances deployment options (servicecontrol_5)](https://docs.particular.net/servicecontrol/servicecontrol-instances/deployment/index_servicecontrol_5.md): Learn about the deployment options for ServiceControl Error instances. Recommendations for setting up ServiceControl instances on production systems. - [Deploying ServiceControl Error instances using PowerShell (servicecontrol_4)](https://docs.particular.net/servicecontrol/servicecontrol-instances/deployment/powershell_servicecontrol_4.md): A guide to setting up and deploying ServiceControl Error instances using PowerShell. Prerequisites, installation and deployment. - [Deploying ServiceControl Error instances using PowerShell (servicecontrol_5)](https://docs.particular.net/servicecontrol/servicecontrol-instances/deployment/powershell_servicecontrol_5.md): A guide to setting up and deploying ServiceControl Error instances using PowerShell. Prerequisites, installation and deployment. - [Deploying Error instances using ServiceControl Management (servicecontrol_4)](https://docs.particular.net/servicecontrol/servicecontrol-instances/deployment/scmu_servicecontrol_4.md): A guide to using ServiceControl Management Utility to set up ServiceControl instances. Information about installing and upgrading ServiceControl instances. - [Deploying Error instances using ServiceControl Management (servicecontrol_5)](https://docs.particular.net/servicecontrol/servicecontrol-instances/deployment/scmu_servicecontrol_5.md): A guide to using ServiceControl Management Utility to set up ServiceControl instances. Information about installing and upgrading ServiceControl instances. - [ServiceControl Hardware Considerations (servicecontrol_4)](https://docs.particular.net/servicecontrol/servicecontrol-instances/hardware_servicecontrol_4.md): Hardware recommendations for running ServiceControl instances. - [ServiceControl Hardware Considerations (servicecontrol_5)](https://docs.particular.net/servicecontrol/servicecontrol-instances/hardware_servicecontrol_5.md): Hardware recommendations for running ServiceControl instances. - [ServiceControl remote instances (servicecontrol_4)](https://docs.particular.net/servicecontrol/servicecontrol-instances/remotes_servicecontrol_4.md): Aggregate data from other ServiceControl instances using the ServiceControl Remotes feature. - [ServiceControl remote instances (servicecontrol_5)](https://docs.particular.net/servicecontrol/servicecontrol-instances/remotes_servicecontrol_5.md): Aggregate data from other ServiceControl instances using the ServiceControl Remotes feature. - [ServiceControl Troubleshooting (servicecontrol_4)](https://docs.particular.net/servicecontrol/troubleshooting_servicecontrol_4.md): Troubleshooting ServiceControl installation and common issues. - [ServiceControl Troubleshooting (servicecontrol_5)](https://docs.particular.net/servicecontrol/troubleshooting_servicecontrol_5.md): Troubleshooting ServiceControl installation and common issues. ## Components (NuGet packages) - [ServiceControl](https://www.nuget.org/packages/ServiceControl) - ServiceControl - [ServiceControl.Contracts](https://www.nuget.org/packages/ServiceControl.Contracts) - ServiceControl Contracts - [ServiceControl.TransportAdapter](https://www.nuget.org/packages/ServiceControl.TransportAdapter) - ServiceControl Transport Adapter