1.1.4.1 Introduction

This guide will walk through the steps needed to configure a GitHub App and run it on a server.

• Guide to configure a GitHub App

GitHub Apps require some setup steps to manage webhook events and connect the app registration on GitHub to your code. The app in this guide serves as a foundation that you can use to extend and build new GitHub Apps.

By the end of this guide:

• you’ll have registered a GitHub App
• set up a web server to receive webhook events
• You’ll learn how to use a tool called Smee to capture webhook payloads and forward them to your local development environment
• The template app you’ll configure in this section won’t do anything special yet, but it will serve as a framework you can use to start writing app code using the API

After completing this project you will understand how to authenticate as a GitHub App and an installation, and how those authentication methods are different.