﻿# octopus package upload

Upload one or more packages to Octopus Deploy. Glob patterns are supported. Delta compression is off by default.

```text
Usage:
  octopus package upload [flags]

Aliases:
  upload, push

Flags:
  -p, --package stringArray     Package to upload, may be specified multiple times. Any arguments without flags will be treated as packages
      --overwrite-mode string   Action when a package already exists. Valid values are 'fail', 'overwrite', 'ignore'. Default is 'fail'
      --continue-on-error       When uploading multiple packages, controls whether the CLI continues after a failed upload. Default is to abort
  -d, --use-delta-compression   Attempt to use delta compression when uploading. Off by default. As a recent addition to the CLI, it should be considered in beta.

Global Flags:
  -h, --help                   Show help for a command
      --no-prompt              Disable prompting in interactive mode
  -f, --output-format string   Specify the output format for a command ("json", "table", or "basic") (default "table")
  -s, --space string           Specify the space for operations

```

## Examples

:::div{.success}
**Octopus Samples instance**

Many of the examples we use, reference the [samples instance](https://samples.octopus.app/app#/users/sign-in) of Octopus Deploy. If you'd like to explore the samples instance, you can log in as a guest.
:::

```bash
octopus package upload --package SomePackage.1.0.0.zip
octopus package upload SomePackage.1.0.0.tar.gz --overwrite-mode overwrite
octopus package push SomePackage.1.0.0.zip
octopus package upload bin/**/*.zip --continue-on-error
octopus package upload PkgA.1.0.0.zip PkgB.2.0.0.tar.gz PkgC.1.0.0.nupkg
octopus package upload --package SomePackage.2.0.0.zip --use-delta-compression
octopus package upload SomePackage.2.0.0.zip --delta # alias for --use-delta-compression

```

## Learn more

- [Octopus CLI](/docs/octopus-rest-api/cli)
- [Creating API keys](/docs/octopus-rest-api/how-to-create-an-api-key)
