
# Modifying the Thread Stack Size

> This article contains steps for configuring the Thread Stack Size for the application.

URL: https://www.hannonhill.com/cascadecms/latest/articles/cascade-administration/installation-and-upgrades/system-configuration/modify-thread-stack.html
category: Cascade Administration
article-type: how-to
content-kind: article
release-availability: all
tags: installation
updated: 2026-10-06

> **Warning**
>
> Do not change this parameter unless instructed to do so by Hannon Hill Product Support.

> **Note**
>
> The default thread stack size is **1M**.

## Linux/*nix

1. Stop Cascade CMS.
1. Edit the *cascade.sh* file (found in the Cascade CMS installation directory).
1. Add/Modify the `-Xss` parameter in `JAVA_OPTS`. For example, the following sets the thread stack size to **4M**:  ` export JAVA_OPTS="-Xss4M -Xmx1024M -XX:MaxPermSize=256m -Djava.awt.headless=true -Dfile.encoding=UTF-8"`
1. Restart Cascade CMS.

## Windows (service)

1. Using Windows Explorer, navigate into the *tomcat\bin* folder.
1. Right-click on the *CascadeCMSw.exe* file and select **Run as Administrator**.
1. In the Cascade CMS Properties UI, click on the **Java** tab.
1. In the **Thread stack size** field, enter a value (4000 KB, for example).
1. Click **Apply**/**OK**.
1. Restart the Cascade CMS service.

## Windows (command line)

1. Stop Cascade CMS.
1. Edit the *cascade.bat* file (found in the Cascade CMS installation directory).
1. Add/Modify the `-Xss` parameter in `JAVA_OPTS`. For example, the following sets the thread stack size to **4M**:  ` set JAVA_OPTS="-Xss4M -Xmx1024M -XX:MaxPermSize=256m -Djava.awt.headless=true -Dfile.encoding=UTF-8"`
1. Restart Cascade CMS.
