Hi @nsvsrk,
Here's how you can do it step by step:
Step 1: Prepare Your AEM Quickstart JAR
Make sure your AEM Quickstart JAR file (e.g., aem-author-p4502.jar) is in a clean directory. This JAR file will unpack and create the crx-quickstart folder when first run.
Step 2: Set Your Desired JVM Parameters
You can set JVM parameters like heap size, garbage collector type, or system properties like run modes. These are passed using the CQ_JVM_OPTS environment variable.
Example:
CQ_JVM_OPTS="-Xmx4096m -XX:+UseG1GC -Dsling.run.modes=author"
Step 3: Start the AEM Instance
Use the following command to start AEM, passing in the JVM parameters via CQ_JVM_OPTS:
java $CQ_JVM_OPTS -jar aem-author-p4502.jar
Alternatively, if you want to make things cleaner (especially in scripts), you can export the variable like this:
export CQ_JVM_OPTS="-Xmx4096m -XX:+UseG1GC -Dsling.run.modes=author"
java $CQ_JVM_OPTS -jar aem-author-p4502.jar
Commonly Used JVM Options
Here are a few useful ones you might consider:
-
-Xmx4096m – Set the maximum heap size (4GB in this case)
-
-Xms2048m – Set the initial heap size
-
-XX:+UseG1GC – Use the G1 garbage collector
-
-Dsling.run.modes=author – Run the instance in Author mode
-
-Dorg.osgi.framework.bootdelegation=sun.*,com.sun.* – Sometimes used for classloading tweaks
Example Full Command
export CQ_JVM_OPTS="-Xms2048m -Xmx4096m -XX:+UseG1GC -Dsling.run.modes=author"
java $CQ_JVM_OPTS -jar aem-author-p4502.jar
That’s it! Your AEM Author instance should now start with the custom JVM parameters you’ve defined.
