Create a Composer Repository

JFrog Artifactory Documentation
Products
JFrog Artifactory
Content Type
User Guide

This topic describes how to create a Composer repository. This is required before publishing and installing Composer packages. There are three primary types of repositories:

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

    Composer 1.x Deprecation

    Composer 1.x is no longer supported on Packagist as of September 1, 2025. Artifactory will continue to support Composer 1.x for local repositories until December 2026.

  • Remote repositories: Download packages from remote locations, 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 that provides access to multiple repositories and types

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

Prerequisite: You need Admin or Project Admin permissions in Artifactory to create a repository.

To create a Composer 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 Composer package type.

  4. Configure the required fields for the repository:

    Version Requirements

    Composer 2.0 is required for remote and virtual repositories, and the remote registry you are proxying must support Composer 2.0 in order to work with Artifactory.

    • For local repositories, in the Repository Key field, type a meaningful name for the repository. For example, composer-local. For more information on local repositories and their settings, see Local Repositories.

    • For remote repositories, verify the Repository URL and update as needed. For more information on remote repositories and their settings, see Remote Repositories.

      The Packagist registry at https://packagist.org/ is the main Composer registry. Packagist does not host any binary packages, but instead contains indexes that direct to the corresponding source control repository where the package is hosted.

    • For virtual repositories, select one or more local or remote repository types to include in the virtual repository. For more information on virtual repositories and their settings, see Virtual Repositories.

  5. Click Create Repository. The repository is created and the Repositories window is displayed.