GitHub Integration

Nerdio Manager is integrated with our public GitHub repositories. That means you have access to all the scripted actions in those repositories. which are constantly enhanced and added to, and then automatically downloaded and integrated with your Nerdio Manager installation. The Nerdio Manager GitHub repository is called NMM and, by default, is linked to your installation.

In addition to integrating with Nerdio Manager's GitHub repository, it is also possible to integrate and connect to your own GitHub repository . You are then able to take advantage of all of the features that GitHub provides - versioning, branching and working in collaboration with teams, and having all those changes automatically synchronized into Nerdio Manager from GitHub.

Link to a GitHub Repository

You can link a GitHub repository to Nerdio Manager.

To link to a GitHub repository:

1. At the MSP level, navigate to Settings > Integrations.

2. In the GitHub repositories tile, select Link repository.

   

3. Enter the following information:

   • GitHub Account: Type your account name.

     For example, https://github.com/AccountName/RepositoryName

   • GitHub Repository: Type the repository name.

   • GitHub access token: From the drop-down list, select an existing token. Alternatively, paste the token generated in your repository.

     Note: If you are linking to a private repository, you must create an access token. You can save the token in Nerdio Manager and it appears in the drop-down list for you to select. See Add a GitHub Repository Token for more information.

     See this GitHub article for more information about creating an access token in GitHub.

   • Enter the path-branch-file extensions information that you want to synchronize with scripted actions.

     Note: You may add as many path-branch-file extension rows as desired.

     • Select Add to add a new row.

     • Select to delete an existing row.

     • Path: Type the path within your repository.

     • Branch: Type the branch within your repository.

     • File extensions: Type the extensions of files.

     • Execution environment: From the drop-down list, select the types of scripted actions contained within this path - Windows scripts or Azure runbooks.

     • Include subfolders: Select this option to recursively include all subfolders within the specified path.

   • Auto-synchronization enabled: Toggle on the auto-synchronization option so that changes to scripts within the repository are automatically synchronized with scripted actions every hour.

     Note: Repositories can also be synchronized on-demand. See Manually Synchronize a GitHub Repository for details.

4. When you have entered all the desired information, select OK.

   The GitHub repository is linked to Nerdio Manager.

   Note:

   • You can see the progress of the linking process in the Settings Tasks section at the bottom of the window.

   • Once the linking process is complete, the scripted actions in the GitHub repository are available to be used. See Overview of Scripted Actions for details about scripted actions.

Manually Synchronize a GitHub Repository

If the GitHub repository is configured to auto-synchronize, Nerdio Manager automatically synchronizes the repository once an hour. Whether the GitHub repository auto-synchronizes or not, you can manually synchronize the GitHub repository whenever you desire.

To manually synchronize a GitHub repository:

1. At the MSP level, navigate to Settings > Integrations.

2. In the GitHub repositories tile, locate the link you wish to synchronize.

3. Select .

4. Review the confirmation pop-up and select OK.

   The GitHub repository is synchronized to Nerdio Manager.

Note: If you delete a scripted action in your GitHub repository, it is still visible inside Nerdio Manager. This protects any configurations that may be using the scripted action. You may continue to use the scripted action in Nerdio Manager. Alternatively, you may delete it.

It goes into an "orphan" state that is flagged in the list of scripts. For example:

Unlink a GitHub Repository

You can unlink a GitHub repository from Nerdio Manager.

To unlink a GitHub repository:

1. At the MSP level, navigate to Settings > Integrations.

2. In the GitHub repositories tile, locate the link you wish to unlink.

3. Select unlink.

4. Review the confirmation pop-up.

   The GitHub repository is unlinked from Nerdio Manager and all the scripted actions are removed.

Add a GitHub Repository Token

Nerdio Manager allows you to add your GitHub repository tokens so they can be used to link to your repositories.

To add a GitHub repository token:

1. Navigate to Settings > Integrations.

2. In the GitHub repositories tile, select Add token.

   

3. Enter the following information:

   • Token name: Type the name for your token that is displayed when linking repositories.

   • GitHub Access token: Paste the token generated by your GitHub repository.

4. Once you have entered all the desired information, select OK.

   The GitHub repository token is added to Nerdio Manager.

Remove a GitHub Repository Token

Nerdio Manager allows you to remove your GitHub repository tokens.

To remove a GitHub repository token:

1. Navigate to Settings > Integrations.

2. In the GitHub repositories tile, locate the token you wish to remove.

3. Select remove.

4. Review the confirmation pop-up and select OK.

   The GitHub repository token is removed from Nerdio Manager.