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. If you want to use it with Apache HTTP server, you need to configure HTTP forwarding. When you run youtrack-xx.jar, you should specify HTTP port in the command line. To allow users access your YouTrack instance via your Apache web server, you need to forward this port to the web server via mod_proxy connector.

Jetty supports not only mod_proxy but also mode_jk connector to use AJP protocol. However, using the mod_jk is not recommended by Jetty developers.

Official Jetty site provides extensive documentation about configuring and using Jetty with Apache Web Server via connectors.
Please refer to the corresponding section for details:

When you configured the HTTP forwarding, just start YouTrack using the following command:

and then start your Web Server.

  • No labels