Registry

When you run bulker activate, it fetches the manifest from a registry if not already cached. You can also load from a local file.

Linking to a registry

Set the registry_url in your config:

bulker config set registry_url=https://hub.bulker.io

Or edit the config file directly:

registry_url: https://hub.bulker.io

The default registry

The default registry is hub.bulker.io, backed by a GitHub repository served via GitHub Pages.

Contributing a manifest

1. Write a manifest YAML file (see Write a Manifest).
2. Fork or clone the hub.bulker.io repo.
3. Add your manifest under your namespace folder.
4. Name it manifestname.yaml (default tag) or manifestname_tag.yaml (versioned).
5. Open a pull request.

After merge, activate with: bulker activate namespace/manifestname:tag.

File naming convention:

• Default tag: namespace/crate_name.yaml
• Versioned tag: namespace/crate_name_1.0.yaml

Building your own registry

Set up your own registry using any file server with manifests organized by namespace. A GitHub repository served via GitHub Pages works well.

Structure your files as subfolders for namespaces, with filenames as {manifest}_{tag}.yaml. Then point your config to the new registry:

bulker config set registry_url=https://your-registry.example.com