vpk (Windows)
vpk -H
Description:
Velopack CLI 0.0.626, for distributing applications.
Usage:
vpk [command] [options]
Options:
-h, -H, --help, --vhelp Show help (-h) or extended help (-H).
-x, --legacyConsole Disable console colors and interactive
components.
-y, --yes 'yes' by instead of 'no' in non-interactive
prompts.
--verbose Print diagnostic messages.
--skip-updates Skip update checks
Commands:
pack Creates a release from a folder containing application files.
download Download's the latest release from a remote update source.
upload Upload local package(s) to a remote update source.
delta Utilities for creating or applying delta packages.
vpk pack -H
Description:
Creates a release from a folder containing application files.
Usage:
vpk pack [options]
Options:
-o, --outputDir <DIR> ENV=VPK_OUTPUT_DIR Output directory
for created packages. [default:
Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use
for this release. [default: win]
-r, --runtime <RID> ENV=VPK_RUNTIME The target runtime
to build packages for.
-u, --packId <ID> (REQ) ENV=VPK_PACK_ID Unique Id for
application bundle.
-v, --packVersion <VERSION> (REQ) ENV=VPK_PACK_VERSION Current version
for application bundle.
-p, --packDir <DIR> (REQ) ENV=VPK_PACK_DIR Directory
containing application files for
release.
--packAuthors <AUTHORS> ENV=VPK_PACK_AUTHORS Company name or
comma-delimited list of authors.
--packTitle <NAME> ENV=VPK_PACK_TITLE Display/friendly
name for application.
--releaseNotes <PATH> ENV=VPK_RELEASE_NOTES File with
markdown-formatted notes for this
version.
--delta <BestSize|BestSpeed|None> ENV=VPK_DELTA Disable or set the
delta generation mode. [default:
BestSpeed]
-i, --icon <PATH> ENV=VPK_ICON Path to icon file for
package.
-e, --mainExe <NAME> ENV=VPK_MAIN_EXE The file name (not
path) of the main/entry executable.
--exclude <REGEX> ENV=VPK_EXCLUDE A regex which
excludes matched files from the
package. [default: .*\.pdb]
--noPortable ENV=VPK_NO_PORTABLE Skip generating
a portable bundle.
--noInst ENV=VPK_NO_INST Skip generating an
installer package.
-f, --framework <RUNTIMES> ENV=VPK_FRAMEWORK List of required
runtimes to install during setup.
Example:
'net6-x64-desktop,vcredist143'.
-s, --splashImage <PATH> ENV=VPK_SPLASH_IMAGE Path to image
displayed during installation.
--skipVeloAppCheck ENV=VPK_SKIP_VELO_APP_CHECK Skip the
VelopackApp builder verification.
--signTemplate <COMMAND> ENV=VPK_SIGN_TEMPLATE Use a custom
signing command. {{file}} will be
substituted.
--signSkipDll ENV=VPK_SIGN_SKIP_DLL Only signs EXE
files, and skips signing DLL files.
--signParallel <NUM> ENV=VPK_SIGN_PARALLEL The number of
files to sign in each signing
command. [default: 10]
--shortcuts <LOC> ENV=VPK_SHORTCUTS List of locations
to install shortcuts to during setup.
[default: Desktop,StartMenuRoot]
-n, --signParams <PARAMS> ENV=VPK_SIGN_PARAMS Sign files via
signtool.exe using these parameters.
vpk download -H
Description:
Download's the latest release from a remote update source.
Usage:
vpk download [command] [options]
Commands:
github Download latest release from GitHub repository.
gitea Download latest release from Gitea repository.
s3 Download latest release from an S3 bucket.
az Download latest release from an Azure Blob Storage container.
local Download latest release from a local path or network share.
http Download latest release from a HTTP source.
vpk download github -H
Description:
Download latest release from GitHub repository.
Usage:
vpk download github [options]
Options:
-o, --outputDir <DIR> ENV=VPK_OUTPUT_DIR Output directory for created
packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for this
release. [default: win]
--repoUrl (REQ) ENV=VPK_REPO_URL Full url to the github
repository (eg.
'https://github.com/myname/myrepo').
--token ENV=VPK_TOKEN OAuth token to use as login
credentials.
--pre ENV=VPK_PRE Get latest pre-release instead of
stable.
vpk download gitea -H
Description:
Download latest release from Gitea repository.
Usage:
vpk download gitea [options]
Options:
-o, --outputDir <DIR> ENV=VPK_OUTPUT_DIR Output directory for created
packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for this
release. [default: win]
--repoUrl (REQ) ENV=VPK_REPO_URL Full url to the gitea
repository (eg.
'https://gitea.com/myname/myrepo').
--token ENV=VPK_TOKEN OAuth token to use as login
credentials.
--pre ENV=VPK_PRE Get latest pre-release instead of
stable.
vpk download s3 -H
Description:
Download latest release from an S3 bucket.
Usage:
vpk download s3 [options]
Options:
-o, --outputDir <DIR> ENV=VPK_OUTPUT_DIR Output directory for created
packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for this
release. [default: win]
--keyId <KEYID> ENV=VPK_KEY_ID Authentication identifier or
access key.
--secret <KEY> ENV=VPK_SECRET Authentication secret key.
--region <REGION> ENV=VPK_REGION AWS service region (eg.
us-west-1).
--session <TOKEN> ENV=VPK_SESSION Authentication session token.
--endpoint <URL> ENV=VPK_ENDPOINT Custom service url (backblaze,
digital ocean, etc).
--bucket <NAME> (REQ) ENV=VPK_BUCKET Name of the S3 bucket.
--prefix <PREFIX> ENV=VPK_PREFIX Prefix to the S3 url.
vpk download az -H
Description:
Download latest release from an Azure Blob Storage container.
Usage:
vpk download az [options]
Options:
-o, --outputDir <DIR> ENV=VPK_OUTPUT_DIR Output directory for
created packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for this
release. [default: win]
--account <ACCOUNT> (REQ) ENV=VPK_ACCOUNT Account name
--key <KEY> ENV=VPK_KEY Account secret key
--sas <TOKEN> ENV=VPK_SAS Shared access signature token
(not the url)
--container <NAME> (REQ) ENV=VPK_CONTAINER Azure container name
--endpoint <URL> ENV=VPK_ENDPOINT Service url (eg.
https://<account-name>.blob.core.windows.net)
vpk download local -H
Description:
Download latest release from a local path or network share.
Usage:
vpk download local [options]
Options:
-o, --outputDir <DIR> ENV=VPK_OUTPUT_DIR Output directory for created
packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for this
release. [default: win]
--path <PATH> (REQ) ENV=VPK_PATH Target file path to copy releases
to/from.
vpk download http -H
Description:
Download latest release from a HTTP source.
Usage:
vpk download http [options]
Options:
-o, --outputDir <DIR> ENV=VPK_OUTPUT_DIR Output directory for created
packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for this
release. [default: win]
--url (REQ) ENV=VPK_URL Url to download remote releases
from.
vpk upload -H
Description:
Upload local package(s) to a remote update source.
Usage:
vpk upload [command] [options]
Commands:
github Upload releases to a GitHub repository.
gitea Upload releases to a Gitea repository.
s3 Upload releases to a S3 bucket.
az Upload releases to an Azure Blob Storage container.
local Upload releases to a local path or network share.
vpk upload github -H
Description:
Upload releases to a GitHub repository.
Usage:
vpk upload github [options]
Options:
-o, --outputDir <DIR> (REQ) ENV=VPK_OUTPUT_DIR Output directory for
created packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for
this release. [default: win]
--repoUrl (REQ) ENV=VPK_REPO_URL Full url to the github
repository (eg.
'https://github.com/myname/myrepo').
--token ENV=VPK_TOKEN OAuth token to use as login
credentials.
--publish ENV=VPK_PUBLISH Create and publish instead
of leaving as draft.
--pre ENV=VPK_PRE Create as pre-release instead
of stable.
--merge ENV=VPK_MERGE Allow merging this upload
with an existing release.
--releaseName <NAME> ENV=VPK_RELEASE_NAME A custom name for the
release.
--tag <NAME> ENV=VPK_TAG A custom tag for the release.
--targetCommitish <NAME> ENV=VPK_TARGET_COMMITISH A commitish value
for tag (branch or commit SHA).
vpk upload gitea -H
Description:
Upload releases to a Gitea repository.
Usage:
vpk upload gitea [options]
Options:
-o, --outputDir <DIR> (REQ) ENV=VPK_OUTPUT_DIR Output directory for
created packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for
this release. [default: win]
--repoUrl (REQ) ENV=VPK_REPO_URL Full url to the gitea
repository (eg.
'https://gitea.com/myname/myrepo').
--token ENV=VPK_TOKEN OAuth token to use as login
credentials.
--publish ENV=VPK_PUBLISH Create and publish instead
of leaving as draft.
--pre ENV=VPK_PRE Create as pre-release instead
of stable.
--merge ENV=VPK_MERGE Allow merging this upload
with an existing release.
--releaseName <NAME> ENV=VPK_RELEASE_NAME A custom name for the
release.
--tag <NAME> ENV=VPK_TAG A custom tag for the release.
--targetCommitish <NAME> ENV=VPK_TARGET_COMMITISH A commitish value
for tag (branch or commit SHA).
vpk upload s3 -H
Description:
Upload releases to a S3 bucket.
Usage:
vpk upload s3 [options]
Options:
-o, --outputDir <DIR> (REQ) ENV=VPK_OUTPUT_DIR Output directory for
created packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for
this release. [default: win]
--keyId <KEYID> ENV=VPK_KEY_ID Authentication identifier
or access key.
--secret <KEY> ENV=VPK_SECRET Authentication secret key.
--region <REGION> ENV=VPK_REGION AWS service region (eg.
us-west-1).
--session <TOKEN> ENV=VPK_SESSION Authentication session
token.
--endpoint <URL> ENV=VPK_ENDPOINT Custom service url
(backblaze, digital ocean, etc).
--bucket <NAME> (REQ) ENV=VPK_BUCKET Name of the S3 bucket.
--prefix <PREFIX> ENV=VPK_PREFIX Prefix to the S3 url.
--keepMaxReleases <COUNT> ENV=VPK_KEEP_MAX_RELEASES The maximum
number of releases to keep in the bucket,
anything older will be deleted.
vpk upload az -H
Description:
Upload releases to an Azure Blob Storage container.
Usage:
vpk upload az [options]
Options:
-o, --outputDir <DIR> (REQ) ENV=VPK_OUTPUT_DIR Output directory for
created packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for
this release. [default: win]
--account <ACCOUNT> (REQ) ENV=VPK_ACCOUNT Account name
--key <KEY> ENV=VPK_KEY Account secret key
--sas <TOKEN> ENV=VPK_SAS Shared access signature token
(not the url)
--container <NAME> (REQ) ENV=VPK_CONTAINER Azure container name
--endpoint <URL> ENV=VPK_ENDPOINT Service url (eg.
https://<account-name>.blob.core.windows.ne
t)
--keepMaxReleases <COUNT> ENV=VPK_KEEP_MAX_RELEASES The maximum
number of releases to keep in the
container, anything older will be deleted.
vpk upload local -H
Description:
Upload releases to a local path or network share.
Usage:
vpk upload local [options]
Options:
-o, --outputDir <DIR> (REQ) ENV=VPK_OUTPUT_DIR Output directory for
created packages. [default: Releases]
-c, --channel <NAME> ENV=VPK_CHANNEL The channel to use for
this release. [default: win]
--path <PATH> (REQ) ENV=VPK_PATH Target file path to copy
releases to/from.
--keepMaxReleases <COUNT> ENV=VPK_KEEP_MAX_RELEASES The maximum
number of releases to keep in the target
directory, anything older will be deleted.
--regenerate ENV=VPK_REGENERATE Force regenerate the
releases.{channel}.json file in the target
directory.
vpk delta -H
Description:
Utilities for creating or applying delta packages.
Usage:
vpk delta [command] [options]
Commands:
generate Generate a delta patch from two full releases.
patch Patch a base package and retrieve the original new package.
vpk delta generate -H
Description:
Generate a delta patch from two full releases.
Usage:
vpk delta generate [options]
Options:
--mode <BestSize|BestSpeed|None> ENV=VPK_MODE Set the delta generation
mode. [default: BestSpeed]
-b, --base <PATH> (REQ) ENV=VPK_BASE The base package for the
created patch.
-n, --new <PATH> (REQ) ENV=VPK_NEW The resulting package for
the created patch.
-o, --output <PATH> (REQ) ENV=VPK_OUTPUT The output file path
for the created patch.
vpk delta patch -H
Description:
Patch a base package and retrieve the original new package.
Usage:
vpk delta patch [options]
Options:
-b, --base <PATH> (REQ) ENV=VPK_BASE The base package for the
created patch.
-p, --patch <PATH> ENV=VPK_PATCH The resulting package for the
created patch.
-o, --output <PATH> (REQ) ENV=VPK_OUTPUT The output file path for the
created patch.