mirror of https://github.com/docker/docs.git
59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
---
|
|
description: Learn how to create a repository on Docker Hub
|
|
keywords: Docker Hub, Hub, repositories, create
|
|
title: Create a repository
|
|
linkTitle: Create
|
|
toc_max: 3
|
|
weight: 20
|
|
---
|
|
|
|
1. Sign in to [Docker Hub](https://hub.docker.com).
|
|
2. Select **My Hub** > **Repositories**.
|
|
3. Near the top-right corner, select **Create repository**.
|
|
4. Select a **Namespace**.
|
|
|
|
You can choose to locate it under your own user account, or under any
|
|
organization where you are an owner or editor.
|
|
|
|
5. Specify the **Repository Name**.
|
|
|
|
The repository name needs to:
|
|
- Be unique
|
|
- Have between 2 and 255 characters
|
|
- Only contain lowercase letters, numbers, hyphens (`-`), and underscores
|
|
(`_`)
|
|
|
|
> [!NOTE]
|
|
>
|
|
> You can't rename a Docker Hub repository once it's created.
|
|
|
|
6. Specify the **Short description**.
|
|
|
|
The description can be up to 100 characters. It appears in search results.
|
|
|
|
7. Select the default visibility.
|
|
|
|
- **Public**: The repository appears in Docker Hub search results and can be
|
|
pulled by everyone.
|
|
- **Private**: The repository doesn't appear in Docker Hub search results and
|
|
is only accessible to you and collaborators. In addition, if you selected
|
|
an organization's namespace, then the repository is accessible to those
|
|
with applicable roles or permissions. For more details, see [Roles and
|
|
permissions](../../security/for-admins/roles-and-permissions.md).
|
|
|
|
> [!NOTE]
|
|
>
|
|
> For organizations creating a new repository, if you're unsure which
|
|
> visibility to choose, then Docker recommends that you select **Private**.
|
|
|
|
8. Select **Create**.
|
|
|
|
After the repository is created, the **General** page appears. You are now able to manage:
|
|
|
|
- [Repository information](./manage/information.md)
|
|
- [Access](./manage/access.md)
|
|
- [Images](./manage/hub-images/_index.md)
|
|
- [Automated builds](./manage/builds/_index.md)
|
|
- [Webhooks](./manage/webhooks.md)
|
|
- [Image security insights](./manage/vulnerability-scanning.md)
|