Check YouTrack Supported Environments page for supported servlet containers.
The general idea of using WAR distribution within a servlet container and Apache Web server is quite simple:
- Deploy youtrack-xx.war in your servlet container.
- Set up YouTrack in a servlet container (configure ports, connectors, etc.)
- Connect servlet container and Apache Web Server: set a port Apache should listen to for allowing users to access YouTrack, set up connectors, etc.
These general steps will vary depending your servlet container specifics. Please refer to your container documentation for details.
For details and specifics of using and configuring Apache Web Server, please refer to its documentation space.
In the next section, we provide a sample simplified procedure of configuring and running YouTrack within Tomcat servlet container and Apache HTTP Server.
To configure running YouTrack within Tomcat and Apache HTTP Server:
- Deploy youtrack-xx.war in Tomcat servlet container:
- If you run Tomcat (e.g. as a Windows service), stop Tomcat instance before deploying YouTrack.
- Save youtrack-xx.war in the $TOMCAT_HOME$/webapps directory. Rename youtrack-xx.war file as required before deploying. In the further examples we assume that the YouTrack servlet name is set to youtrack.war.
- Start Apache Tomcat and check whether YouTrack is set up correctly and is available (in a web browser navigate to http://yourserver:<Tomcat port>/youtrack).
- To connect Tomcat with a web server (in our particular case with Apache HTTP Server), install and configure mod_jk Tomcat connector. Apache provide detailed How-Tos for different web servers. Please refer to The Apache Tomcat Connector - Apache HowTo for detailed description of configuring connectors between Apache HTTP server and Tomcat.
When done, you should be able to access YouTrack via your company'e web server at, e.g. http://yourcompanyname.com/youtrack address.