Skip to content

admin: org freshness part 2 #23000

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 7, 2025
Merged

admin: org freshness part 2 #23000

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 40 additions & 7 deletions content/manuals/admin/organization/activity-logs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,17 +1,19 @@
---
title: Activity logs
weight: 50
description: Learn about activity logs.
keywords: team, organization, activity, log, audit, activities
description: Learn how to access and interpret Docker activity logs for organizations and repositories.
keywords: audit log, organization activity, Docker business logs, repository activity, track changes Docker, security logs Docker, filter logs, log Docker events

Check failure on line 5 in content/manuals/admin/organization/activity-logs.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'Docker Business' instead of 'Docker business'.

Raw Output:
{"message": "[Vale.Terms] Use 'Docker Business' instead of 'Docker business'.", "location": {"path": "content/manuals/admin/organization/activity-logs.md", "range": {"start": {"line": 5, "column": 45}}}, "severity": "ERROR"}
aliases:
- /docker-hub/audit-log/
---

{{< summary-bar feature_name="Activity logs" >}}

Activity logs display a chronological list of activities that occur at organization and repository levels. It provides a report to owners on all their member activities.
Activity logs display a chronological list of activities that occur at organization and repository levels. The activity log provides organization owners with a record of all
member activities.

With activity logs, owners can view and track:

- What changes were made
- The date when a change was made
- Who initiated the change
Expand All @@ -20,24 +22,55 @@

Owners can also see the activity logs for their repository if the repository is part of the organization subscribed to a Docker Business or Team subscription.

## Manage activity logs
## Access activity logs

{{< tabs >}}
{{< tab name="Admin Console" >}}

{{% admin-org-audit-log product="admin" %}}
To view activity logs in the Admin Console:

1. Sign in to [Docker Home](https://app.docker.com) and select your
organization.
1. Select **Admin Console**, then **Activity logs**.

{{< /tab >}}
{{< tab name="Docker Hub" >}}

{{% include "hub-org-management.md" %}}

{{% admin-org-audit-log product="hub" %}}
To view activity logs in Docker Hub:

1. Sign in to [Docker Hub](https://hub.docker.com).
1. Select **My Hub**, your organization, and then **Activity**.

{{< /tab >}}
{{< /tabs >}}

## Event definitions
## Filter and customize activity logs

By default, the **Activity** tab displays all recorded events. To narrow your
view, use the calendar to select a specific date range. The log updates to
show only the activities that occurred during that period.

You can also filter by activity type. Use the **All Activities** drop-down to
focus on organization-level, repository-level, or billing-related events.
In Docker Hub, when viewing a repository, the **Activities** tab only shows
events for that repository.

After selecting a category—**Organization**, **Repository**, or **Billing**—use
the **All Actions** drop-down to refine the results even further by specific
event type.

> [!NOTE]
>
> Events triggered by Docker Support appear under the username **dockersupport**.

Check failure on line 66 in content/manuals/admin/organization/activity-logs.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'dockersupport'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'dockersupport'?", "location": {"path": "content/manuals/admin/organization/activity-logs.md", "range": {"start": {"line": 66, "column": 66}}}, "severity": "ERROR"}

> [!IMPORTANT]
>
> Docker retains activity logs for three months. To maintain access to older
data, export logs regularly.

## Types of activity log events

Refer to the following section for a list of events and their descriptions:

Expand Down
26 changes: 16 additions & 10 deletions content/manuals/admin/organization/deactivate-account.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,46 +1,52 @@
---
title: Deactivate an organization
description: Learn how to deactivate a Docker organization.
keywords: Docker Hub, delete, deactivate organization, account, organization management
description: Learn how to deactivate a Docker organization and required prerequisite steps.
keywords: delete, deactivate organization, account, organization management, Admin Console, cancel subscription
weight: 42
aliases:
- /docker-hub/deactivate-account/
---

{{< summary-bar feature_name="General admin" >}}

You can deactivate an account at any time. This section describes the prerequisites and steps to deactivate an organization account. For information on deactivating a user account, see [Deactivate a user account](../../accounts/deactivate-user-account.md).
Learn how to deactivate a Docker organization, including required prerequisite
steps. For information about deactivating user
accounts, see [Deactivate a user account](../../accounts/deactivate-user-account.md).

> [!WARNING]
>
> All Docker products and services that use your Docker account or organization account will be inaccessible after deactivating your account.
> All Docker products and services that use your Docker account or organization
account will be inaccessible after deactivating your account.

## Prerequisites

Before deactivating an organization, complete the following:
You must complete all the following steps before you can deactivate your
organization:

- Download any images and tags you want to keep:
`docker pull -a <image>:<tag>`.
- If you have an active Docker subscription, [downgrade it to a free subscription](../../subscription/change.md).
- Remove all other members within the organization.
- Unlink your [Github and Bitbucket accounts](../../docker-hub/repos/manage/builds/link-source.md#unlink-a-github-user-account).
- Unlink your [GitHub and Bitbucket accounts](../../docker-hub/repos/manage/builds/link-source.md#unlink-a-github-user-account).
- For Business organizations, [remove your SSO connection](../../security/for-admins/single-sign-on/manage/#remove-an-organization).

## Deactivate

Once you have completed all the previous steps, you can deactivate your organization.
You can deactivate your organization using either the Admin Console or
Docker Hub.

> [!WARNING]
>
> This cannot be undone. Be sure you've gathered all the data you need from your organization before deactivating it.
> This cannot be undone. Be sure you've gathered all the data you need from
your organization before deactivating it.

{{< tabs >}}
{{< tab name="Admin Console" >}}

1. Sign in to [Docker Home](https://app.docker.com) and select the organization
you want to deactivate.
1. Select **Admin Console**, then **Deactivate**. If this button is greyed out,
you must complete the [Prerequisites](#prerequisites).
1. Select **Admin Console**, then **Deactivate**. If the **Deactivate**
button is unavailable, confirm you've completed all [Prerequisites](#prerequisites).
1. Enter the organization name to confirm deactivation.
1. Select **Deactivate organization**.

Expand Down
23 changes: 14 additions & 9 deletions content/manuals/admin/organization/general-settings.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: Organization settings
title: Organization information
weight: 60
description: Learn how to manage settings for organizations using Docker Admin Console.
keywords: organization, settings, Admin Console
keywords: organization, settings, Admin Console, manage, Docker organization, Gravatar, SCIM, SSO setup, domain management, organization settings
---

This section describes how to manage organization settings in the Docker Admin Console.
Learn how to update your organization information using the Admin Console.

## Configure organization information
## Update organization information

General organization information appears on your organization landing page in the Admin Console.

Expand All @@ -17,14 +17,19 @@ This information includes:
- Company
- Location
- Website
- Gravatar email: To add an avatar to your Docker account, create a [Gravatar account](https://gravatar.com/) and create your avatar. Next, add your Gravatar email to your Docker account settings. It may take some time for your avatar to update in Docker.
- Gravatar email: To add an avatar to your Docker account, create a [Gravatar account](https://gravatar.com/) and upload an avatar. Next, add your Gravatar email to your Docker account settings. It may take some time for your avatar to update in Docker.

To edit this information:

1. Sign in to the [Admin Console](https://app.docker.com/admin).
1. Select your company on the **Choose profile** page.
1. Specify the organization information and select **Save**.
1. Sign in to the [Admin Console](https://app.docker.com/admin) and
select your organization.
1. Enter or update your organization’s details, then select **Save**.

## Next steps

In the **Organization settings** menu, you can also [configure SSO](../../security/for-admins/single-sign-on/configure/) and [set up SCIM](../../security/for-admins/provisioning/scim.md). If your organization isn't part of a company, from here you can also [manage your domains](/manuals/security/for-admins/domain-management.md) or [create a company](new-company.md).
After configuring your organization information, you can:

- [Configure single sign-on (SSO)](../../security/for-admins/single-sign-on/configure/)
- [Set up SCIM provisioning](../../security/for-admins/provisioning/scim.md)
- [Manage domains](../../security/for-admins/domain-management.md)
- [Create a company](new-company.md)
35 changes: 19 additions & 16 deletions content/manuals/admin/organization/insights.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
description: Gain insights about your organization's users and their Docker usage.
keywords: organization, insights
title: Insights
description: Gain insights about your organization's users and their Docker usage.
keywords: organization, insights, Docker Desktop analytics, user usage statistics, Docker Business, track Docker activity
---

{{< summary-bar feature_name="Insights" >}}
Expand All @@ -13,26 +13,29 @@ productivity and efficiency across the organization.

Key benefits include:

- Uniform working environment. Establish and maintain standardized
- Uniform working environment: Establish and maintain standardized
configurations across teams.
- Best practices. Promote and enforce usage guidelines to ensure optimal
- Best practices: Promote and enforce usage guidelines to ensure optimal
performance.
- Increased visibility. Monitor and drive adoption of organizational
- Increased visibility: Monitor and drive adoption of organizational
configurations and policies.
- Optimized license use. Ensure that developers have access to advanced
- Optimized license use: Ensure that developers have access to advanced
features provided by a Docker subscription.

## Prerequisites

To use Insights, you must meet the following requirements:

- [Docker Business subscription](../../subscription/details.md#docker-business)
- Administrators must [enforce sign-in](/security/for-admins/enforce-sign-in/) for users
- Insights enabled by your Customer Success Manager
- Administrators must [enforce sign-in](/security/for-admins/enforce-sign-in/)
for users
- Your Customer Success Manager must turn on Insights for your organization

## View Insights for organization users

To access Insights, you must contact your Customer Success Manager to have the
feature enabled. Once the feature is enabled, access Insights using the following
steps:
To access Insights, contact your Customer Success Manager to have the
feature turned on. Once the feature is turned on, access Insights using the
following steps:

1. Sign in to [Docker Home](https://app.docker.com/) and choose
your organization.
Expand All @@ -44,7 +47,7 @@ your organization.
> Insights page, view the **Last updated** date to understand when the data was
> last updated.

You can view data in the following charts:
Insights data is displayed in the following charts:

- [Docker Desktop users](#docker-desktop-users)
- [Builds](#builds)
Expand Down Expand Up @@ -187,20 +190,20 @@ installed
## Troubleshoot Insights

If you’re experiencing issues with data in Insights, consider the following
solutions to resolve common problems.
solutions to resolve common problems:

- Update users to the latest version of Docker Desktop.

Data is not shown for users using versions 4.16 or lower of Docker Desktop.
In addition, older versions may not provide all data. Ensure all users have
installed the latest version of Docker Desktop.

- Enable **Send usage statistics** in Docker Desktop for all your users.
- Turn on **Send usage statistics** in Docker Desktop for all your users.

If users have opted out of sending usage statistics for Docker Desktop, then
their usage data will not be a part of Insights. To manage the setting at
scale for all your users, you can use [Settings
Management](/desktop/hardened-desktop/settings-management/) and enable the
Management](/desktop/hardened-desktop/settings-management/) and turn on the
`analyticsEnabled` setting.

- Ensure users use Docker Desktop and aren't using the standalone
Expand All @@ -210,7 +213,7 @@ solutions to resolve common problems.
Engine outside of Docker Desktop, Docker Engine won't provide
data for that user.

- Ensure that users are signing in to an account associated with your
- Make sure users sign in to an account associated with your
organization.

Users who don’t sign in to an account associated with your organization are
Expand Down
Loading