You are viewing documentation for the older version of YouTrack!

Skip to end of metadata
Go to start of metadata


  • To run YouTrack Standalone via JAR distribution file, you need to have Java JDK 1.5 and higher.
  • YouTrack requires at least 512Mb of JVM heap memory. You can set the size of heap memory via -Xmx parameter when starting youtrack-xx.jar from the command line.
    Otherwise, set the system default JVM heap size. As the YouTrack database grows you should increase the JVM memory size.
  • In order to open graphic attachments and render image thumbnails correctly, it is required to use Java in Headless Mode. To enable Java Headless Mode, you can use -Djava.awt.headless=true parameter in the command line, when starting YouTrack, or set java.awt.headless system property. For more information about Java Headless Mode please refer to the Using Headless Mode in the Java SE Platform article on Java official web-site.

Considering the above mentioned requirements, you can run YouTrack with the following command:

YouTrack Standalone JAR distribution bundles Jetty 6.1.x Servlet container.

Generally there is no need in web server, you can run JAR as a java standalone process without using web server.

However, if you need to connect Jetty and Apache Web Server, you will have to use Apache server with connectors: mod_proxy, or mode_jk.
Official Jetty site, contains extensive documentation about configuring and using Jetty with Apache Web Server via connectors.
Please refer to the corresponding section for details:

When you configured Jetty to Apache Web Server connection, start YouTrack with the following command:

and then start your Apache Web Server.