Linux 24 Version Installation Guide

Time Champ Installation Guide for Linux 24

This guide provides step-by-step instructions for installing the Time Champ application on Linux 24. Please follow each step carefully to ensure a smooth installation process.

Disable Wayland:

By default, Linux 24 uses Wayland. Therefore, first disable Wayland, and then proceed with the normal installation process.

To disable Wayland, follow this guide:
https://timechamp.freshdesk.com/a/solutions/articles/101000520293

Normal Installation:

1. Log in to your Time Champ account.

2. Click on the "Agent" button to download the installation file and select the OS type as Linux.

   • Please select the Agent type (Interactive/Silent) and download the setup file. Ensure the setup file is saved in the "Downloads" folder on the user's system.

3. Unzip the installation file from the Downloads folder and open it. Then, open the terminal from the path Downloads/Svcvtt or Downloads/Time Champ.

4. Run the following commands for the normal installation:

   chmod 777 timechamp-linux_64bit-setup.bash 
   ./timechamp-linux_64bit-setup.bash
   
   

   OR

   Alternatively, you can run this single command:

   bash timechamp-linux_64bit-setup.bash
   

Chrome-Sandbox Error:

After the normal installation, you may encounter an error related to chrome-sandbox. To check the error, open the nohup file created after installation in the Time Champ folder, or the Svcvtt file for output.

To resolve the chrome-sandbox error, run the following two commands:

sudo chown root /home/snovasys66/.local/share/timechamp/20241001114212/executables/chrome-sandbox 

sudo chmod 4755 /home/snovasys66/.local/share/timechamp/20241001114212/executables/chrome-sandbox

Ensure you replace the path (/home/snovasys66/.local/share/timechamp/20241001114212/executables/chrome-sandbox) with the correct path on the user’s machine for both commands.

Note: You can easily access the correct path from the nohup file, where the path is listed. Copy the path from home to chrome-sandbox.

App Image Not Found:

If you encounter an error in the timechamp.log (located in /home/.local/share/timechamp/timechamp.log) stating that the app image was not found, remove the existing Timechamp-service file (move it to trash) and download it again using the following command:

wget https://customer.sites2.timechamp.io/tracker/linux/timechamp-service

Once it's downloaded, provide the necessary permissions for the file using this command:

chmod 777 timechamp-service

SSL Issue:

After completing the steps above, you may encounter an SSL issue in the timechamp.log. To resolve it, follow the SSL installation guide. Afterward, Time Champ should work properly.

To fix the libssl error, run the following two commands:

wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2_amd64.deb 

sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2_amd64.deb

Note: Please avoid running any commands to download the FUSE installation, as this may cause the OS to crash.

Final Step:

After completing the above process, the application should automatically start after a few seconds. To ensure everything is functioning correctly.