Name

mpm — MiKTeX package manager

Synopsis

mpm [option...]

Description

MPM (MiKTeX Package Manager) is used to install packages from a MiKTeX package repository.

MPM starts in windowed mode, if you do not specify any command-line options.

Options

--admin

Run in administrative mode.

--find-updates

Check the package repository for updates, then print the list of updateable packages.

--help

Give help and exit.

--hhelp

This option is only available on Windows systems: show the manual page in an HTML Help window and exit when the window is closed.

--import=PACKAGE

Import the specified package from another MiKTeX installation. The root directory must be specified via --repository=DIR.

--import-all

Import all packages from another MiKTeX installation. The root directory must be specified via --repository=DIR.

--install=package

Install the specified package.

--install-some=file

Install packages listed (line-by-line) in the specified file.

--list

List the contents of the package database: for each package, print the installation status, the number of files, the size, and the name.

--list-package-names

List the package names.

--list-repositories

Download the list of known package repository URLs, then print the list.

--max-count=num

Stop after num packages.

--pick-repository-url

Pick up a suitable URL from the package repository list and print it.

--print-package-info=package

Print detailed information about the specified package.

--quiet

Suppress all output, except errors.

--repository=location

Use the specified location as the package repository. The location can be either a fully qualified path name (a local package repository) or an URL (a remote package repository). You can use the --list-repositories to retrieve a list of working package repository URLs.

--repository-release-state=state

Select the release state of the remote package repository. The release state is relevant for finding appropriate package repositories (--list-repositories, --pick-repository-url).

--reverse

Reverse the result of comparisons (when listing packages).

--set-repository=location

This option is only available on Windows systems: permanently register the location of the default package repository in the user area of the Windows Registry. The location can be either a fully qualified path name (a local package repository) or an URL (a remote package repository).

--trace[=tracestreams]

Enable trace messages. The tracestreams argument, if speciefied, is a comma-separated list of trace stream names (Chapter 9, Trace Streams).

--uninstall=package

Uninstall the specified package.

--update=[package]

Update the specified package, if an updated version is available in the package repository. Update all installed packages, if package is omitted.

--update-db

Synchronize the local package database with the package repository.

--update-some=file

Update packages listed (line-by-line) in the specified file.

--verify

Verify the integrity of all installed packages.

--verify=package

Verify the integrity of the specified package.

--verbose

Turn on verbose output mode.

--version

Show version information and exit.

Package Database

All package information is retrieved from the package database, which must have been properly installed by running MPM with the --update-db option.

Examples

Print the list of known package repository URLs:

C:\> mpm --list-repositories

Retrieve the package database files from the FTP server some.server:

C:\> mpm --repository=ftp://some.server/miktex/packages/ \
  --verbose --update-db

Print information about package a0poster:

C:\> mpm --print-package-info a0poster

Install package a0poster:

C:\> mpm --verbose --install a0poster

Update all installed packages:

C:\> mpm --verbose --update

Print the list of installed packages:

C:\> mpm --list | grep ^i

Environment

MIKTEX_REPOSITORY

Location of the package repository. This can be either a fully qualified path name (a local package repository) or an URL (a remote package repository).

http_proxy

The proxy server to be used for HTTP.

FTP_PROXY

The proxy server to be used for FTP.

ALL_PROXY

The proxy server to be used, if no protocol-specific proxy is set.

NO_PROXY

Comma-separated list of host names that should not go through any proxy.