Upgrading from Version 1.x to Version 2

Version 2 is a major update. We have added new strategies. Reworked the GUI, updated the trade logic and added, removed or changed almost all of the parameters from version 1.

It is critical that you do not just copy and paste your properties files. Use the version 2 properties files and add the appropriate information into the new templates.

For most users we expect this swap could take 30 minutes to 1 hour. Do not rush it. Following these instructions will minimise the time your bot is stopped and not trading.

1. We have done everything we can think of to give version 2 backwards compatibility with your sales and DCA data. Upgrading from Version 1.x correctly should result in all data being carried forward. Make a backup of everything just in case (the complete folder).
Take screenshots or make notes of average prices and DCA levels also.

2. Download the latest version of ProfitTrailer and extract the files to a seperate location to your version 1 bot. (ProfitTrailer V2 for example)

3. open application.properties in the version 2 folder and copy the following information from from your version 1 bot. Many of these parameters are renamed so do not copy the entire parameter, copy only whats after each = sign.

  • License (your Profit Trailer License - not found in the v1 file but used for v2, find this in your original purchase email)
  • Port (if different)
  • Exchange
  • Sitename (not present by default, add it as server.sitename if you do use it)
  • Timezone offset
  • Log history days
  • Both sets of API Keys (Do not copy the key settings names, only the keys)
  • Telegram token and chat ID

4. You can now configure the rest of the settings using application.properties as a guide. Several parameters have been removed or renamed, so don't attempt to copy them from your version 1 bot. New features include:

  • Discord notifications
  • Themes
  • Language
  • Currency

Save and close the application.properties file.

5. Configuring the PAIRS, DCA and INDICATORS files will be the most time consuming step of the upgrade.

Note the new file structure. No more trading folder. Just the initialization folder containing the three properties files.

To assist in this process you may wish to use this optional html script to convert your version 1 files to version 2 and add some new parameters. This script will convert only the parameters contained in the files you give to it, mistakes and all. Commented lines will be preserved. Go to http://wiki.profittrailer.com/converter, copy and paste your v1 properties files into the left side of the page and see the converted file on the right.

Afterwards we still recommend to go through everything yourself and ensure it is configured correctly.

Open pairs.properties, dca.properties and indicators.properties in the version 2 /initialization folder. These files have major changes and you will need to go through each respective wiki page carefully in order to translate your old settings into the new format.

If you wish, you can skip this step and after running the bot (step 9) use the GUI to set these files up. After first boot the only way to edit the files will be using the GUI. Regardless these three wiki pages are your guide for successfully configuring the trading files:

There is also lots of information in the change log on GitHub and the wiki What Has Changed page.

6. Once all files are configured to your satisfaction ensure the three trading files are inside the ProfitTrailer V2/initialization folder. On first boot-up these files will be read by the bot, uploaded to the PT servers and encrypted for storage locally or on our servers according to your settings.

7. Stop the version 1 bot by going to http://localhost:8081/stop, pressing the red button in the GUI or pressing ctrl + c (Windows, Linux, MacOS) in the console

8. Copy the following files from the Version 1 bot into the version 2 bot folder keeping the file structure the same

  • ProfitTrailerData.json (sales and DCA data)
  • ProfitTrailer.log (log history, if you don't care about this then there is no need to copy it)
  • ptpw (password file), if you upgrade from a version older than V this file will not exist yet.

9. Run the Version 2 bot (DEFAULT_trading_enabled = false, start_trading_delay or test_moderecommended) using the same method you used previously: See the Windows, Mac guides if you can't remember. PM2 users, such as Linux or RasPi may need to reconfigure their commands to work on the new bot folder. If your bot starts up with the old settings or says version 1 still, it's likely that PM2 is configured to point at the old directory still. You can verify this by running pm2 show 0 and possibly pm2 show 1, and checking the exec cwd folder values.

The console/terminal will instruct the user to complete setup using the web interface.

Now go to http://localhost:8081 if it did not open automatically. (adjust port if you have used a different one)

Users that did not copy the ptpw file over (or upgraded from versions prior to will be prompted to set a password (was set in application.properties in older V1 versions) unless you have disabled the password function.

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 presented with the Config Load screen. Enter a unique name for your configuration and load the settings from within the initialization folder.

10. After the bot has loaded the PAIRS, DCA and INDICATORS files editing these files does not effect changes like it did with version 1. Changes need to be made in the GUI itself.

The files should be removed from the initialization folder, and placed elsewhere as an unencrypted backup if you wish.

11. Things to note:

  • Testmode won't display your existing coins or balance. It uses start balance.
  • to display your existing coins when trading is disabled you need to check hidden_pairs

12. Check the DCA values shown in Version 2 and compare them with your notes/screenshots you took in Step 1.

13. Once setup is complete and you see no errors in the console you can switch to Live trading by updating the following as appropriate.

  • upgrade_instructions2.txt
  • Last modified: 5 months ago
  • by sgtbatten