Copy page

unikraft

unikraft build

Build a Unikraft project into a container image.

Code
unikraft build [<input>] [flags]

Examples

Build the project in the current directory:

Code
unikraft build .

Build and publish an image from a Kraftfile:

Code
unikraft build . --output my-org/my-app:latest

Build with custom build arguments:

Code
unikraft build ./app --build-arg VERSION=1.2.3 --build-arg COMMIT=abc123

Build with secret and SSH access:

Code
unikraft build . --secret id=npm,src=$HOME/.npmrc --ssh default=$SSH_AUTH_SOCK

Build and save to a local OCI archive:

Code
unikraft build . --output ./dist/my-app.oci.tar

Options

Code
  --build-arg BUILD-ARG       Set build-time variables.
  --no-cache                  Do not use cache when building the image.
  -o, --output OUTPUT         Output destination
  --secret SECRET             Secret to expose to the build (format: "id=mysecret[,src=/local/secret]").
  --ssh SSH                   SSH agent socket or keys to expose to the build (format: "default|<id>[=<socket>|<key>[,<key>]]").

Options inherited from parent commands

Code
  --config file               Path to the configuration file.
  --log-level level           Set the logging level. (default info)
  --log-type type             Set the log type. (default text)
  --profile name              Set the current profile.
  --telemetry                 Toggle anonymous usage analytics. (default true)

See Also

• unikraft: The Unikraft Command-Line Interface.