Installing Joget as a Linux Service

Setting up Joget as a service allows you to run it continuously in the background, meaning it will always be available without manually opening the application. Ensures quick and reliable access to your Joget application, enhancing the user experience.

Create a Linux service

Before creating a service for Linux, please ensure that the Joget installation is fully completed as described in the following documentation: Installation on Linux

During the installation, make sure to note down the Joget extracted directory path and the JRE installation path for reference.

1. Ensure that the Joget installation directory has sufficient permissions for the currently logged-in user. If the permissions are insufficient, update the directory ownership to the active user by executing the following command:
   

   chown -R joget:joget /opt/joget-enterprise-linux-8.2.5

   Replace joget:joget with your actual username and group.
   This ensures that the Joget application has the necessary permissions to access and modify its files.
   
2. Configure Joget as a systemd service by creating a new service file named joget8.service under the /etc/systemd/system/ directory.
   Run the following command to open the file for editing:
   

   sudo nano /etc/systemd/system/joget8.service

   This service file will define how Joget starts, stops, and runs automatically as a background service on your system.
   

   [Unit]
   Description=Joget DX 8
   After=syslog.target network.target
   
   [Service]
   Type=forking
   WorkingDirectory=/opt/joget-enterprise-linux-8.2.5
   TimeoutStartSec=300
   TimeoutStopSec=300
   
   RemainAfterExit=yes
   
   User=joget
   Group=joget
   
   Environment="JOGET_HOME=/opt/joget-enterprise-linux-8.2.5"
   Environment="JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64"
   Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom -Xmx768M -Dfile.encoding=UTF-8 -Dwflow.home=/opt/joget-enterprise-linux-8.2.5/wflow/ -javaagent:/opt/joget-enterprise-linux-8.2.5/wflow/wflow-cluster.jar -javaagent:/opt/joget-enterprise-linux-8.2.5/wflow/aspectjweaver-1.9.22.jar -javaagent:/opt/joget-enterprise-linux-8.2.5/wflow/glowroot/glowroot.jar"
   Environment="CATALINA_BASE=/opt/joget-enterprise-linux-8.2.5/apache-tomcat-9.0.108"
   Environment="CATALINA_HOME=/opt/joget-enterprise-linux-8.2.5/apache-tomcat-9.0.108"
   Environment="CATALINA_PID=/opt/joget-enterprise-linux-8.2.5/apache-tomcat-9.0.108/temp/tomcat.pid"
   
   ExecStart=/opt/joget-enterprise-linux-8.2.5/apache-tomcat-9.0.108/bin/startup.sh
   ExecStop=/opt/joget-enterprise-linux-8.2.5/apache-tomcat-9.0.108/bin/shutdown.sh
   
   RestartSec=10
   Restart=always
   
   [Install]
   WantedBy=multi-user.target

   • Update the user and group values in the service file to match your currently logged-in user.
   • Modify the JAVA_HOME value if it differs from the path noted earlier during the JRE installation.
   • Ensure all file paths in the configuration correspond to your extracted Joget directory.
3. After creating the Joget service file, reload the systemd daemon to recognize the new service configuration. Run the following command. This step ensures that systemd updates its configuration and includes the newly created joget8.service file:
   

   sudo systemctl daemon-reload

4. After configuring the service, start the Joget DX 8 service by running the following command:
   

   sudo systemctl start joget8

5. After starting the service, check its current status to ensure it is running correctly:
   

   sudo systemctl status joget8

   

6. Once the Joget DX 8 service is running, open a web browser and navigate to the Joget application using your host and port. Replace <your-host-name> with the actual hostname or IP address of your server:
   

   <your-host-name>:8080/jw

Enable Joget DX 8 Service at Startup

To configure Joget DX 8 to start automatically on system boot, run the following command:

sudo systemctl enable joget8

This command will display an output similar to the one shown in the screenshot below.