How to install Joget Workflow

This article describes how to install Joget Workflow, a business process management application, on an unmanaged VPS.

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.

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.