Linux 24 Version Installation Guide

Created by Bharadwaj daggumati, Modified on Tue, 29 Oct at 12:41 PM by Bharadwaj daggumati

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.

Step 1: Download the Time Champ Setup File

Visit the Time Champ website and download the Linux setup file for the application.
Save the file in your preferred location (e.g., Downloads folder).

Step 2: Install Required Libraries

Open the terminal in your home directory.

Install the libfuse package by running the following 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

Step 3: Extract and Prepare Time Champ Files

Once libfuse is installed, extract the downloaded Time Champ ZIP file.
Move the extracted folder to your Downloads directory.
Open a terminal window in the Time Champ folder by navigating to the folder and right-clicking to select “Open Terminal here.”

Step 4: Install the Time Champ Application

In the terminal, run the installation command provided in the installation documentation or as per instructions on the Time Champ website.
```
Run the following commands in Terminal 
bash timechamp-linux_64bit-setup.bash
```

Step 5: Verify Installation

Once the installation is completed, open the output.txt file in the Time Champ folder.
Check for any errors or issues that may be indicated in the file.
If issues appear, refer to the scenarios below for troubleshooting.

Troubleshooting Common Installation Issues

Issue 1: Wayland Compatibility

Linux 24 uses Wayland by default, which may conflict with Time Champ.
Disable Wayland before continuing with the installation process. Instructions to disable Wayland vary, so consult your Linux documentation.

Issue 2: Chrome-Sandbox Error

If you encounter a Chrome-Sandboxerror, follow these steps to resolve it:

bash
Copy code
sudo chown root /path/to/timechamp/executables/chrome-sandbox sudo chmod 4755 /path/to/timechamp/executables/chrome-sandbox

Note: Replace /path/to/timechamp/ with the correct path on your system.

Issue 3: Missing App Image Error

If an error in timechamp.logshows "App Image Not Found," you need to reinstall the Time Champ service file.
1. Remove the existing Timechamp-service file.
2. Download a new service file using the command below:
```
bash
Copy code
wget https://customer.sites2.timechamp.io/tracker/linux/timechamp-service
```

Issue 4: SSL Issues

If you encounter SSL-related errors, follow the SSL installation guide for your distribution.

To address specific libssl errors, run the following commands:

bash
Copy code
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

Important: Do not download any additional FUSE installation files, as this may cause OS issues.

Issue 5: Application Auto-start

After completing all troubleshooting steps, restart both Time Champ and your system.
The application should start automatically if the installation was successful.

Step 6: Verify Application Logs

After setup, navigate to the following directory:
```
HOME --> .local --> share --> time champ
```
Open the timechamp.log file and check for any "App Image Not Found" errors.

Step 7: Resolving "App Image Not Found" Error

If this error persists, remove the current service file from the system.

Download and add a new service file using the command below:

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

Step 8: Run Final Setup Command

After adding the new service file, open the terminal in the Time Champ directory.
Run the following command to finalize the setup:
```
chmod 777 timechamp-service
```

Following these steps will complete the installation process for Time Champ on Linux 24. For further assistance, consult the Time Champ support team