You are viewing documentation for the older version of YouTrack!

Skip to end of metadata
Go to start of metadata

This page is currently being updated. We apologize for the inconveniences. Stay tuned for updates.

Installing Standalone YouTrack JAR as a Service on Mac OS X

To run YouTrack as a service on Mac OS X system you will need to install and use launchd daemon/agent manager for Mac OS X and create a plist script for it.


A method described here uses Tanuki Java Service Wrapper.

To install and run YouTrack standalone JAR distribution as a service on a Mac OS X, we recommend to use the following procedure:

  1. Create a user to run YouTrack (e.g. youtrack):
  2. Download Tanuki Java Service Wrapper compatible with your system.
  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 a launchd system startup script as 'youtrack.plist' and put it in the <user_home>/Library/LaunchAgent folder.
    Script hint

    Take a look at the Lingon 3 application, which allows to ease the procedure of creating plist scripts and running services.

  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
    • '' 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.

    By default, the new YouTrack instance is configured to use TCP port 8080. You can change this setting in the wrappers.conf file, or you can edit the configuration of the Nginx frontend.