How to Install TimeTrex on Linux

Home / Installation Help

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 18.04 [Bionic] / Debian 10 [Buster]:
    apt-get install unzip apache2 libapache2-mod-php php php7.2-cgi php7.2-cli php7.2-pgsql php7.2-pspell php7.2-gd php7.2-gettext php7.2-imap php7.2-intl php7.2-json php7.2-soap php7.2-zip php7.2-curl php7.2-ldap php7.2-xml php7.2-xsl php7.2-mbstring php7.2-bcmath postgresql
    Ubuntu 20.04 [Focal]:
    apt-get install unzip apache2 libapache2-mod-php php php7.4-cgi php7.4-cli php7.4-pgsql php7.4-pspell php7.4-gd php7.4-gettext php7.4-imap php7.4-intl php7.4-json php7.4-soap php7.4-zip php7.4-curl php7.4-ldap php7.4-xml php7.4-xsl php7.4-mbstring php7.4-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.
  10. *NOTE: On the "Database Configuration" step you will need to enter the above created password for the database in the "Database Password" field.

See the following guides for instructions on installing TimeTrex for other operating systems: