Skip to content
This repository was archived by the owner on Oct 6, 2025. It is now read-only.

Commit 3074cb2

Browse files
ekcaseyekcasey
committed
update docs
Signed-off-by: Emily Casey <[email protected]>
1 parent c3466c3 commit 3074cb2

File tree

7 files changed

+40
-33
lines changed

7 files changed

+40
-33
lines changed

‎docs/reference/docker_model_package.yaml‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
command: docker model package
22
short: |
3-
Package a GGUF file into a Docker model OCI artifact, with optional licenses, and pushes it to the specified registry
3+
Package a GGUF file into a Docker model OCI artifact, with optional licenses. The package is sent to the model-runner, unless --push is specified
44
long: |
5-
Package a GGUF file into a Docker model OCI artifact, with optional licenses, and pushes it to the specified registry
6-
usage: docker model package --gguf <path> [--license <path>...] [--context-size <tokens>] --push TARGET
5+
Package a GGUF file into a Docker model OCI artifact, with optional licenses. The package is sent to the model-runner, unless --push is specified
6+
usage: docker model package --gguf <path> [--license <path>...] [--context-size <tokens>] [--push] [<tag>]
77
pname: docker model
88
plink: docker_model.yaml
99
options:
@@ -40,7 +40,8 @@ options:
4040
- option: push
4141
value_type: bool
4242
default_value: "false"
43-
description: push to registry (required)
43+
description: |
44+
push to registry (if not set, the model is loaded into the Model Runner content store.
4445
deprecated: false
4546
hidden: false
4647
experimental: false

‎docs/reference/model.md‎

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -5,24 +5,24 @@ Docker Model Runner (EXPERIMENTAL)
55

66
### Subcommands
77

8-
| Name | Description |
9-
|:------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------|
10-
| [`df`](model_df.md) | Show Docker Model Runner disk usage |
11-
| [`inspect`](model_inspect.md) | Display detailed information on one model |
12-
| [`install-runner`](model_install-runner.md) | Install Docker Model Runner (Docker Engine only) |
13-
| [`list`](model_list.md) | List the models pulled to your local environment |
14-
| [`logs`](model_logs.md) | Fetch the Docker Model Runner logs |
15-
| [`package`](model_package.md) | Package a GGUF file into a Docker model OCI artifact, with optional licenses, and pushes it to the specified registry |
16-
| [`ps`](model_ps.md) | List running models |
17-
| [`pull`](model_pull.md) | Pull a model from Docker Hub or HuggingFace to your local environment |
18-
| [`push`](model_push.md) | Push a model to Docker Hub |
19-
| [`rm`](model_rm.md) | Remove local models downloaded from Docker Hub |
20-
| [`run`](model_run.md) | Run a model and interact with it using a submitted prompt or chat mode |
21-
| [`status`](model_status.md) | Check if the Docker Model Runner is running |
22-
| [`tag`](model_tag.md) | Tag a model |
23-
| [`uninstall-runner`](model_uninstall-runner.md) | Uninstall Docker Model Runner |
24-
| [`unload`](model_unload.md) | Unload running models |
25-
| [`version`](model_version.md) | Show the Docker Model Runner version |
8+
| Name | Description |
9+
|:------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------|
10+
| [`df`](model_df.md) | Show Docker Model Runner disk usage |
11+
| [`inspect`](model_inspect.md) | Display detailed information on one model |
12+
| [`install-runner`](model_install-runner.md) | Install Docker Model Runner (Docker Engine only) |
13+
| [`list`](model_list.md) | List the models pulled to your local environment |
14+
| [`logs`](model_logs.md) | Fetch the Docker Model Runner logs |
15+
| [`package`](model_package.md) | Package a GGUF file into a Docker model OCI artifact, with optional licenses. The package is sent to the model-runner, unless --push is specified |
16+
| [`ps`](model_ps.md) | List running models |
17+
| [`pull`](model_pull.md) | Pull a model from Docker Hub or HuggingFace to your local environment |
18+
| [`push`](model_push.md) | Push a model to Docker Hub |
19+
| [`rm`](model_rm.md) | Remove local models downloaded from Docker Hub |
20+
| [`run`](model_run.md) | Run a model and interact with it using a submitted prompt or chat mode |
21+
| [`status`](model_status.md) | Check if the Docker Model Runner is running |
22+
| [`tag`](model_tag.md) | Tag a model |
23+
| [`uninstall-runner`](model_uninstall-runner.md) | Uninstall Docker Model Runner |
24+
| [`unload`](model_unload.md) | Unload running models |
25+
| [`version`](model_version.md) | Show the Docker Model Runner version |
2626

2727

2828

‎docs/reference/model_package.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
# docker model package
22

33
<!---MARKER_GEN_START-->
4-
Package a GGUF file into a Docker model OCI artifact, with optional licenses, and pushes it to the specified registry
4+
Package a GGUF file into a Docker model OCI artifact, with optional licenses. The package is sent to the model-runner, unless --push is specified
55

66
### Options
77

8-
| Name | Type | Default | Description |
9-
|:------------------|:--------------|:--------|:--------------------------------------|
10-
| `--context-size` | `uint64` | `0` | context size in tokens |
11-
| `--gguf` | `string` | | absolute path to gguf file (required) |
12-
| `-l`, `--license` | `stringArray` | | absolute path to a license file |
13-
| `--push` | `bool` | | push to registry (required) |
8+
| Name | Type | Default | Description |
9+
|:------------------|:--------------|:--------|:---------------------------------------------------------------------------------------|
10+
| `--context-size` | `uint64` | `0` | context size in tokens |
11+
| `--gguf` | `string` | | absolute path to gguf file (required) |
12+
| `-l`, `--license` | `stringArray` | | absolute path to a license file |
13+
| `--push` | `bool` | | push to registry (if not set, the model is loaded into the Model Runner content store. |
1414

1515

1616
<!---MARKER_GEN_END-->

‎go.mod‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ require (
1515
github.com/docker/docker v28.2.2+incompatible
1616
github.com/docker/go-connections v0.5.0
1717
github.com/docker/go-units v0.5.0
18-
github.com/docker/model-distribution v0.0.0-20250724025158-b173151a7474
18+
github.com/docker/model-distribution v0.0.0-20250724035854-a9454ee7284c
1919
github.com/docker/model-runner v0.0.0-20250724025946-0dfa50af179a
2020
github.com/google/go-containerregistry v0.20.6
2121
github.com/mattn/go-isatty v0.0.17

‎go.sum‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -78,8 +78,8 @@ github.com/docker/go-metrics v0.0.1/go.mod h1:cG1hvH2utMXtqgqqYE9plW6lDxS3/5ayHz
7878
github.com/docker/go-units v0.5.0 h1:69rxXcBk27SvSaaxTtLh/8llcHD8vYHT7WSdRZ/jvr4=
7979
github.com/docker/go-units v0.5.0/go.mod h1:fgPhTUdO+D/Jk86RDLlptpiXQzgHJF7gydDDbaIK4Dk=
8080
github.com/docker/libtrust v0.0.0-20160708172513-aabc10ec26b7/go.mod h1:cyGadeNEkKy96OOhEzfZl+yxihPEzKnqJwvfuSUqbZE=
81-
github.com/docker/model-distribution v0.0.0-20250724025158-b173151a7474 h1:F4MtfsvC/9/BMEjMQw8gku/hJ4xnXdMLnDE4z00Pcvw=
82-
github.com/docker/model-distribution v0.0.0-20250724025158-b173151a7474/go.mod h1:dThpO9JoG5Px3i+rTluAeZcqLGw8C0qepuEL4gL2o/c=
81+
github.com/docker/model-distribution v0.0.0-20250724035854-a9454ee7284c h1:hkMon8WnL995BHacRCEsbtPEO2mYsUmdsohJva15QDU=
82+
github.com/docker/model-distribution v0.0.0-20250724035854-a9454ee7284c/go.mod h1:dThpO9JoG5Px3i+rTluAeZcqLGw8C0qepuEL4gL2o/c=
8383
github.com/docker/model-runner v0.0.0-20250724025946-0dfa50af179a h1:hbXJ8P/v7Dk+yvqeGsBAyHxIq/mjjhW5UiIP8i3CONo=
8484
github.com/docker/model-runner v0.0.0-20250724025946-0dfa50af179a/go.mod h1:pmu0V0gxXVTzvjzkNm/jYDrIBccYTXBf8dL1zYm6sRQ=
8585
github.com/dvsekhvalnov/jose2go v0.0.0-20170216131308-f21a8cedbbae/go.mod h1:7BvyPhdbLxMXIYTFPLsyJRFMsKmOZnQmzh6Gb+uquuM=

‎vendor/github.com/docker/model-distribution/internal/store/manifests.go‎

Lines changed: 6 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎vendor/modules.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,7 @@ github.com/docker/go-connections/tlsconfig
144144
# github.com/docker/go-units v0.5.0
145145
## explicit
146146
github.com/docker/go-units
147-
# github.com/docker/model-distribution v0.0.0-20250724025158-b173151a7474
147+
# github.com/docker/model-distribution v0.0.0-20250724035854-a9454ee7284c
148148
## explicit; go 1.23.0
149149
github.com/docker/model-distribution/builder
150150
github.com/docker/model-distribution/distribution

0 commit comments

Comments
 (0)