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. Select from the following:

   • Classic UI: In the GitHub repositories tile, select Link repository.

   • New UI: Scroll down to the GitHub Repositories section, click the arrow to expand, and then select the Link Repository button.

   

3. Enter the following information:

   • GitHub Account: Enter your account name.

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

   • GitHub Repository: Enter 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 Managing your personal access tokens 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 that you want to sync with.

     • Branch: From the dropdown, select the branch within your repository.

     • File extensions: From the dropdown, select the type of file extension.

     • File content: From the drop-down list, select the type of file content. You have the following options:

       • Windows script

       • Azure runbook

       • Intune compliance policy

       • Intune configuration profile

       • Intune security baseline

       • Intune device configuration policy

       • Intune group configuration policy

       • Intune conditional access policy

       • Intune Microsoft Defender antivirus policies

       • Intune Windows firewall policies

       • Intune attack surface reduction rules policies

       • Intune macOS firewall policies

       • Intune application control policies

       • Intune endpoint detection and response policies

       • Built-in policy baselines

       • Intune autopilot deployment profile

       • Local admin password solution

     • 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.

   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 if required.

To manually synchronize a GitHub repository:

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

2. Select from the following:

   • Classic UI: In the GitHub repositories tile, locate the link you wish to synchronize, and select the refresh icon to synchronize the repository.

   • New UI: Scroll down to the GitHub Repositories section, click the arrow to expand, and then select the refresh icon to synchronize the repository.

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

   The GitHub repository is synchronized with 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. Select from the following:

   • Classic UI: In the GitHub repositories tile, locate the repository you wish to unlink, and select unlink.

   • New UI: Scroll down to the GitHub Repositories section, click the arrow to expand, and then select the unlink icon to unlink the repository.

3. 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. Select from the following:

   • Classic UI: In the GitHub repositories tile, select Add token.

   • New UI: Scroll down to the GitHub Repositories section, click the arrow to expand, and then select the + Add Token button to add a new token.

3. Enter the following information:

   • Token name: Enter 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. Select from the following:

   • Classic UI: In the GitHub repositories tile, in the Tokens section, locate the token you want to remove, and select remove.

   • New UI: Scroll down to the GitHub Repositories section, click the arrow to expand, and then, in the Token name section, select the icon to delete a token.

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

   The GitHub repository token is removed from Nerdio Manager.