Company Size:
 
Region:

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. Install the package:
    apt-get install /var/cache/apt/archives/<TimeTrex_Package>.deb
  4. During the installation you will be prompted to configure a database that TimeTrex will use, choose Yes.
  5. 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
  6. Follow the on screen instructions that will walk you through the installation wizard.

Installing TimeTrex from the .ZIP file:

  1. Install the prerequisite packages:
    apt-get install apache2 libapache2-mod-php php php7.0-cgi php7.0-cli php7.0-pgsql php7.0-pspell php7.0-gd php7.0-gettext php7.0-imap php7.0-intl php7.0-json php7.0-soap php7.0-zip php7.0-mcrypt php7.0-curl php7.0-ldap php7.0-xml php7.0-xsl php7.0-mbstring php7.0-bcmath php7.0-process 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 /var/log/timetrex
    chgrp -R www-data /var/timetrex/
    chmod 775 -R /var/timetrex
    chgrp www-data /var/log/timetrex/
    chmod 775 /var/log/timetrex
  7. Give Apache access to the timetrex web directory:
    chgrp www-data -R /var/www/html/timetrex/
  8. 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
  9. 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
  10. Follow the on screen instructions that will walk you through the installation wizard.

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