MSI Installation
To install YouTrack as a Windows service:
Download the MSI distribution from the JetBrains website.
Open the Windows Installer Package (MSI file).
The JetBrains YouTrack Setup Wizard opens.
Follow the instructions in the setup wizard.
When the installation wizard is finished, the web-based Configuration Wizard opens in your default browser.
If you do not have a web browser installed on the host machine, open the URL that is provided by the setup wizard in a web browser on another workstation.
note
The Setup Wizard can detect data from a previous installation of YouTrack Standalone. For more information, see Previous Installation Data Found.
Click the Finish button to close the setup wizard.
Switch to your web browser and continue with the installation in the web-based Configuration Wizard.
In the Configuration Wizard, click Set up.
On the Confirm Settings page, confirm or change the basic system settings.
Setting
Description
Base URL The URL where end users access YouTrack Standalone.
Application Listen Port The port your YouTrack Standalone 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 Standalone stores product data.
Setting
Description
Data Directory Location The directory where YouTrack Standalone stores content data.
Backup Location The directory where YouTrack Standalone stores backups of the database.
Logs Location The directory where YouTrack Standalone stores log files.
Temp Location The directory where YouTrack Standalone 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.
note
Which Hub service is right for you?
If you do not plan to use Upsource or TeamCity, you might opt to use the built-in Hub service. If you have already installed JetBrains Upsource and want to integrate it with YouTrack, or are even considering this option, consider using an external Hub service. For a new YouTrack installation, we recommend that you start with the built-in Hub service. You can always migrate your data to an external Hub service at a later date.
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 Login 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 Standalone server.
Do not close the page in the browser until the setup is complete. When the YouTrack Standalone 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 Standalone instance is installed and ready for use.
