Linux Setup Guide

In slideshow mode, use arrow keys or the navigation buttons at lower right of screen to move forward/back.

This guide will assist you getting ProfitTrailer running on an Ubuntu Server.
The process will be roughly the same for other Linux versions.


  • Connect to Linux
  • Installing Java (and other things)
  • Downloading ProfitTrailer
  • Mandatory Settings
  • Running ProfitTrailer
  • Setup a Second Bot

Getting Started with ProfitTrailer on Linux

First of all, note that running the bot 24/7 is not possible if you allow your PC to fall asleep or close a laptop as the bot will not run anymore. You may want to consider using a VPS before installing it on a dedicated computer.

1.Connect to Linux

We need some software to connect from your home computer to the linux server.
Use anything you are comfortable with however we suggest you download:

In this guide we will use WinSCP. WinSCP allows you to connect to the server, FTP files, edit files and has PuTTY integrated into the app. So in english it can move files, edit files and also connect to the terminal in one nice little free app.

Your VPS provider will have given you access information: an IP Address, username and password. In our example, Westhost gave us root user, which is fine. Use this info to open a terminal window to your new VPS. Here we open WinSCP and set up a new connection.

Enter the Hostname (IP address), User name (root) and Password and click login. You may need to allow the connection and will be able to chose a name to save the connection as for future use.

In WinSCP, click the terminal icon in the menu bar to get to a terminal:

We are now connected to the server.

2. Installing Java (and other things)

We need to make a directory for ProfitTrailer. Use the cd command to change to the root directory of your choice. I like to drop my bots into the /var/opt folder

Enter the following commands one line at a time:

cd ..
cd /var/opt
mkdir pt
cd pt

You should now be inside a folder called pt in your /var/opt path
The prompt will look similar to this:

Run an update:

sudo apt-get update

Install Java 8:

sudo apt-get install openjdk-8-jdk

Be advised: You need JAVA 8. Version 9 or 10 are not supported.

Install Nodejs and create a symlink from the /nodejs to /node folder:

curl -sL | sudo -E bash -
sudo apt-get install -y nodejs

sudo ln -s /usr/bin/nodejs /usr/bin/node
[this is optional and may not be needed]

Recently new installs have had issues with pm2 not starting correctly. Update Node using the previous commands if you have issues

Install npm and use npm to install pm2:
npm may already be installed and if so you will receive dependencies errors. skip to pm2 install:

sudo apt-get install npm
sudo npm install pm2@latest -g

pm2 is a process manager – it lets you run the bot in the background, and has features to autostart, log-rotation and much more. You do not HAVE to use pm2, but we like it, especially from running multiple bots.

At this point you have all the apps and tools you need to run the Profit Trailer.

  • Java to run the jar
  • Nodejs to run pm2
  • Pm2 to manage your bot process, log windows and logs

Type pm2 at your prompt and you should get a list of pm2 commands. This will verify everything is running as expected.

3. Downloading ProfitTrailer

I like to download the bot to my local machine, edit the configs and then upload everything to the VPS at one time. I’ll show you how I do that. If you are familiar with Linux, you can certainly download and unzip the bot directly to your working folder.

Go to this link:
Download the latest release.
Right click on the zip and select Extract All.

Choose a location to extract to, for example on the desktop.

You should have something similar to:

4. Configuring ProfitTrailer

Open WinSCP, and connect to your VPS if not already.
Select the “Open directory/bookmark” icon and type in /var/opt/pt

This should bring you to your pt folder:

In the left hand window of WinSCP, find your new PT folder, the one you just unzipped from the download.
Things should look like this:

Simply select and drag all of the files from the left window to the right window.

You now have the PT files on your VPS, and are ready to start editing configs.
You can double-click on a file in WinSCP to edit that file (left and right panels). The bot will be using the files on the right panel, in the /var/opt/pt folder.

At this point, you can minimize WinSCP and go back to your terminal window (or click on the terminal icon to connect again)

5. Mandatory Settings

Now we can proceed to setup the Mandatory Settings before attempting to run the bot.

  • This guide only includes an example application properties file, so please check the other parts of the wiki for settings, before you go ahead and run the bot on random settings without knowing what they do.

Application Properties Video Guide

6. Running ProfitTrailer

Now for the fun part. To run your bot, you first navigate to your pt folder

cd /var/opt/pt

Change the permission on the JAR file so it will execute correctly

chmod +x ProfitTrailer.jar

Start the bot using pm2:

pm2 start pm2-ProfitTrailer.json

At this point, the bot is running. To see the live log scrolling by, type pm2 log 0. You use CTRL-C to get out of the window.

pm2 log 0         	See log live
pm2 stop 0       	Stop the bot
pm2 reload 0   	reload and restart the bot

Text logs are maintained by pm2 and are located at /root/.pm2/ (for my root account access)

Run a save and startup command. After this is complete, PM2 will restart your bot if you restart the server. Run this command again if you change your app, or add a second bot.

pm2 save
pm2 startup

To run Profit Trailer without Pm2 you can still execute the same java command as any other operating system.

java -Dsun.stdout.encoding=UTF-8 -Dio.netty.allocator.numDirectArenas=0 -Djdk.nio.maxCachedBufferSize=262144 -XX:+UseSerialGC -XX:+UseStringDeduplication -Xms64m -Xmx512m -XX:CompressedClassSpaceSize=300m -XX:MaxMetaspaceSize=128m -jar ProfitTrailer.jar

Your ProfitTrailer bot is now up and running. Congratulations!
Now go to http://localhost:8081 if it did not open automatically. (adjust port if you have used a different one)

When you open the GUI for the first time you will be asked to set a password. You will also need to enter your default_api_key to confirm you are the owner.

If successful you will then be asked to Login.

Finally you will be see the Config Load screen.

  • Public - Choose from our database of public configs and copy it to your bot giving it a unique name.
  • Saved - Choose from one of your own configs that you have already created in the past.

7. Setup a Second bot

Time to go bigger? Running a second bot is fairly straightforward.

Make a second folder in your /var/opt/ folder, maybe pt2


Upload a copy of your Profit Bot to this folder.

Edit the file and change the port number - I increment them by 1
(If these variables do not exist, add them)
In /var/opt/pt/

server.port = 8081

In /var/op/pt2/

server.port = 8082

8. Running the second instance with pm2

You will need to edit /var/opt/pt/pm2-start.json in order to change the Application name. Pm2 requires unique application names. I like to edit all of my start jsons to be descriptive of the bot:

Just start the second bot the same way you started the first.
Navigate to the 2nd bot folder in the command line, then type:
pm2 start pm2-ProfitTrailer.json
This will display PT Polo as the app name in the pm2 list.

This concludes the ProfitTrailer Linux Setup Guide