Skip to content

Commit 1ab3b48

Browse files
admin: FAQ freshness (#23041)
## Description - FAQ freshness for Admin section - Renamed General to Accounts - Removed unnecessary/bad FAQs, verified the ones I removed _are_ covered in regular manual pages in the Admin section ## Reviews - [ ] Editorial review
1 parent 1b70e4d commit 1ab3b48

File tree

4 files changed

+75
-151
lines changed

4 files changed

+75
-151
lines changed

content/manuals/admin/faqs/_index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
build:
33
render: never
4+
linkTitle: FAQ
45
title: Account and admin FAQ
56
weight: 30
67
---

content/manuals/admin/faqs/company-faqs.md

Lines changed: 9 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -10,25 +10,17 @@ aliases:
1010
- /faq/admin/company-faqs/
1111
---
1212

13-
### Are existing subscriptions affected when you create a company and add organizations to it?
14-
15-
You can manage subscriptions and related billing details at the organization level.
16-
1713
### Some of my organizations don’t have a Docker Business subscription. Can I still use a parent company?
1814

19-
Yes, but you can only add organizations with a Docker Business subscription to a company.
15+
Yes, but you can only add organizations with a Docker Business subscription
16+
to a company.
2017

2118
### What happens if one of my organizations downgrades from Docker Business, but I still need access as a company owner?
2219

23-
To access and manage child organizations, the organization must have a Docker Business subscription. If the organization isn’t included in this subscription, the owner of the organization must manage the organization outside of the company.
24-
25-
### Does my organization need to prepare for downtime during the migration process?
26-
27-
No, you can continue with business as usual.
28-
29-
### How many company owners can I add?
30-
31-
You can add a maximum of 10 company owners to a single company account.
20+
To access and manage child organizations, the organization must have a
21+
Docker Business subscription. If the organization isn’t included in this
22+
subscription, the owner of the organization must manage the organization
23+
outside of the company.
3224

3325
### Do company owners occupy a subscription seat?
3426

@@ -51,37 +43,7 @@ subscription seat.
5143

5244
### What permissions does the company owner have in the associated/nested organizations?
5345

54-
Company owners can navigate to the **Organizations** page to view all their nested organizations in a single location. They can also view or edit organization members and change single sign-on (SSO) and System for Cross-domain Identity Management (SCIM) settings. Changes to company settings impact all users in each organization under the company. For more information, see [Roles and permissions](../../security/for-admins/roles-and-permissions.md).
55-
56-
### What features are supported at the company level?
57-
58-
You can manage domain verification, SSO, and SCIM at the company level. The following features aren't supported at the company level, but you can manage them at the organization level:
59-
60-
- Image Access Management
61-
- Registry Access Management
62-
- User management
63-
- Billing
64-
65-
To view and manage users across all the organizations under your company, you can [manage users at the company level](../../admin/company/users.md) when you use the [Admin Console](https://app.docker.com/admin).
66-
67-
Domain audit isn't supported for companies or organizations within a company.
68-
69-
### What's required to create a company name?
70-
71-
A company name must be unique to that of its child organization. If a child organization requires the same name as a company, you should modify it slightly. For example, **Docker Inc** (parent company), **Docker** (child organization).
72-
73-
### How does a company owner add an organization to the company?
74-
75-
You can add organizations to a company in the Admin Console. For more information, see [Add organizations to a company](../../admin/company/organizations.md#add-organizations-to-a-company.md).
76-
77-
### How does a company owner manage SSO/SCIM settings for a company?
78-
79-
See your [SCIM](scim.md) and [SSO](../../security/for-admins/single-sign-on/configure/_index.md) settings.
80-
81-
### How does a company owner enable group mapping in an IdP?
82-
83-
See [SCIM](scim.md) and [group mapping](../../security/for-admins/provisioning/group-mapping.md) for more information.
84-
85-
### What's the definition of a company versus an organization?
46+
Company owners can navigate to the **Organizations** page to view all their
47+
nested organizations in a single location. They can also view or edit organization members and change single sign-on (SSO) and System for Cross-domain Identity Management (SCIM) settings. Changes to company settings impact all users in each organization under the company.
8648

87-
A company is a collection of organizations that are managed together. An organization is a collection of repositories and teams that are managed together.
49+
For more information, see [Roles and permissions](../../security/for-admins/roles-and-permissions.md).
Lines changed: 32 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: General FAQs for Docker accounts
3-
linkTitle: General
2+
title: FAQs on Docker accounts
3+
linkTitle: Accounts
44
weight: 10
55
description: Frequently asked Docker account and administration questions
66
keywords: onboarding, docker, teams, orgs, user accounts, organization accounts
@@ -13,56 +13,47 @@ aliases:
1313

1414
### What is a Docker ID?
1515

16-
A Docker ID is a username for your Docker account that lets you access Docker products. To create a Docker ID, you need an email address or you can sign up with your social or GitHub accounts. Your Docker ID must be between 4 and 30 characters long, and can only contain numbers and lowercase letters. You can't use any special characters or spaces.
16+
A Docker ID is a username for your Docker account that lets you access Docker
17+
products. To create a Docker ID you need one of the following:
1718

18-
For more information, see [Docker ID](/accounts/create-account/). If your administrator enforces [single sign-on (SSO)](../../security/for-admins/single-sign-on/_index.md), this provisions a Docker ID for new users.
19+
- An email address
20+
- A social account
21+
- A GitHub account
1922

20-
Developers may have multiple Docker IDs in order to separate their Docker IDs associated with an organization with a Docker Business or Team subscription, and their personal use Docker IDs.
23+
Your Docker ID must be between 4 and 30 characters long, and can only contain
24+
numbers and lowercase letters. You can't use any special characters or spaces.
25+
26+
For more information, see [Create a Docker ID](/accounts/create-account/).
2127

2228
### Can I change my Docker ID?
2329

24-
No. You can't change your Docker ID once it's created. If you need a different Docker ID, you must create a new Docker account with a new Docker ID.
30+
No. You can't change your Docker ID once it's created. If you need a different
31+
Docker ID, you must create a new Docker account with a new Docker ID.
2532

26-
Additionally, you can't reuse a Docker ID in the future if you deactivate your account.
33+
Docker IDs can't be reused after deactivation.
2734

2835
### What if my Docker ID is taken?
2936

30-
All Docker IDs are first-come, first-served except for companies that have a U.S. Trademark on a username. If you have a trademark for your namespace, [Docker Support](https://hub.docker.com/support/contact/) can retrieve the Docker ID for you.
31-
32-
### What’s an organization?
37+
All Docker IDs are first-come, first-served except for companies that have a
38+
U.S. Trademark on a username.
3339

34-
An organization in Docker is a collection of teams and repositories that are managed together. Docker users become members of an organization once they're associated with that organization by an organization owner. An [organization owner](#who-is-an-organization-owner) is a user with administrative access to the organization. For more information on creating organizations, see [Create your organization](orgs.md).
40+
If you have a trademark for your namespace,
41+
[Docker Support](https://hub.docker.com/support/contact/) can retrieve the
42+
Docker ID for you.
3543

3644
### What's an organization name or namespace?
3745

38-
The organization name, sometimes referred to as the organization namespace or the organization ID, is the unique identifier of a Docker organization. The organization name can't be the same as an existing Docker ID.
39-
40-
### What are roles?
41-
42-
A role is a collection of permissions granted to members. Roles define access to perform actions in Docker Hub like creating repositories, managing tags, or viewing teams. See [Roles and permissions](roles-and-permissions.md).
43-
44-
### What’s a team?
45-
46-
A team is a group of Docker users that belong to an organization. An organization can have multiple teams. An organization owner can then create new teams and add members to an existing team using Docker IDs or email address and by selecting a team the user should be part of. See [Create and manage a team](manage-a-team.md).
47-
48-
### What's a company?
49-
50-
A company is a management layer that centralizes administration of multiple organizations. Administrators can add organizations with a Docker Business subscription to a company and configure settings for all organizations under the company. See [Set up your company](/admin/company/).
46+
The organization name, sometimes referred to as the organization namespace or
47+
the organization ID, is the unique identifier of a Docker organization. The
48+
organization name can't be the same as an existing Docker ID.
5149

5250
### Who is an organization owner?
5351

54-
An organization owner is an administrator who has permissions to manage
55-
repositories, add members, and manage member roles. They have full access to
56-
private repositories, all teams, billing information, and organization settings.
57-
An organization owner can also specify [repository permissions](manage-a-team.md#configure-repository-permissions-for-a-team) for each team in the
58-
organization. Only an organization owner can enable SSO for the organization.
59-
When SSO is enabled for your organization, the organization owner can also
60-
manage users.
52+
An organization owner is a member who has administrator permissions. They
53+
have full access to private repositories, all teams, billing information, and
54+
organization settings.
6155

62-
Docker can auto-provision Docker IDs for new end-users or users who'd like to
63-
have a separate Docker ID for company use through SSO enforcement.
64-
65-
The organization owner can also add additional owners to help them manage users, teams, and repositories in the organization.
56+
For more information on the organization owner role, see [Roles and permissions](/manuals/security/for-admins/roles-and-permissions.md).
6657

6758
### Can I configure multiple SSO identity providers (IdPs) to authenticate users to a single org?
6859

@@ -71,26 +62,14 @@ information, see [Configure SSO](../../security/for-admins/single-sign-on/config
7162

7263
### What is a service account?
7364

74-
> [!IMPORTANT]
75-
>
76-
> As of December 10, 2024, service accounts are no longer available. Existing Service Account agreements will be honored until their current term expires, but new purchases or renewals of service accounts no longer available and customers must renew under a new subscription. It is recommended to transition to Organization Access Tokens (OATs), which can provide similar functionality. For more information, see [Organization access tokens (Beta)](/manuals/security/for-admins/access-tokens.md).
65+
Service accounts were deprecated on December 10, 2024. Existing Service Account
66+
agreements will be honored until their current term expires, but new purchases
67+
or renewals of service accounts are no longer available and customers must renew
68+
under a new subscription.
7769

78-
A [service account](../../docker-hub/service-accounts.md) is a Docker ID used for automated management of container images or containerized applications. Service accounts are typically used in automated workflows, and don't share Docker IDs with the members in the Team or Business subscription. Common use cases for service accounts include mirroring content on Docker Hub, or tying in image pulls from your CI/CD process.
70+
For similar functionality,
71+
transition to [Organization access tokens](/manuals/security/for-admins/access-tokens.md).
7972

8073
### Can I delete or deactivate a Docker account for another user?
8174

8275
Only someone with access to the Docker account can deactivate the account. For more details, see [Deactivating an account](../../admin/organization/deactivate-account.md).
83-
84-
If the user is a member of your organization, you can remove the user from your organization. For more details, see [Remove a member or invitee](../../admin/organization/members.md#remove-a-member-from-a-team).
85-
86-
### How do I manage settings for a user account?
87-
88-
You can manage your account settings anytime when you sign in to your [Docker account](https://app.docker.com/login). Select your avatar in the top-right navigation, then select **My Account**.
89-
90-
You can also access this menu from any Docker web applications when you're signed in to your account. See [Manage your Docker account](/accounts/manage-account). If your account is associated with an organization that uses SSO, you may have limited access to the settings that you can control.
91-
92-
### How do I add an avatar to my Docker account?
93-
94-
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.
95-
96-
Note, that it may take some time for your avatar to update in Docker.

0 commit comments

Comments
 (0)