JAR Installation
The YouTrack JAR distribution is available for download on the JetBrains website.
YouTrack JAR has the package structure similar to ZIP and MSI distributions, and also incorporates the web-based Configuration Wizard.
This is a cross-platform distribution. You can use YouTrack JAR to install and run YouTrack on Linux, macOS, and Windows.
The procedure for installing YouTrack with this distribution is similar for all operating systems.
To install YouTrack Server with a JAR distribution:
Download the JAR distribution from the JetBrains website.
Upload the JAR distribution to your server.
Open a command-line interface on the server and run the application. For detailed instructions, see Run YouTrack JAR.
Configure the application in the web-based Configuration Wizard. For details, see Configure the JAR Installation.
Installation Options
A YouTrack JAR distribution can be set up in a variety of server environments. The following topics provide specific instructions for installing and running the JAR distribution different operating systems:
Run YouTrack JAR
Run YouTrack Server with the following command:
The following options and variables are set by default, and you do not need to set them explicitly in the command line:
By default, you do not need to specify explicitly any options or parameters in the command line. However, you may set values for the following variables in the command:
Parameter | Description |
---|---|
| The JVM options that are set when the YouTrack instance is started. Each JVM option must be prefixed with either |
| The listen address of your YouTrack server. The default value is |
| The HTTP port number of your YouTrack server. |
| The context path of your YouTrack instance. A context path is a prefix on the path portion of a URL. This path routes requests to the proper webapp when more than one webapp is hosted on the same server. By default, YouTrack service is deployed on the root (' |
When you set the contextPath
, you can run YouTrack with the context other than the default path. Here are a few command examples with various URI configurations for different YouTrack servers:
For a complete list of YouTrack-specific JVM options, see Configuration Parameters.
Configure the JAR Installation
When you start YouTrack, the application opens in a browser. If you do not have a web browser installed on the host machine or do not want the browser to pop up, use the --no-browser
flag right after the jar file name in the command:
java -jar youtrack-2022.1.12345.jar --no-browser 8080
If you do not have a web browser installed on the host machine, you must open the wizard in a web browser on another workstation. The wizard URL is printed in the console output:
To configure the JAR installation:
In the Configuration Wizard, click Set up.
On the Confirm Settings page, confirm or change the basic system settings.
Here you can also enable the built-in TLS to secure the network connection for the server. For detailed instructions, see Enable HTTPS during Installation.
Setting
Description
HTTP | HTTPS
Allows to enable or disable the built-in TLS and configure the secure the network connection to your server. If you enable HTTPS, the TLS specific settings are displayed.
See the TLS Settings page for details.
Base URL
The URL where end users access YouTrack Server.
Application Listen Port
The port your YouTrack Server server listens to after installation.
Language
The default language that is shown in the user interface.
Expand the Advanced Settings section to confirm or change the locations where YouTrack Server stores product data.
Setting
Description
Data Directory Location
The directory where YouTrack Server stores content data.
Backup Location
The directory where YouTrack Server stores backups of the database.
Logs Location
The directory where YouTrack Server stores log files.
Temp Location
The directory where YouTrack Server stores product-specific temporary files.
To change the location for any of these file types, click the Change button and select a new location.
To share usage statistics with JetBrains, keep the Send usage statistics anonymously option enabled. This feature helps JetBrains track usage statistics to make YouTrack better. We never share collected data with any third party.
When done, click Next.
On the Select Hub Service page, select whether you want to use a built-in or external Hub service.
Configure the following settings based on the type of service you select:
Service
Settings
Built-in Hub
Enter and confirm the password for the default system administrator account
admin
. To assign a different username to the administrator account, edit the Create Admin Username setting.Deselect the Enable login as guest option to ban the guest user account.
The built-in Hub service is configured and started automatically.
External Hub
Enter the Base URL of your external Hub installation and verify it.
When done, click Next.
On the Confirm License page, verify the license name and key. Expand the License Limitations section to verify any limitations that apply to your current plan.
When done, click Finish.
The configuration is applied to your YouTrack Server server.
Do not close the page in the browser until the setup is complete. When the YouTrack Server server is ready, you are logged in to YouTrack as a guest. If you disabled login as guest, the login page opens.
That's it. Your YouTrack Server instance is installed and ready for use.
Once your YouTrack service is up and running, you may want to set up projects and access rights, import issues from another tracker, or fine-tune the server environment. For more information, check the topics in the See Also section below.