Host a YouTrack Instance on Microsoft Azure
Create a Virtual Machine
note
This guide shows you one of several options for setting up your Microsoft Azure environment.
For additional options, refer to the documentation on the Microsoft Azure website.
To create a virtual machine:
Sign in to the Microsoft Azure management portal.
Click the New button and select Virtual Machines.
- 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.
From the Select a deployment model drop-down list, select Classic.
- Click the Create button.
The Create VM wizard opens.
- Enter values for the following settings:
Setting
Description
Host Name
Enter 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 name
Enter a name for the user account that is used to manage the virtual machine.
Password
Set the password for the user account that is used to access the virtual machine.
In the Pricing Tier section, choose the size of the virtual machine.
In the Location section, select a location that is closest to you to reduce latency.
- 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.
Add Endpoints to the Virtual Machine
To add an endpoint to the virtual machine:
Select the name of your virtual machine in the Microsoft Azure portal.
Click the Settings button in the toolbar.
In the General section, click Endpoints.
Click the Add button in the toolbar.
- In the Add endpoint blade, enter values for the following settings:
Setting
Description
Name
Enter a name for the endpoint, for example,
YouTrack.Protocol
Select TCP.
Public port
Enter
80.Private port
Enter
80. - 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.
Open an HTTP port in the Firewall
To open a port in the Windows Firewall:
Select the name of your virtual machine in the Microsoft Azure portal.
- Click the Connect button in the toolbar.
A Remote Desktop Connection to the virtual machine is downloaded to your local directory.
Open the Remote Desktop Connection with the username and password that you entered when you created the virtual machine.
In the Server Manager, select the Local Server.
- In the Properties section, click the link next to the Windows Firewall property.
The Windows Firewall window opens.
- Click the Advanced Settings link.
The Windows Firewall with Advanced Security dialog opens.
- Right-click Inbound Rules and select the New Rule option.
The New Inbound Rule Wizard opens.
- Follow the steps in the wizard to configure the rule as follows:
Step
Option
Rule Type
Select Port.
Protocol and Ports
Select TCP.
In the Specific local ports input field, enter
80.
Action
Select Allow the connection.
Profile
Apply the rule to all firewall modes.
Name
Enter a name, for example,
Allow YouTrack. Enter an optional description. - When done, click the Finish button.
The firewall rule is enabled.
Install YouTrack
To install YouTrack:
- 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.
In the Configuration Wizard, click Set up.
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.
Continue with the remaining steps in the wizard.
- 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.
