Amazon CodeCatalyst is no longer open to new customers. Existing customers can continue to use the service as normal. For more information, see [How to migrate from CodeCatalyst](migration.md).

# Configuring and using package repositories
<a name="packages-repositories"></a>

In CodeCatalyst, packages are stored and managed inside package repositories. To publish packages to CodeCatalyst or to consume packages from a CodeCatalyst (or any supported public package repositories), you must create a package repository and connect your package manager to it.

**Topics**
+ [Creating a package repository](packages-repositories-create.md)
+ [Connecting to a package repository](packages-repositories-connect.md)
+ [Deleting a package repository](packages-repositories-delete.md)

# Creating a package repository
<a name="packages-repositories-create"></a>

Perform the following steps to create a package repository in CodeCatalyst.

**To create a package repository**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to the project in which you want to create a package repository.

1. From the navigation pane, choose **Packages**.

1. On the **Package repositories** page, choose **Create package repository**.

1. In the **Package repository details** section, add the following:

   1. **Repository name**. Consider using a descriptive name with details such as your project or team name, or how the repository will be used.

   1. (Optional) **Description**. A repository description is especially helpful when you have multiple repositories across multiple teams in a project.

1. In the **Upstream repositories** section, choose **Select upstream repositories** to add any package repositories that you want to access through your CodeCatalyst package repository. You can add **Gateway repositories** to connect to external package repositories or other **CodeCatalyst repositories**.

   1. When a package is requested from a package repository, upstream repositories will be searched in the order they appear in this list. Once a package is found, CodeCatalyst will stop searching. To change the order of the upstream repositories, you can drag and drop the repositories in the list.

1. Choose **Create** to create your package repository.

# Connecting to a package repository
<a name="packages-repositories-connect"></a>

To publish to, or consume packages from CodeCatalyst, you must configure your package manager with your package repository endpoint information and CodeCatalyst credentials. If you haven't created a repository, you can do so by following the instructions in [Creating a package repository](packages-repositories-create.md).

For instructions on how to connect a package manager to a CodeCatalyst package repository, see the following documentation.
+ [Configuring and using Gradle Groovy](packages-maven-gradle.md)
+ [Configuring and using mvn](packages-maven-mvn.md)
+ [Configuring and using the nuget or dotnet CLI](packages-nuget-cli.md)
+ [Configuring and using npm](packages-npm-use.md)
+ [Configuring pip and installing Python packages](packages-python-pip.md)
+ [Configuring Twine and publishing Python packages](packages-python-twine.md)

# Deleting a package repository
<a name="packages-repositories-delete"></a>

Perform the following steps to delete a package repository in CodeCatalyst.

**To delete a package repository**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to the project that contains the package repository that you want to delete.

1. From the navigation pane, choose **Packages**.

1. On the **Package repositories** page, choose the repository you want to delete.

1. Choose **Delete**.

1. Review the information provided about the effects of deleting a package repository.

1. Enter `delete` into the input field and choose **Delete**.