Private JVM Tutorial for Linux cPanel

NOTE: This tutorial applies only for our Private JVM tool available for all cPanel Private JVM Linux accounts (does not apply to our Shared JVM Business, or Shared JVM Mocha accounts). The private JVM is also available for our Java VPS + Java cloud packages.

Private JVM tool

You can access your Private JVM tool from your cPanel control panel under the "Mocha Tools" (Paper lantern theme) or "Preference" (x3 theme) section of your cPanel control panel.

1) Installing your Tomcat instance:

In order to deploy your private JVM Tomcat instance, first you need to install an Apache-Tomcat from the left drop-down located inside our Private JVM tool area - then choose Apache-Tomcat version from the right drop-down and click on the INSTALL button.

That will deploy the Tomcat instance in your home directory.

IMPORTANT: Please, double check your Java application requirements for the required JDK and Tomcat versions. You will run into a lot of issues if you are running incorrect JDK/Tomcat version and your application will most likely fail to start.

2) Domain Mappings:

Before your Tomcat can handle your JSP pages and Java applications you need to define which domain names> you want to be processed by the Tomcat application service.

To do this select the desired Domain Name from the drop-down box located under "Map a domain to private JVM". This will create a domain definition inside the server.xml file and will deploy a default application WAR.

For each domain name you are handling there is a docBase Directory located at:


3) Deploy your Application:

There are several ways to deploy your Java application, the most convenient is deploying a WAR file (not supported under our Shared JVM packages). 

IMPORTANT: If you want your application to work at you have to rename your .WAR to ROOT.war and then deploy it. Any other file names will result in your application accessible at

I. Deploying your application via WAR:

* You may deploy your war file through our Private JVM tool. Inside our private JVM tool under "Mapped Domains" go to Upload WAR and follow the instructions.

* You may deploy your war file through your Tomcat management application: Tomcat Manager or Psi Probe.

* You may deploy your war file via FTP. Inside our Private JVM applicationu nder "Mapped Domains" you can see your exact path (/home/yourusername/jvm/apache-tomcat-x.x.xx/domains/ Upload the WAR file in that folder.

II. Deploying the application files directly:

  • You need to upload all of your files via FTP to the path specified in "Mapped Domains". The path needs to be something like: /home/yourusername/jvm/apache-tomcat-x.x.xx/domains/

4) Start your Server:

Now that you have uploaded your application - you are ready to start the application server. All you need to do is just hit the 'Start' button inside your private JVM tool.

NOTE: If your domain name is NOT pointing to our service yet you can use the following method to test your site:

Click on the Preview link in "Mapped domains" section and you will be redirected to our preview tool. Then you need to chose the domain and click on the button.

NOTE: If you are currently using an account that does not come with our private JVM tool, you can easily upgrade to a Private JVM account using our upgrade form located at: