Scroll to navigation

PULL-PKG(1) General Commands Manual PULL-PKG(1)


pull-pkg - download a package for Debian, Ubuntu, UCA, or a PPA


pull-pkg [options] <package name> [release|version]


pull-pkg downloads the specified version of <package name>, or the latest version from the specified release. To request a version from a particular pocket say release-pocket (with a magic -release for only the release pocket). If no pocket is specified, all pockets will be searched except -backports. If no version or release is specified, the latest version in the development release will be downloaded.

There are convenience scripts that set pull type and distribution appropriately: these are pull-lp-source, pull-lp-debs, pull-lp-ddebs, and pull-lp-udebs, which all pull Ubuntu packages; pull-debian-source, pull-debian-debs, pull-debian-ddebs, and pull-debian-udebs, which all pull Debian packages; pull-uca-source, pull-uca-debs, pull-uca-ddebs, and pull-uca-udebs, which all pull Ubuntu Cloud Archive packages; and pull-ppa-source, pull-ppa-debs, pull-ppa-ddebs, and pull-ppa-udebs, which all pull from a specified Personal Package Archive on Launchpad. Each script pulls the file type in its name, i.e. source, debs, ddebs, or udebs.


Listed below are the command line options for pull-pkg:

This is name of the package to downloaded. You can use either the source package name, or binary package name.
This is the version of the package to downloaded.
This is the release to downloaded from. For debian, you can use either the release name like jessie or sid, or you can use the special release names unstable, stable, or testing. For ubuntu, you can use either the release name like xenial or the release-pocket like xenial-proposed. For ubuntu cloud archive (uca) you can use either the uca release name like mitaka or the ubuntu and uca release names like trusty-mitaka. Defaults to the current development release.
Display a help message and exit.
Be verbose about what is being done.
Do not extract the source package (applies only to source packages).
Use the specified mirror server. Should be in the form or If not specified or if the package is not found on the specified mirror, this will fall back to the default mirror(s) and/or mirror(s) from environment variables, and then will fall back to Launchpad or Debian Snapshot. This can be specified multiple times to try multiple mirrors.
Do not use mirrors from the default configuration, or from any environment variables.
Get binary packages from the ARCH architecture. Defaults to the local architecture, if it can be deteected.
What to pull: source, debs, ddebs, udebs, or list. The list action only lists all a package's source and binary files, but does not actually download any. Defaults to source.
Pull from: debian, uca, ubuntu, or a ppa. lp can be used instead of ubuntu. Any string containing cloud can be used instead of uca. If pulling from a ppa, you must specify the PPA. Defaults to ubuntu.
Applies only when distro is ppa. Can be provided either as a value to the --ppa option parameter, or as a plain option (like release or version). When specified as a plain option, the form must be ppa:USER/NAME; when specified as a value to the --ppa option parameter, the leading ppa: is optional.


All of the CONFIGURATION VARIABLES below are also supported as environment variables. Variables in the environment take precedence to those in configuration files.


The following variables can be set in the environment or in ubuntu-dev-tools(5) configuration files. In each case, the script-specific variable takes precedence over the package-wide variable.

The default mirror.
The default mirror when using the pull-pkg script.
The default mirror when using the associated script.


dget(1), pull-lp-source(1), pull-lp-debs(1), pull-lp-ddebs(1), pull-lp-udebs(1), pull-debian-source(1), pull-debian-debs(1), pull-debian-ddebs(1), pull-debian-udebs(1), pull-ppa-source(1), pull-ppa-debs(1), pull-ppa-ddebs(1), pull-ppa-udebs(1), pull-uca-source(1), pull-uca-debs(1), pull-uca-ddebs(1), pull-uca-udebs(1), pull-debian-debdiff(1), ubuntu-dev-tools(5)


pull-pkg was written by Dan Streetman <>, based on the original pull-lp-source; it and this manual page were written by Iain Lane <>. All are released under the GNU General Public License, version 3 or later.

28 August 2017 ubuntu-dev-tools