Installing TimeTrex on Linux

TimeTrex can be installed on Ubuntu / Debian Linux
using either a .DEB or .ZIP file.

Installing TimeTrex from the .DEB file:

1. Download the TimeTrex .deb package to your computer.
2. Move the package into the apt archives directory:
   

   mv <TimeTrex_Package>.deb /var/cache/apt/archives/<TimeTrex_Package>.deb

3. If using Ubuntu, ensure that you have the universe repository included, by running:
   

   add-apt-repository universe

4. Install the package:
   

   apt-get install /var/cache/apt/archives/<TimeTrex_Package>.deb

5. During the installation you will be prompted to configure a database that TimeTrex will use, choose Yes.
6. Point your web browser to the TimeTrex web-based installer:
   http://<web server address>/<timetrex directory>/interface/install/install.php
   ie: http://www.my-company.com/timetrex/interface/install/install.php
7. Follow the on screen instructions that will walk you through the installation wizard.

Installing TimeTrex from the .ZIP file:

1. Install the prerequisite packages:
   If using Ubuntu, ensure that you have the universe repository included, by running:
   

   add-apt-repository universe

   Ubuntu 22.04 [Jammy] / Debian 12 [Bookworm]:
   

   apt-get install unzip apache2 libapache2-mod-php php php8.1-cgi php8.1-cli php8.1-pgsql php8.1-pspell php8.1-gd php8.1-gettext php8.1-imap php8.1-intl php8.1-json php8.1-soap php8.1-zip php8.1-curl php8.1-ldap php8.1-xml php8.1-xsl php8.1-mbstring php8.1-bcmath postgresql

2. Restart Apache after all packages are installed:
   

   service apache2 restart

3. Download the TimeTrex .ZIP file to your computer.
4. Unzip the TimeTrex .ZIP file to the root web directory:
   

   unzip <TimeTrex-installer>.zip -d /var/www/html/

   Rename the unzipped directory:
   

   mv /var/www/html/TimeTrex_v<version>/ /var/www/html/timetrex

5. Rename the TimeTrex.ini.php file:
   

   mv /var/www/html/timetrex/timetrex.ini.php-example_linux /var/www/html/timetrex/timetrex.ini.php

6. Edit the timetrex.ini.php and confirm all paths are correct:
   

   nano /var/www/html/timetrex/timetrex.ini.php

   Note: Make sure the log directory and storage paths are created and that Apache can write to them.
   
   If you are using the default directories you can use these commands:
   

   mkdir -p /var/timetrex/storage
   mkdir -p /var/log/timetrex
   chgrp -R www-data /var/timetrex/
   chmod 775 -R /var/timetrex
   chgrp www-data -R /var/log/timetrex/
   chmod 775 -R /var/log/timetrex
   chgrp www-data -R /var/www/html/timetrex/
   chmod 775 -R /var/www/html/timetrex/

7. Create a user and database for TimeTrex to use:
   

   sudo su postgres
   psql
   CREATE USER timetrex WITH CREATEDB CREATEROLE LOGIN PASSWORD 'password_here';
   CREATE DATABASE timetrex;
   \q

8. Point your web browser to the TimeTrex web-based installer:
   http://<web server address>/<timetrex directory>/interface/install/install.php
   ie: http://www.my-company.com/timetrex/interface/install/install.php
9. Follow the on screen instructions that will walk you through the installation wizard.
*NOTE: On the "Database Configuration" step you will need to enter the above created password for the database in the "Database Password" field.