We provide two sample methods you could use as a basis to install and run standalone YouTrack JAR as a service on *nix-like machines:

• Sample of a verified method, which is described on this page, we have used ourselves to run YouTrack JAR
• Sample of an alternative method provided by Alexey Efimov

Sample Installation Procedure to Run YouTrack JAR as a Service on Linux

A method described here uses Tanuki Java Service Wrapper.

Important! Currently provided method for adding a startup script is valid and tested for RedHat-like OS machines. For Ubuntu, adding a start-up script might differ.

To install and run YouTrack JAR distribution as a service on a Unix-like OS, you can use the following procedure:

1. Create a user to run YouTrack (e.g. youtrack):
2. Download Tanuki Java Service Wrapper compatible with your CPU.

   Please note that the bit-version of wrapper should be the same as the bit-version of Java installed on your machine, that is: If you have 32-bit Java installed, then you need the 32-bit wrapper.

   For an Intel-based machines, you can use the commands below:
3. Unpack downloaded archive to the home directory of the created user. We also recommend to rename the wrapper's directory (e.g. 'standalone'), for usability purposes:
   
   The result wrapper's directory should have the following structure:
4. Copy YouTrack standalone JAR file to the wrapper's directory:
5. Create a soft link to the JAR file:
6. Create system startup script in the /etc/init.d/ as 'youtrack':
   1. Download the following script template: youtrack_initd.template. This template is based on a sample startup script included in the wrapper distribution.
   2. Change settings in the top section of the script to reflect your system environment.
   3. Save the edited template as the youtrack script in the /etc/init.d/ folder.
   4. Make the script executable:
7. Replace an existing wrapper's configuration file ~youtrack/standalone/conf/wrapper.conf with the following configuration file: wrapper.conf.
8. Run your newly created wrapper to test the installation:
   
   Test checklist:
   • YouTrack has started successfully
   • 'youtrack.pid' pid file has appeared in the ~youtrack/standalone/ folder
   • 'wrapper.log' log file has appeared in the ~youtrack/standalone/logs/ folder
9. Add the new startup script to the system startup scripts sequence:
10. You may stop or restart YouTrack by following commands:

By default, the new YouTrack instance is configured to use TCP port 8080. You can change this setting in the wrapper.conf file (replace 8080 in line wrapper.app.parameter.2=8080 with desired port value), or you can edit the configuration of the Nginx frontend.