---

title: GitHub description: Configure GitHub integration for automatic compliance monitoring in Tidal Control sidebar_position: 5

GitHub

Configuring GitHub integration

The GitHub integration enables Tidal Control to automatically execute compliance tests on your GitHub environment via the Tidal Control GitHub app.

Requirements:

• Super User role in Tidal Control
• GitHub organisation admin rights
• Access to GitHub organisation where monitoring is desired

Configuration step-by-step plan

What we're going to do: We'll install the Tidal Control GitHub app in your GitHub organisation(s). This app gets read-only access to repository configurations for security compliance monitoring.

Configuration steps:

1. Start Tidal integration
2. GitHub authentication
3. Configure repository access
4. Complete app installation
5. Additional organisations

Step 1: Start Tidal integration

• Go to Settings → Integrations in Tidal Control
• Click the plus icon next to GitHub
• Click "Click here to get started"
• You'll be automatically redirected to GitHub

Step 2: GitHub authentication

• Enter your GitHub login credentials
• Click "Sign in"
• Select the organisation where you want to install the app
• If app already installed: click "Configure" for settings

Step 3: Configure repository access

• Choose access level:
  • All repositories - Complete organisation monitoring
  • Selected repositories - Selective compliance monitoring
• Select desired repositories if specific chosen

Step 4: Complete app installation

• Review the permissions that Tidal Control requests
• Click "Install" for direct installation
• Or click "Request" if organisation approval required
• Wait for approval from organisation owner (if applicable)

Step 5: Additional organisations

• Repeat steps 1-4 for each additional organisation
• Each organisation needs own app installation
• Configure per organisation which repositories are monitored

Verification

Check successful configuration:

• Settings → Integrations shows "Connected" status for GitHub
• Test refresh delivers repository data without (permission) errors

Troubleshooting

Troubleshooting issues:

• Verify GitHub app installation in organisation settings
• Check repository permissions for Tidal Control app
• Ask if organisation admin has approved the app
• Verify there are no conflicting security policies in GitHub

Still having trouble?

Send an email to support@tidalcontrol.com, and we'll get in touch as soon as possible.