YouTrack Standalone 2017.1 Help

Host a YouTrack Instance on Microsoft Azure

Cloud hosting gives you the flexibility to add resources to your network without having to install and maintain your own servers. JetBrains offers YouTrack InCloud, which provides you with a ready-to-use YouTrack instance in the cloud. You can also install YouTrack Standalone on a virtual machine that is hosted on Microsoft Azure.

This guide shows you how to configure a virtual machine and install YouTrack in a Microsoft Azure account. There are a number of different configurations you can use to run YouTrack in a hosted environment. The setup in this guide uses the following components:

  • Windows Server 2012 R2 Datacenter for the virtual machine
  • YouTrack MSI distribution for the installation package

If you want to use a different type of virtual machine or installation, you can still follow this guide for general setup guidelines.

Overview

To host a YouTrack instance in Microsoft Azure, perform the following steps:

Prerequisites

This setup requires that you have an active Microsoft Azure subscription.

  • The amount of storage that you need to host YouTrack varies based on the size of your YouTrack database.
  • If your subscription does not already include a standalone virtual machine, you will need to create one. The virtual machine must have at least 1 core and 1,5 Gb of RAM.

If you don't have a Microsoft Azure subscription, you can sign up for a free 30-day trial. The trial lets you create and try out any combination of Azure resources. For more information, visit the official Microsoft Azure website.

Create a Virtual Machine

To get started, you need to add a virtual machine to your Microsoft Azure subscription. If you already have a virtual machine that has enough free resources to host YouTrack, skip this procedure and continue with the next step.

To create a virtual machine:

  1. Sign in to the Microsoft Azure management portal.
  2. Click the New button and select Virtual Machines.
  3. Select an image from the list. You can run YouTrack on either a Windows or Linux server. This setup uses a Windows Server 2012 R2 Datacenter.

    /help/img/youtrack/2017.1/newAzureVM_thumbnail.png

  4. From the Select a deployment model drop-down list, select Classic.
  5. Click the Create button.
    • The Create VM wizard opens.
      /help/img/youtrack/2017.1/createVMWizard_thumbnail.png
  6. Enter values for the following settings:
    SettingDescription
    Host NameEnter a name for the virtual machine. This value is added as a prefix to the DNS name that you use to access the machine remotely. The virtual machine is assigned a unique DNS name that always uses the subdomain .cloudapp.net. If you want to use a custom domain name, configure the custom domain name before you proceed with the next step in this setup.
    User nameEnter a name for the user account that is used to manage the virtual machine.
    PasswordSet the password for the user account that is used to access the virtual machine.
  7. In the Pricing Tier section, choose the size of the virtual machine.
  8. In the Location section, select a location that is closest to you to reduce latency.
  9. Click the Create button.
    • The virtual machine is created and added to your subscription. Depending on the size of the virtual machine, this can take some time. The status of the virtual machine is shown under the Notifications pane in the toolbar.

Once the setup of your virtual machine is complete, you can proceed with the next step.

Add Endpoints to the Virtual Machine

When you create a new Windows virtual machine, the TCP port 3389 is opened to connect with the Remote Desktop. Linux virtual machines use TCP port 22 to allow an SSH connection. To give external users access to your YouTrack service, you need to set the entry point for the service in the virtual machine.

To add an endpoint to the virtual machine:

  1. Select the name of your virtual machine in the Microsoft Azure portal.
  2. Click the Settings button in the toolbar.
  3. In the General section, click Endpoints.
  4. Click the Add button in the toolbar.
    /help/img/youtrack/2017.1/AzureMVEndpoints.png
  5. In the Add endpoint blade, enter values for the following settings:
    SettingDescription
    NameEnter a name for the endpoint, for example, YouTrack.
    ProtocolSelect TCP.
    Public portEnter 80.
    Private portEnter 80.
  6. Click the OK button.
    • The virtual machine endport is saved. The status of the virtual machine is shown under the Notifications pane in the toolbar.

Now that you have configured the virtual machine, continue with the next step to configure the firewall.

Open an HTTP port in the Firewall

The image for the virtual machine that is used in this setup includes a pre-configured firewall. If your virtual machine has a firewall enabled, you need to open a port to allow access to YouTrack over HTTP.

To open a port in the Windows Firewall:

  1. Select the name of your virtual machine in the Microsoft Azure portal.
  2. Click the Connect button in the toolbar.
    • A Remote Desktop Connection to the virtual machine is downloaded to your local directory.
  3. Open the Remote Desktop Connection with the username and password that you entered when you created the virtual machine.
  4. In the Server Manager, select the Local Server.
  5. In the Properties section, click the link next to the Windows Firewall property.
    /help/img/youtrack/2017.1/AzureLocalServer.png
    • The Windows Firewall window opens.
  6. Click the Advanced Settings link.
    • The Windows Firewall with Advanced Security dialog opens.
  7. Right-click Inbound Rules and select the New Rule option.
    /help/img/youtrack/2017.1/newFirewallRule_thumbnail.png
    • The New Inbound Rule Wizard opens.
  8. Follow the steps in the wizard to configure the rule as follows:
    StepOption
    Rule TypeSelect Port.
    Protocol and Ports
    • Select TCP.
    • In the Specific local ports input field, enter 80.
    ActionSelect Allow the connection.
    ProfileApply the rule to all firewall modes.
    NameEnter a name, for example, Allow YouTrack. Enter an optional description.
  9. When done, click the Finish button.
    • The firewall rule is enabled.

Alternatively, you can open Windows PowerShell and enter the following command:

netsh advfirewall firewall add rule name="YouTrack" dir=in action=allow protocol=TCP localport=80

Now that you have opened the port that will be used by YouTrack, stay logged in to the Remote Desktop Connection and continue with the final step.

Install YouTrack

The procedure for installing YouTrack on the virtual machine is similar to any other YouTrack installation. You can install whichever distribution type you want to use. This setup follows the installation procedure for the MSI distribution.

The Windows virtual machine includes Internet Explorer as the default browser, however, the browser is configured to use the enhanced security configuration. This configuration does not trust any web sites and disables downloads. Before you continue with the installation:

  • Disable Internet Explorer Enhanced Security.
    or
  • Download and install a different web browser. If you install a different browser, set it as the default browser for your operating system.

To install YouTrack:

  1. Download the MSI distribution from the JetBrains website.
  2. Open the Windows Installer Package (MSI file).
    • The JetBrains YouTrack 7.0 Setup Wizard opens.
  3. Follow the instructions in the setup wizard.
    • When the installation wizard is finished, the web-based Configuration Wizard opens in your default browser.
  4. In the Configuration Wizard, click Set up.
  5. On the Confirm Settings page, change the Base URL to the full DNS name of your virtual machine. This ensures that notifications that contain links to your YouTrack instance point to the correct URL.
    /help/img/youtrack/2017.1/AzureChangeBaseURL.png
  6. Continue with the remaining steps in the wizard.
  7. 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.

That's it. Your YouTrack Standalone instance is installed and available for use in the cloud.

Last modified: 18 April 2017