OnTrack is an open-source, web-based project management and bug tracking tool. It uses the Symfony PHP framework and is available on GitHub. This tutorial will guide you through the steps required to install OnTrack on POP! OS, the popular Linux distribution.
Before proceeding with the installation, you will need the following:
OnTrack requires several PHP extensions and libraries to work correctly. To install them, open a terminal window and run the following command:
sudo apt install php php-gd php-json php-mbstring php-xml curl git unzip
This command will install PHP, the required PHP extensions, and some additional tools necessary to download and extract OnTrack from GitHub.
Composer is a dependency manager for PHP. It is required to install OnTrack, and you can install it by running the following command:
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
This command will download and install Composer globally on your system.
To download OnTrack, you need to clone its GitHub repository using Git. First, navigate to the directory where OnTrack will be installed. You can use the following command to create a new directory:
sudo mkdir /var/www/ontrack
Then, navigate to the new directory and clone the OnTrack repository:
cd /var/www/ontrack
sudo git clone https://github.com/inoda/ontrack.git .
OnTrack requires several dependencies that need to be installed using Composer. Navigate to the directory where OnTrack was cloned and run the following command:
sudo composer install
This command will download and install all the required dependencies for OnTrack.
OnTrack requires a database to store project and bug tracking data. You can use any database supported by Doctrine, such as MySQL, PostgreSQL, or SQLite. This tutorial will use SQLite, which does not require any additional configuration.
Navigate to the app directory and create the database:
cd /var/www/ontrack/app
sudo php bin/console doctrine:database:create
This command will create a new SQLite database file in the var directory.
To install OnTrack, run the following command:
sudo php bin/console ontrack:install
This command will create the necessary database tables, initialize the default user account, and configure the application.
OnTrack is now installed, but you need to configure your web server to serve the application.
If you are using Apache as your web server, you can use the following virtual host configuration:
<VirtualHost *:80>
ServerName yourdomain.com
DocumentRoot /var/www/ontrack/public
<Directory /var/www/ontrack/public>
AllowOverride None
Order Allow,Deny
Allow from All
<IfModule mod_rewrite.c>
Options -MultiViews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
</Directory>
ErrorLog ${APACHE_LOG_DIR}/ontrack_error.log
CustomLog ${APACHE_LOG_DIR}/ontrack_access.log combined
</VirtualHost>
If you are using Nginx as your web server, you can use the following server block configuration:
server {
listen 80;
server_name yourdomain.com;
root /var/www/ontrack/public;
index index.php;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php7.4-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
Your installation of OnTrack should now be accessible from a web browser. Navigate to http://yourdomain.com to access the application. You can log in using the default user account:
admin@example.compasswordCongratulations! You have successfully installed OnTrack on POP! OS Latest. You can now use the application to manage your projects and track bugs. For more information on how to use OnTrack, refer to the official documentation on GitHub.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
Alternatively, for the best virtual desktop, try Shells!
