Knowledge Base

How to install Joget Workflow on a VPS

This article describes how to install Joget Workflow, a business process management application, on a semi-managed VPS or Cloud VPS.

Joget Workflow requires at least 1 GB of RAM. If your VPS has only 512 MB of RAM, you should upgrade the amount of RAM before you install Joget Workflow.

Installing Joget Workflow

Joget Workflow is a workflow and business process management application that runs on top of Java and Apache Tomcat. The following procedure demonstrates how to install Joget Workflow on Ubuntu 12.04 LTS, though it should run on other versions as well.

Although A2 Hosting servers are compatible with a wide variety of software applications, we cannot provide troubleshooting assistance for application-specific issues.

To install Joget Workflow:

  1. Download the Joget Workflow installation file at http://www.joget.org/download to your computer.
    Make sure you download the v3 Community Edition - Bundle for Linux.
  2. Upload the .tar.gz installation file to the VPS.
  3. Log in to your account using SSH. For information about how to access your account using SSH, please see this article.
  4. Type the following commands to update the system:
    apt-get update
    apt-get upgrade
  5. To install Java, type the following command:

    apt-get install openjdk-6-jdk
  6. To install MySQL, type the following command:

    apt-get install mysql-server
    When you are prompted to do so, set the MySQL root password.
  7. To create a MySQL database for Joget Workflow, start the mysql program. Use the root password that you specified in step 6:

    mysql -u root -p
  8. At the mysql> prompt, type the following command:

    CREATE DATABASE jwdb;
  9. To exit the mysql program, type \q and then press Enter.
  10. To extract the Joget Workflow application files, type the following commands. Replace PATH with the path to the installation file that you uploaded in step 2:

    cd /opt
    tar xvzf /PATH/joget-linux-3.1.1.tar.gz
    The exact filename may differ slightly, depending on the version you downloaded.
  11. Rename the extracted Joget directory in the /opt directory to joget. To do this, type the following command:

    mv joget-linux-3.1.1/ joget
  12. Change to the joget directory:

    cd /opt/joget
  13. Run the setup script:

    ./setup.sh
    To accept the default values, press Enter. (The only value you should have to change is the MySQL password.) When the setup script finishes, you should receive a BUILD SUCCESSFUL message.
  14. Start the Tomcat server:

    ./tomcat6.sh run
  15. Use your web browser to go to http://www.example.com:8080/jw, where example.com represents your domain name.
  16. The Joget Workflow home page appears. From this page, you can access the web console (the default username and password are both admin), try a sample application, and more.

More Information

For more information about Joget Workflow, please visit http://www.joget.org.