---
title: Packaging
generated: true
---

<!-- Generated from docs/glossary.yml by tools/build-public-docs.mjs. Do not edit; edit the term. -->

# Packaging

8 words that belong together: Release, Release name, Dirty build, Client Image, Publish, Grant, Mothership, Provenance.

## Release

**Plain word:** A named version you can point at.

One name taken from a git tag that the source zip, the image, the tarball and the customer's download all carry, so a running image maps back to a commit.

Related: [Slingshot](/concepts/enablement) · [Enablement](/concepts/enablement).

Where it is used: [Install](/01-start/install).

[In the glossary](/glossary#release).

## Release name

**Plain word:** The version string.

Taken from git by releaseStamp, the exact tag if there is one and otherwise the short commit, and never typed by a person.

[In the glossary](/glossary#release-name).

## Dirty build

**Plain word:** Built from work you had not committed.

An image whose name ends -dirty because the tree had uncommitted or untracked files, so nobody can rebuild it from git, including us.

[In the glossary](/glossary#dirty-build).

## Client Image

**Plain word:** The copy a customer runs.

A StellarView image with nothing of the operator in it, which is the opposite of a Replicant even though both come out of the same build today.

[In the glossary](/glossary#client-image).

## Publish

**Plain word:** Put the download in the bucket.

Save the built image as a tarball under its release name so a grant has something real to point at. It tells nobody.

Where it is used: [Use it from Claude Code](/01-start/claude-code) · [Keys](/01-start/keys).

[In the glossary](/glossary#publish).

## Grant

**Plain word:** Give one person a download link.

Record a customer, issue a token for one published release, and print the link. It emails nobody unless you add --send.

Where it is used: [Install](/01-start/install) · [Support](/04-operate/support).

[In the glossary](/glossary#grant).

## Mothership

**Plain word:** The StellarView source itself.

The repository every client image is cut from, as opposed to the galaxies and apps StellarView builds for other people.

Related: [Joey](/glossary#joey).

[In the glossary](/glossary#mothership).

## Provenance

**Plain word:** Every artefact knows which commit it came from.

The commit travels with the thing itself, not in a note beside it - on the published tarball, on the AMI's tags, and in the version the running container reports. Which commit is this customer on is answerable from AWS alone, a year later, without the repository to hand.

[In the glossary](/glossary#provenance).

