Managing pre-receive hooks on the GitHub Enterprise Server appliance

In this guide

• Creating pre-receive hooks
• Editing pre-receive hooks
• Deleting pre-receive hooks
• Configure pre-receive hooks for an organization
• Configure pre-receive hooks for a repository

Creating pre-receive hooks

1. In the upper-right corner of any page, click .

   

2. In the left sidebar, click Admin center.

   

3. In the left sidebar, click Pre-receive hooks.

   

4. Click Add pre-receive hook.

   

5. In the Hook name field, enter the name of the hook that you want to create.

   

6. From the Environment drop-down menu, select the environment on which you want the hook to run.

   

7. Under Script, from the Select hook repository drop-down menu, select the repository that contains your pre-receive hook script. From the Select file drop-down menu, select the filename of the pre-receive hook script.

   

8. Select Use the exit-status to accept or reject pushes to enforce your script. Unselecting this option allows you to test the script while the exit-status value is ignored. In this mode, the output of the script will be visible to the user in the command-line but not on the web interface.

   

9. Select Enable this pre-receive hook on all repositories by default if you want the pre-receive hook to run on all repositories.

   

10. Select Administrators can enable and disable this hook to allow organization members with admin or owner permissions to select whether they wish to enable or disable this pre-receive hook.

    

Editing pre-receive hooks

1. In the upper-right corner of any page, click .

   

2. In the left sidebar, click Admin center.

   

3. In the left sidebar, click Pre-receive hooks.

   

4. Next to the pre-receive hook that you want to edit, click .

   

Deleting pre-receive hooks

1. In the upper-right corner of any page, click .

   

2. In the left sidebar, click Admin center.

   

3. In the left sidebar, click Pre-receive hooks.

   

4. Next to the pre-receive hook that you want to delete, click .

   

Configure pre-receive hooks for an organization

An organization administrator can only configure hook permissions for an organization if the site administrator selected the Administrators can enable or disable this hook option when they created the pre-receive hook. To configure pre-receive hooks for a repository, you must be an organization administrator or owner.

1. In the top right corner of GitHub Enterprise Server, click your profile photo, then click Your profile.

   

2. On the left side of your profile page, under "Organizations", click the icon for your organization.

   

3. Under your organization name, click Settings.

   

4. In the left sidebar, click Hooks.

   

5. Next to the pre-receive hook that you want to configure, click the Hook permissions drop-down menu. Select whether to enable or disable the pre-receive hook, or allow it to be configured by the repository administrators.

   

Configure pre-receive hooks for a repository

A repository owner can only configure a hook if the site administrator selected the Administrators can enable or disable this hook option when they created the pre-receive hook. In an organization, the organization owner must also have selected the Configurable hook permission. To configure pre-receive hooks for a repository, you must be a repository owner.

1. In the top right corner of GitHub Enterprise Server, click your profile photo, then click Your profile.

   

2. Click Repositories and select which repository you want to configure pre-receive hooks for.

   

3. Under your repository name, click Settings.

   

4. In the left sidebar, click Hooks & Services.

   

5. Next to the pre-receive hook that you want to configure, click the Hook permissions drop-down menu. Select whether to enable or disable the pre-receive hook.