7. Registries

Registries contain information about packages, such as available releases and dependencies, and where they can be downloaded. The General registry is the default one, and is installed automatically if there are no other registries installed.

Managing registries

Registries can be added, removed and updated from either the Pkg REPL or by using the functional API. In this section we will describe the REPL interface. The registry API is documented in the Registry API Reference section.

Adding registries

A custom registry can be added with the registry add command from the Pkg REPL. Usually this will be done with a URL to the registry.

If a custom registry has been installed causing the General registry to not be automatically installed, it is easy to add it manually: be added automatically. In that case, we can simply add the General

pkg> registry add General

and now all the packages registered in General are available for e.g. adding. To see which registries are currently installed you can use the registry status (or registry st) command

pkg> registry st
Registry Status
 [23338594] General (https://github.com/JuliaRegistries/General.git)

Registries are always added to the user depot, which is the first entry in DEPOT_PATH (cf. the Glossary section).

Registries from a package server

It is possible for a package server to be advertising additional available package registries. When Pkg runs with a clean Julia depot (e.g. after a fresh install), with a custom package server configured with JULIA_PKG_SERVER, it will automatically add all such available registries. If the depot already has some registries installed (e.g. General), the additional ones can easily be installed with the no-argument registry add command.

Removing registries

Registries can be removed with the registry remove (or registry rm) command. Here we remove the General registry

pkg> registry rm General
  Removing registry `General` from ~/.julia/registries/General

pkg> registry st
Registry Status
  (no registries found)

In case there are multiple registries named General installed you have to disambiguate with the uuid, just as when manipulating packages, e.g.

pkg> registry rm General=23338594-aafe-5451-b93e-139f81909106
  Removing registry `General` from ~/.julia/registries/General

Updating registries

The registry update (or registry up) command is available to update registries. Here we update the General registry:

pkg> registry up General
  Updating registry at `~/.julia/registries/General`
  Updating git-repo `https://github.com/JuliaRegistries/General`

and to update all installed registries just do:

pkg> registry up
  Updating registry at `~/.julia/registries/General`
  Updating git-repo `https://github.com/JuliaRegistries/General`

Registries automatically update once per session when a package operation is performed so it rarely has to be done manually.

Creating and maintaining registries

Pkg only provides client facilities for registries, rather than functionality to create or maintain them. However, Registrator.jl and LocalRegistry.jl provide ways to create and update registries, and RegistryCI.jl provides automated testing and merging functionality for maintaining a registry.