GitHub organizations and Walhall

Overview

In Walhall, apps are managed by organizations. Organizations in Walhall are coupled with GitHub organizations. Users log in to Walhall with their GitHub accounts, and then they can deploy repositories that they have permissions to access in their GitHub organization account.

1. Remove third party restrictions

First, make sure that your organization allows third-party application access. To do this, go to your GitHub Organization settings > Third-party access and click “Remove restrictions.”

Screenshot: Third-party access restrictions

If you would prefer not to do this, you can grant organization access to Walhall in the next step.

2. Admin registration: Register your organization with Walhall

When you’re ready to link your organization:

  1. Fill out the registration form.
  2. Go to your email inbox and click the link you receive from the platform.
  3. Click the Authorize with GitHub button. Screenshot: Authorize with GitHub
  4. Complete the GitHub OAuth flow to authorize Walhall to access your organization. Screenshot: Grant organization access to Walhall
  5. You will be returned to Walhall, where you will see a list of your GitHub organizations; select the organization you want to register with Walhall.
  6. Read and accept the required legal notices by checking the box at the bottom.

Once this process is complete, you will be logged in and taken to the home screen of Walhall. From here, you can create your first app.

3. Invite other users

Once you’ve linked your organization to Walhall, your organization members can fill out the registration form and register with Walhall. The platform will offer them the option to join your organization during the registration process. Then, they can sign in to Walhall with their GitHub accounts and create apps for the organization.