IMPORTANT: If this is your very first time setting up Cascade CMS, make sure you've imported the default schema for your database vendor according to the corresponding instructions.


  1. Unzip the ZIP file into a new Cascade CMS installation directory. (Note: Leave the current installation directory as is because you'll need to reference files from the existing installation.) 

  2. If using *nix/Linux, set execute permissions on the directory. Ex.: chmod -R u+x cascade-version-linux64

  3. Edit the  (Linux/*nix/Mac OS) or cascade.bat  (Windows) file and replace @{cascadeJRE}  with the absolute path to your Java runtime folder which contains the bin sub-folder.
    - Windows: C:\Program Files\Java\jre1.8.0_91
    - Linux: /usr/local/jdk1.8
    - OS X: /System/Library/Frameworks/JavaVM.framework/Versions/1.8/Home 

  4. Specify the maximum amount of memory available to Cascade in the  and cascade.bat  files by replacing the string @{cascadeMemory}  with a string of the form -Xmx1024M  where 1024  is the size of the memory in megabytes. See the "Requirements" section of the Release Notes for additional information about recommended memory allocation.

  5. Edit tomcat/conf/context.xml
    - Remove the first line containing @{dbConf} .
    - Uncomment the appropriate configuration for your database vendor.
    - Replace the following strings as specified:
      - @{dbusername}  - the username for accessing your database
      - @{dbpassword}  - the password for accessing your database
      - @{dbhostport} - the hostname and port separated by a colon (e.g. localhost:3306)
      - @{dbname}  - the name of the database to use
      - @{dbsid}  - the SID of the Oracle database server, usually orcl (Oracle only)

  6. Edit tomcat/conf/server.xml  and modify the following strings:
    - @{dbschema}  - For Oracle, change it to the schema name of your database. For MySQL and SQL Server, remove the string entirely (e.g. value="" )
    - @{cascadePort} - the HTTP port on which Cascade will run (e.g. 8080 )

Starting Cascade CMS (Linux/*nix, Mac OS)

  • Open a terminal window.

  • Navigate to the Cascade installation directory ( ex. /Applications/Cascade CMS ).

  • Type ./ start .

Starting Cascade CMS (Windows)

The application can be started using one of the following methods (do not use both as that will lead to a port conflict since two instances of the application will be running at the same time):

Windows Service

Assuming that the Windows Service was installed, Cascade CMS can be started using the following steps:

  • Navigate to the Windows Services dialog box.

  • Right-click on the Cascade CMS service.

  • Click Start.

Command Line

  • Open a command prompt.

  • Navigate to the Cascade installation directory ( ex. C:\Program Files\Cascade CMS ).

  • Type cascade.bat start .

Removing the Old Windows Service

As of Cascade CMS 8, the full installer will use a different Windows Service name than previous versions: pre-8.0: Cascade Server and post-8.0: Cascade CMS.

To remove the previously installed Windows Service, see Windows: Add/Removing the Windows Service.

Logging in

Once the application is running, you should be able to access it in your browser by navigating to hostname:8080 (where 'hostname' is the host name of the machine on which Cascade is installed and 8080 is the port selected during the installation).

The default credentials to log in are:
 username: admin
 password: admin

It is recommended that the 'admin' account password is changed to something more secure immediately after logging in for the first time.

Did this answer your question?