diff --git a/docs/dci-troubleshooting.md b/docs/dci-troubleshooting.md
index c427466..2a85be6 100644
--- a/docs/dci-troubleshooting.md
+++ b/docs/dci-troubleshooting.md
@@ -10,6 +10,16 @@ og_image:  https://docs.datacontroller.io/img/cannotimport.png
 ## Overview
 [Let us know](https://datacontroller.io/contact/) if you experience an installation problem that is not described here!
 
+## max number of active processes has been reached for the user
+
+On Viya versions 2025 or later you may get the following message in the network response:
+
+`Unable to create compute server session. Unable to complete the launch request, max number of active processes has been reached for the user: user=USERNAME limit=10`
+
+This limit should be set to at least 20 or 30 due to the way the [sasjs/adapter](https://github.com/sasjs/adapter) works (by prelaunching sessions to improve responsiveness).
+
+A guide for making the configuration change is available [here](https://communities.sas.com/t5/SAS-Communities-Library/Limit-a-user-s-simultaneous-compute-server-processes-in-SAS-Viya/ta-p/761820).
+
 ## Internet Explorer - blank screen
 If you have an older, or 'locked down' version of Internet Explorer you may get a blank / white screen when navigating to the Data Controller url.  To fix this, click settings (cog icon in top right), *Compatibility View settings*, and **uncheck** *Display intranet sites in Compatibility view* as follows:
 ![menu](img/dci-trouble1.png)