Create a Docker Repository

JFrog Artifactory Documentation
Products
JFrog Artifactory
Content Type
User Guide

This topic describes how to create a Docker Repository. This is required before pushing and pulling Docker images. There are three primary types of repositories:

  • Local repositories: Store and share first- and second-party packages with your organization

  • Remote repositories: Download from any remote location, including external package registries or other Artifactory instances

  • Virtual repositories: Aggregate remote and local repositories, enabling your organization to scale by providing a single URL to access multiple repositories and package types

For more information about JFrog repositories, see Repository Management Overview.

Prerequisite: You need Admin or Project Admin permissions to create a Docker repository. If you don't have Admin permissions, the option will not be available.

To create a Docker repository:

  1. In the Administration tab, click Repositories | Create a Repository.

    CreateAnsibleLocal1.png

  2. Select the type of repository you want to create: Local, Remote, or Virtual.

  3. Select the Docker package type.

  4. Configure the required fields for the repository:

    Note

    Do not use underscores in the repository name. Due to subdomain/DNS/hostname limitations, Docker cannot communicate with registries that have underscores in the name.

    For example, do not use the name docker_dev_local. Instead, use docker-dev-local or docker.dev.local.

    • For Local Repositories:

      • In the Repository Key field type a meaningful name for the repository. For example, docker-dev-local.

      • In the Docker Settings section, set the API version to V2.

      • Set the Max Unique Tags and Docker Tag Retention values. For more information, see Tag Retention Logic.

      For more information on local repositories and all its possible settings, see Local Repositories.

    • For Remote Repositories, additionally verify the Repository URL and update it if needed.

      Artifactory provides Cloud users with unlimited, high-performance, unauthenticated access to Docker Hub at https://registry-1.docker.io/. To avoid rate limits and to pull images from private repositories, authenticate your Docker Hub connection by entering your credentials in the User Name and Password/Access Token fields. Self-Hosted deployments of Artifactory are subject to rate limits.

      For more information on Remote Repositories and all its possible settings, see Remote Repositories.

    • For Virtual Repositories, additionally select one or more local or remote Docker repositories to include in the virtual repository. Optionally, set a default deployment repository. For more information on virtual repositories and all its possible settings, see Virtual Repositories.

      To learn how to configure virtual Docker repositories to pull images based on modification time, see Resolve Latest Docker Image.

  5. Click Create Repository.

    The repository is created and the Repositories window is displayed.

Related Topics