Suspending and unsuspending users

If employees leave the company, you can suspend their GitHub Enterprise Server accounts to open up user licenses in your GitHub Enterprise license while preserving the issues, comments, repositories, gists, and other data they created. Suspended users cannot sign into your instance, nor can they push or pull code.

When you suspend a user, the change takes effect immediately with no notification to the user. If the user attempts to pull or push to a repository, they'll receive this error:

$ git clone git@[hostname]:john-doe/test-repo.git
Cloning into 'test-repo'...
ERROR: Your account is suspended. Please check with your installation administrator.
fatal: The remote end hung up unexpectedly

Before suspending site administrators, you must demote them to regular users. For more information, see "Promoting or demoting a site administrator."

Suspending a user from the user admin dashboard

1. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

   

2. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

   

3. 在搜索字段中，输入用户的名称，然后单击 Search（搜索）。

4. 在搜索结果中，单击用户名称。

5. 在页面的右上角，单击 Admin（管理员）。

6. 在左侧边� �中，单击 Admin（管理员）。

7. Under "Account suspension," in the red Danger Zone box, click Suspend.

8. Provide a reason to suspend the user.

Unsuspending a user from the user admin dashboard

As when suspending a user, unsuspending a user takes effect immediately. The user will not be notified.

1. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

   

2. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

   

3. In the left sidebar, click Suspended users.

4. Click the name of the user account that you would like to unsuspend.

5. 在页面的右上角，单击 Admin（管理员）。

6. 在左侧边� �中，单击 Admin（管理员）。

7. Under "Account suspension," in the red Danger Zone box, click Unsuspend.

8. Provide a reason to unsuspend the user.

Suspending a user from the command line

1. SSH 连接到 your GitHub Enterprise Server instance。 更多信息请参阅“访问管理 shell (SSH)。”

   $ ssh -p 122 admin@HOSTNAME

2. Run ghe-user-suspend with the username to suspend.

   $ ghe-user-suspend username

Creating a custom message for suspended users

You can create a custom message that suspended users will see when attempting to sign in.

1. 在 GitHub Enterprise Server 的右上角，单击您的个人资料照片，然后单击 Enterprise settings（Enterprise 设置）。

2. 在企业帐户侧边� �中，单击 Settings（设置）。

3. 在 “ 设置”下，单击 Messages（消息）。

4. Click Add message.

5. Type your message into the Suspended user message box. You can type Markdown, or use the Markdown toolbar to style your message.

6. Click the Preview button under the Suspended user message field to see the rendered message.

7. Review the rendered message.

8. 在页面底部，单击 Save changes（保存更改）。

Unsuspending a user from the command line

1. SSH 连接到 your GitHub Enterprise Server instance。 更多信息请参阅“访问管理 shell (SSH)。”

   $ ssh -p 122 admin@HOSTNAME

2. Run ghe-user-unsuspend with the username to unsuspend.

   $ ghe-user-unsuspend username

Further reading

• "Suspend a user"