Add a GitHub App
Configure and install a GitHub App to link monolayer to your repositories
Before creating your first project, you'll need to configure a GitHub App.
This app lets monolayer securely link to your GitHub repositories to access your code.
Before continuing, make sure you have a GitHub organization where your are admin.
If you don't have one yet, create a GitHub organization first, then return to this setup flow.
Follow these steps to register and install a GitHub App for your GitHub organization.
Open the GitHub Apps page
In your monolayer Control Plane, in the Settings section of the sidebar. click on the GitHub Apps, you'll be able to configure a new app.
Create and configure the app
- Click Configure and install app
- In the popup window, enter the name of your GitHub Organization
- Click Create and configure app
At this point, you will be automatically redirected to GitHub to complete the setup.
Complete the installation on GitHub
To finalize the setup, complete the app creation and installation process on GitHub:
- On the GitHub page, review the requested permissions and click to create the GitHub App
- Follow the prompts to choose where to install the app and select which repositories it can access
- Click Install
Verify the connection
After installing, you will be redirected back to the monolayer Control Plane. Your new GitHub App should now appear in the list of configured apps under the GitHub Apps settings page.
You're now ready to create your first monolayer Project and connect it to your Git repository.