Skip to content

Internal packages

This page describes how to configure Composer to use the GitLab's package registry for internal morphsites® packages.

Local development

Create a personal access token with API scope at https://gitlab.morphsites.net/-/user_settings/personal_access_tokens, then run:

shell
composer global config gitlab-token.gitlab.morphsites.net <access_token>

Also run the following for backwards compatibility:

shell
composer config gitlab-domains gitlab.morphsites.net

Then add the GitLab package repository as a Composer source:

shell
composer config repositories.gitlab composer https://gitlab.morphsites.net/api/v4/group/64/-/packages/composer/

On a server

Create a deploy token on the morphsites/lib group at https://gitlab.morphsites.net/groups/morphsites/lib/-/settings/repository:

  • Name it after the user and server, e.g. example@prod1.uk.morphdigital.net
  • Select the read_package_registry scope

TIP

If you are unable to create a deploy token, ask a senior developer to create one for you.

Then run the following, replacing <username> and <password> with the deploy token credentials:

shell
composer global config gitlab-token.gitlab.morphsites.net <username> <password>