How to Increase Memory for TripleA

[LaFayette]

Set maximum RAM

(Valid for TripleA v1.9.0.0.5401+)
It may happen that your TripleA client exits with an OutOfMemoryError, even if your PC has more RAM to offer.<br>
In this case you might want to increase the usable amount of RAM for your installation of TripleA.<br>
There are multiple ways to achieve this, and they all depend on the way your version of TripleA has been installed on your computer.

<br>
<amount> is the amount of memory you want to assign to TripleA.<br>
1 means 1 byte, 1K 1024 bytes, 1M 1024 kilobytes, 1G 1024 megabytes and so on.<br>
The default value TripleA uses is 2G.<br><br>

• Installer
  • Temporary:
    1. Open the commandline/terminal
    2. Enter /path/to/triplea -J-Xmx<amount>
  • Permanent:
    1. Go to your TripleA installation directory.
    2. Open the TripleA.vmoptions file.
    3. Change the -Xmx<amount> to an appropriate value
    4. Start TripleA
• Jar file
  • Temporary:
    1. Open the commandline/terminal
    2. Enter java -Xmx<amount> -jar /path/to/the/triplea.jar
  • Permanent:
    • On Windows
      1. Create a text file called something.bat
      2. Insert java -Xmx<amount> -jar /path/to/the/triplea.jar and save the file.
      3. Start this batch file instead of the triplea jar in the future.
  • On Unix (macOS/Linux)
    1. Create a text file called something
    2. Insert java -Xmx<amount> -jar /path/to/the/triplea.jar and save the file.
    3. Mark the file as executable using chmod +x /path/to/your/file
    4. Start this script file instead of the triplea jar in the future.

[General_Zod]

@lafayette

Thanks for the info.

I just wanted to add 1 small point and correct me if I'm wrong.

That the 2 methods listed are specific to a given version of Triple A. Meaning if you upgrade your Triple A, you will need to repeat the steps if the path is different and or if a new TripleA.vmoptions file is added.

Also where does the .bat file have to be located?

[redrum]

@general_zod I believe that is correct. I think we'd need to not overwrite the vmoptions file when a user chooses the upgrade existing installation option in order to not have to reset that every time you upgrade.

[Cernel]

@lafayette Please update for the new default of 2G (I don't know if any other changes).

[RoiEX]

@Cernel I updated it