Skip to main content

Private Registry

The Private Registry is your own cloud storage for custom container images. Push an image once and it becomes available to every device registered to your account.

LLM Launcher → Private Registry.

Video placeholder

LLM-Launcher/private-registry.mp4 — creating a repository, adding a tag from a device, waiting for it to replicate, copying the pull command, and starting an environment from the tag.

note

Container storage is part of your Cordatus plan. When it is full, repository cards show Quota Limit Reached and the Add Tag action is disabled until you delete tags or upgrade.


Repositories

Creating one

  1. Create Repository.
  2. Repository Name — lowercase letters, numbers and hyphens only. No spaces, no uppercase.
  3. Description (optional) — used as the repository's README.
  4. Create Repository.

The repository exists but holds no image yet; add a tag next.

The repository card

Each card shows the repository name, its description, whether it is Empty or Has Tags, and:

  • List Tags — opens the repository.
  • Add Tag — pushes an image into it. Disabled while the repository quota is full or, on an empty repository, guiding you to add a tag first.
  • More Options → Delete Repository.

If you have none yet, the page shows No Repositories Yet rather than an empty grid.


Tags

Adding a tag

Add Tag opens Create and push a new container tag:

  1. Device — a connected device that already holds the image. Only connected devices are listed; until you pick one the image field says "Please select a device first".
  2. Image — the Docker images present on that device.
  3. Tag Name — lowercase letters, numbers and hyphens. For example 2022.03-py38.
  4. Use this tag as an engine (optional) — turn this on if the image is an inference engine Cordatus should be able to launch as one. It then asks for:
    • Label — how the engine is shown (for example My Engine Label).
    • Container Name — a unique name that distinguishes the container.
    • Script Path — the path of the script that starts the engine.
  5. Create Tag.

Cordatus creates the tag on the device, uploads it to the Cordatus Container Registry and replicates it. When that finishes, the image is reachable from all your devices.

Tag status codes

StatusMeaning
PreparingA new tag is being created from the original image.
UploadingThe tag is being uploaded.
ReplicatingReplication across the registry has started.
ReadyUploaded and replicated — ready to use.
ErrorSomething failed during upload.

The tag list

List Tags opens the repository with two tabs:

  • Overview — the repository description, editable in place ("You can create your own description! Start typing…"), with Save.
  • Tags — every tag pushed, with its status, size and date.

Per tag:

ActionResult
Copy Pull CommandPuts the docker pull line for that tag on your clipboard.
Start EnvironmentLaunches it — see below.
More Options → Edit TagReopens the engine configuration (Label, Container Name, Script Path, Use this tag as an engine).
More Options → Delete TagRemoves it.
Delete SelectedRemoves several at once.

The left panel shows the repository's properties: Description, Latest Tag, Uncompressed Size and Modified Date.


Starting an environment from a tag

  1. Open the repository with List Tags.
  2. Press Start Environment on the tag you want.
  3. Select Device — a connected device.
  4. Advanced Configuration — the rail, as usual.
note

There is no version step on this path: the tag you started from is the version, so the wizard goes straight from device to configuration.

What you can configure:

  • Environment Name — generated if left blank.
  • Compute — GPUs (individually or Use all) and Host limits (Auto or Custom).
  • Overrides — container options, environment variables, engine flags and the notebook.
    • Attached folders — bind host directories into the container, for example a dataset path. Use Add Folder Binding with a Source Folder on the device and a Target Folder in the container; you can add as many as you need.
    • Jupyter — runs inside the same container, protected with a token or a password, or unprotected on an isolated network.
  • Review & start — the resulting command and the containers that will be created.

Start Environment pulls the image if the device does not have it, then starts it. The container appears on the Containers page, where its Ports tab gives you the local address, the notebook URL and any public URL.

For the full description of each pane, see the Launch Guide.


Deleting

  • More Options → Delete Repository on the card removes the repository and everything in it.
  • More Options → Delete Tag, or Delete Selected, removes individual tags.

Deleting tags is also how you free storage when you hit Quota Limit Reached.