Get started with Walhall

Follow these instructions to get up and running with your Walhall account and create your first application.

Registration process

There are two registration flows:

  1. Organization admins who wish to onboard their GitHub organization to Walhall;
  2. Organization users who wish to register for Walhall as part of an organization that’s been onboarded.

Please note the beta limitations section at the bottom of the page.

Register your organization

To register your GitHub organization in Walhall:

  1. First, make sure that your organization allows third-party application access. There are two ways to do this:
    1. Remove the third-party access restrictions for the organization. To do this, go to your GitHub Organization settings > Third-party access and click “Remove restrictions.”
      Screenshot: Third-party access restrictions
    2. When authorizing Walhall to access your GitHub account in step 5, you can explicitly grant organization access by clicking the “Grant” button next to your organization name.
      Screenshot: Grant organization access to Walhall
  2. Go to https://app.walhall.io and click the Sign up link in the lower right.
  3. Enter your beta access code and click Register your organization.
  4. Read and accept the required legal notices by checking the box at the bottom.
  5. Click the button and follow the OAuth process to authorize Walhall to access your GitHub account.
  6. 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.

Your organization will then be created to Walhall, and you will be assigned to it. Walhall also creates a personal organization with your username for testing purposes. At this point, you’ll be logged in to Walhall and can start using the platform.

There is no special process for inviting your users to your organization in Walhall. They can add themselves during the Walhall registration process.

Register as a user of an organization

  1. Go to https://app.walhall.io.
  2. Click the Sign up link in the lower right.
  3. Toggle the No I don’t option in the lower left and then click the Join your organization button on the right.
  4. Read and accept the required legal notices by checking the box at the bottom.
  5. Click the button and follow the OAuth process to authorize Walhall to access your GitHub account.
  6. You will be returned to Walhall, where you will see a list of your GitHub organizations; select the organization you want to join.

That’s it—now you can get started using Walhall.

Create your first application

  1. Log in to Walhall.
  2. Click Let’s create your first application.
  3. Enter a name and description for your application and click Next.
  4. A list of logic modules will load. Each one comes with a backend service and a frontend client. Check the box next to each one you want to include in your application and then click Add.
    Screenshot: Logic modules list
    On the left, you have the option to filter logic modules by type (logic module or blueprint) and frontend stack.
  5. Click Create Application.

Congratulations! You’ve created your first Walhall application. However, nothing’s deployed yet—at this point, you have the opportunity to start developing your application before it goes live.

Beta limitations

Walhall is currently in closed beta. The following limitations to application and environment creation apply:

  • Both user access management and source code management are handled through GitHub. We will open this up to other version control systems (e.g., Gitlab, Bitbucket) in the future.
  • The number of applications is limited to 20, with a maximum of 3 environments each.
  • Walhall currently only offers the creation of development, staging, and demo environments; the option to create and manage production environments will be added later.
  • The role-based access model is not yet activated in Walhall. Each member of an organization in Walhall has full access to all applications for that organization and can delete and edit environments and applications.
  • Walhall works best in the latest version of Google Chrome or any other Chromium-based browser.