OnTrack is a web application developed for tracking and managing project requirements. In this tutorial, we will guide you on how to install OnTrack on Debian latest version.
Before installing OnTrack, you need to ensure that the following requirements are met:
The first step is to install the dependencies required by OnTrack. Open the terminal and run the following command:
sudo apt update
sudo apt install openjdk-11-jdk postgresql-12 nginx git
This command will install OpenJDK 11, PostgreSQL 12, Nginx, and Git packages.
The next step is to configure PostgreSQL. Start the PostgreSQL service and create a new database and user. Open the terminal and run the following commands:
sudo systemctl start postgresql
sudo -u postgres psql
In the psql console, execute the following commands to create a new database and user:
CREATE DATABASE ontrack;
CREATE USER ontrackuser WITH PASSWORD 'password';
GRANT ALL PRIVILEGES ON DATABASE ontrack TO ontrackuser;
Replace password with a strong password for the OnTrack user.
Clone the OnTrack repository to your server's home directory using the following command:
git clone https://github.com/inoda/ontrack.git
Change the directory to the OnTrack project's root directory, and run the following command to build the project:
./gradlew bootJar
After the build is complete, start the OnTrack application using the following command:
java -Dspring.profiles.active=prod -jar build/libs/ontrack-*.jar
The OnTrack application will start running on port 8080.
Create a new nginx configuration file for OnTrack. Open the terminal and run the following command:
sudo nano /etc/nginx/sites-available/ontrack
Add the following configuration to the file:
server {
listen 80;
server_name your-server-ip-or-domain-name;
location / {
proxy_pass http://localhost:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}
Replace your-server-ip-or-domain-name with your server's IP address or domain name. Save and close the file.
Create a symbolic link to the sites-enabled directory:
sudo ln -s /etc/nginx/sites-available/ontrack /etc/nginx/sites-enabled/
Verify the syntax of the Nginx configuration files and reload the service:
sudo nginx -t
sudo systemctl reload nginx
Open your web browser and navigate to http://your-server-ip-or-domain-name. You will see the OnTrack login screen, use the default credentials - username: admin password: admin.
You have successfully installed OnTrack on Debian Latest. You can now use the application for tracking and managing project requirements.
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!
