Skip to main content

Create a Swift Repository

To install (or publish) Swift packages, creation of a Swift repository is required. Check out Nexus Repository Management and Repository Types to learn more.

Swift Proxy Repository

Use Nexus proxy repository when you want to download packages and centralize package caching of external dependencies. To learn more, check Proxy Repositories.

To create a new Swift proxy repository, take the following steps:

Nexus One UI

  1. Navigate to SettingsRepositories.

  2. Select Create Repository.

  3. From the Select Format section, select Swift.

  4. From the Select Type section, select Proxy.

  5. In the form that appears, complete the required fields.

  6. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details. Click Continue.

  7. In the Enable Firewall section, select one of the following options:

    • Select Skip to leave Repository Firewall disabled.

    • Select Audit to monitor policy violations and malware.

    • Select Quarantine to block the download of components.

    The firewall options aren't available if your firewall isn't configured. To configure Sonatype Firewall with Nexus Repository, follow the instructions in Nexus Repository 3 Pro Setup. Note that Firewall support for Swift is available from IQ 208 and Nexus Repository 3.97.0 self-hosted versions..

  8. In the Enable RHC section, turn on Enable Repository Health Check to analyze components for security vulnerabilities and license issues. Leave it disabled to configure it later.

  9. Select Create Repository.

    swift-proxy-new_ui.png

Classic UI

  1. Navigate to SettingsRepository Repositories.

  2. Select Create repository.

  3. From the list of Recipes, select swift (proxy).

  4. In the form that appears, complete the required fields.

  5. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.

  6. Select Create repository.

    Swift_Proxy.png

Note

Swift remote repositories only support registries that implement the Swift Package Registry protocol.

As there is currently no official public Swift registry and URLs like https://swiftpackageregistry.com are only catalogs, Nexus Repository supports using only https://github.com/ as the Swift Remote Storage URL.

Swift Hosted Repository

Use Nexus hosted repository when you want to publish and store your own internal artifacts and third party components, so they can be consumed via Nexus. To learn more, check Hosted Repositories.

To create a new Swift hosted repository, take the following steps:

Nexus One UI

  1. Navigate to SettingsRepositories.

  2. Select Create Repository.

  3. From the Select Format section, select Swift.

  4. From the Select Type section, select Hosted.

  5. In the form that appears, complete the required fields.

    • Name, for example swift-hosted

    • Blob Store

  6. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.

  7. Select Create Repository.

    swift-hosted-new_ui.png

Classic UI

  1. Navigate to Settings → Repository → Repositories.

  2. Select Create repository.

  3. From the list of Recipes, select swift (hosted).

  4. In the form that appears, complete the required fields.

    • Repository Name, for example swift-hosted

    • Blob store

  5. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.

  6. Select Create repository.

    swift-hosted.png

Tip

To upload packages using the UI, see Uploading Components.

Swift Group Repository

Use Nexus group repository when you want to combine multiple other repositories (proxy, hosted, and other groups) and expose them through a single URL. To learn more, check Group Repositories.

To create a new Swift group repository, take the following steps:

Nexus One UI

  1. Navigate to SettingsRepositories.

  2. Select Create Repository.

  3. From the Select Format section, select Swift.

  4. From the Select Type section, select Group.

  5. In the form that appears, complete the required fields.

    • Name, for example swift-group

    • Blob Store

    • Member Repositories in the desired order

  6. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.

  7. Select Create Repository.

    swift-group-new_ui.png

Classic UI

  1. Navigate to SettingsRepository Repositories.

  2. Select Create repository.

  3. From the list of Recipes, select swift (group).

  4. In the form that appears, complete the required fields.

    • Repository Name, for example swift-group

    • Blob store

    • Member repositories in the desired order

  5. Complete the additional fields for configurations you wish to add for creating your repository. Available configurations differ by repository format and type. See Configurable Repository Fields for more details.

  6. Select Create repository.