

Paste the URL that points to your GitHub repository into the Repository URL input field. You can add integrations with additional YouTrack projects after you have set up the connection to the repository. Open the Administration > VCS Integrations page in YouTrack.įrom the Main YouTrack project list, select the name of the primary project that you want to integrate with the VCS repository. If you don't already have a personal access token, you can use the direct link from YouTrack to generate it during this setup procedure. You can use a single access token to set up multiple integrations. This token grants YouTrack access to the repository based on the access that is granted to your GitHub account. To connect with GitHub, you need to generate and store a personal access token. The first step is to establish a connection between a project in YouTrack and a repository in GitHub. For security, use this option only when both YouTrack and your GitHub Enterprise server run on a private computer network. If the certificate for your server is self-signed, you need to import the certificate and public key to establish a secure connection. You should be able to connect to the server without importing its SSL certificate. If your GitHub Enterprise server has a valid certificate that is signed by a well-known certificate authority (CA), the JVM vendor may have already added the root (CA) certificate to the certificate store. If you're integrating with a GitHub Enterprise installation and want to establish a secure (HTTPS) connection with the server, you may need to import the SSL certificate for your GitHub server into YouTrack. The user account that you use to generate the personal access token for authorization in GitHub has either Admin or Owner permissions for the repository. Specifically, you need to make sure that your network doesn't block connections between your VCS server and YouTrack. YouTrack is accessible to inbound connections. For more information, see Integrate with GitHub.Īs an administrator, you can enable the GitHub integration for any project in YouTrack. This operation can also be performed by a project administrator on a per-project basis. When you set up an integration with GitHub, you map a YouTrack project to a GitHub repository. For more information, see Link Issues in VCS Commits.Īdd links to the GitHub repository by pasting commit hashes into the issue summary, description, comment, or a supplemental text field. For details, see Pull Requests.Īdd links to YouTrack issues in commit messages or branch names. For more information, see Commits.ĭisplay the status of pull (merge) requests directly in the activity stream of any issue that is referenced in the title or description of the pull request. Track commits that are related to specific issues in the activity stream for the issue in YouTrack. For more information, see Apply Commands in VCS Commits. Follow the instructions on this page to integrate with VCS repositories that are hosted on or a self-hosted GitHub Enterprise installation.Ī GitHub integration enables the following features in YouTrack:Īpply commands to YouTrack issues in commit messages.
