1.1.0 • Public • Published


This package is a utility for use with Directus. It retrieves and extracts extensions from Github repositories into your Directus installation.

Its creation was due to the need for a way to install Directus extensions when deploying on Kubernetes. You can run this tool before npx directus bootstrap to install extensions on your Directus pods by overriding the command argument. Example override:

        - sh
        - -c
        - npx directus-extensions-installer install;
          npx directus bootstrap && npx directus start;

Configuration for this tool is given in the form of environment variables for indicating directories as well as a .yaml file for the extensions themselves. This way you can mount a ConfigMap as a YAML file inside the image, and then just point the tool to it.


npx directus-extensions-installer

You may also specify options in the command line if you wish to override the defaults without setting environment variables.

--directus-dir Indicates the Directus installation directory. This variable is used to find out where to extract downloads to. /directus
--download-dir Directory to download the extensions to. If it doesn't exist, it'll be created. This is deleted after use. ./downloads
--config Points to the .yaml file which includes the extensions' specifications. ./extensions.yaml
--keepConfig Determines whether the configuration file will be kept after the operations. This is because they may contain sensitive information, like tokens. false

If you wish to download a release from an extension repository located at, then you'd use an extensions.yaml that would look like so:

- name: extension-name
  owner: foo
  repo: bar-extension
  type: module

You can specifiy multiple extensions.

YAML config file model:

name required string The extension's name.
owner required string Name of the repository's owner in the Github link. Example: has 'foo' as the owner.
repo required string Repository's name.
type required string Type of extension. Valid values include only one of the Directus extension types: "module", "interface", "display" or "layout".
token optional string Github personal token. Only necessary if the specified repository is private. The token should have the appropriate permissions to read the repository. If invalid, you'll receive an error stating that the asset was not found.
tag optional string Specify a tag to use for downloading the extension. Defaults to latest.

Current limitations

  • Currently only supports extensions available for download as .zip.
  • If run more than once it will install duplicates.
  • Does not check for duplicates in extensions.yaml.


  • If your Github permission tokens are invalid, it'll throw an error stating that it was not found (instead of saying that you are unauthorized), so make sure your token is valid.


DownloadsWeekly Downloads






Unpacked Size

27 kB

Total Files


Last publish


  • v1210n