Managing allowed IP addresses for your organization

Organization owners can manage allowed IP addresses for an organization.

About allowed IP addresses

You can restrict access to organization assets by configuring an allow list for specific IP addresses. For example, you can allow access from only the IP address of your office network. The allow list for IP addresses will block access via the web, API, and Git from any IP addresses that are not on the allow list.

You can approve access for a single IP address, or a range of addresses, using CIDR notation. For more information, see "CIDR notation" on Wikipedia.

To enforce the IP allow list, you must first add IP addresses to the list, then enable the IP allow list. You must add your current IP address, or a matching range, before you enable the IP allow list.

You can also configure allowed IP addresses for the organizations in an enterprise account. For more information, see "Enforcing security settings in your enterprise account."

Adding an allowed IP address

1. In the top right corner of GitHub, 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 Organization security.

   

5. Under "IP Address", type an IP address, or range of addresses, in CIDR notation.

   

6. Under "Description", type a description of the allowed IP address or range.

   

7. Click Add.

   

Enabling allowed IP addresses

1. In the top right corner of GitHub, 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 Organization security.

   

5. Under "IP allow list", select Enable IP allow list.

   

6. Click Save.

Editing an allowed IP address

1. In the top right corner of GitHub, 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 Organization security.

   

5. Under "IP allow list", to the right of the entry you want to edit, click Edit.

   

6. Type an IP address, or range of addresses, in CIDR notation.

   

7. Type a description of the allowed IP address or range.

   

8. Click Update.

Deleting an allowed IP address

1. In the top right corner of GitHub, 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 Organization security.

   

5. Under "IP allow list", to the right of the entry you want to delete, click Delete.

   

6. To permanently delete the entry, click Yes, delete this IP allow list entry.

   

Using GitHub Actions with an IP allow list

To allow your self-hosted runners to communicate with GitHub, add the IP address or IP address range of your self-hosted runners to the IP allow list. For more information, see "Adding an allowed IP address."